AutoCAD • Organization and Layer Management

Match Properties

Transfer visual and organizational attributes between objects to enforce consistency across complex drawings.

A drafting compass with dimension and drawing-panel symbols.
Inside this lesson 10 sections 5 questions 6 figures

SECTION 1

Historical Context & Motivation

Before CAD systems introduced automated property transfer, drafters working with pen and ink had to meticulously replicate line weights, patterns, and colors by hand whenever they wanted visual consistency between drawing elements. This manual process was not only tedious but also error-prone: a single mismatched line type or color assignment could cascade into confusion during construction or fabrication. As computer-aided design matured through the 1980s and 1990s, software developers recognized that property inheritance — the ability to copy formatting attributes from one object and apply them to another — was essential to productive, standards-compliant drafting workflows.

Autodesk's response was the Match Properties command (MATCHPROP), introduced in AutoCAD Release 14. Conceptually analogous to the Format Painter in word processors or the CSS cascade in web development, Match Properties allows a user to designate a source object and then paint its properties onto one or more destination objects. The command has since evolved to cover an expanding set of properties, reflecting AutoCAD's growing complexity.

1982 • AutoCAD 1.0 Released

Autodesk launches AutoCAD with basic layer control. Object properties must be set manually or inherited from the current layer — no mechanism exists to copy properties between existing objects.

1997 • MATCHPROP Introduced (R14)

AutoCAD Release 14 debuts the MATCHPROP command, enabling one-click property transfer for color, layer, linetype, linetype scale, lineweight, and plot style.

2000 • Extended Property Support

AutoCAD 2000 expands MATCHPROP to include text style, dimension style, and hatch properties, broadening the command's utility beyond basic geometric objects.

2010 • Settings Dialog & Selective Matching

Modern releases refine the Settings dialog, allowing users to toggle individual property categories on or off — enabling selective matching. Transparency and material properties are added.

2023 • Web & Mobile Parity

AutoCAD Web and AutoCAD Mobile achieve near-parity with the desktop MATCHPROP implementation, reflecting the industry's shift toward cloud-based collaborative drafting.

Understanding Match Properties matters beyond mere convenience. In large-scale projects — infrastructure, architecture, or IC layout — maintaining property consistency is a data integrity concern. When hundreds of objects must share the same linetype or color-coded layer assignment, manual reassignment invites human error. Match Properties operationalizes a principle familiar to computer scientists: define once, replicate programmatically.

SECTION 2

Core Principles & Definitions

The Match Properties command rests on a conceptual model that separates an object's geometry (its shape, size, and position) from its properties (visual and organizational metadata such as color, layer, and linetype). This separation is analogous to the distinction between structure and presentation in HTML/CSS: changing a div's stylesheet class does not alter its DOM position or content. Similarly, MATCHPROP transfers presentation attributes without modifying an object's geometric definition.

1

Source Object

The object whose properties serve as the template. MATCHPROP reads its current property state — either explicit overrides or inherited ByLayer values — and constructs a property dictionary to apply to targets.
2

Destination Object(s)

One or more objects that receive the source's properties. Their geometry remains unchanged; only the selected property fields are overwritten. Multiple destinations can be painted in a single command invocation.
3

Property Categories

Properties are grouped into General (color, layer, linetype, lineweight, transparency, plot style) and Special (text style, dimension style, hatch pattern, viewport, table style, multileader style). Each category can be toggled independently.
4

Settings Filter

The Settings dialog (accessed by typing S during MATCHPROP) provides granular control over which properties transfer. This functions like a bitmask: each property is a flag that can be set or cleared before painting.
5

ByLayer vs. Explicit

If the source object's color is set to ByLayer, the destination inherits that ByLayer assignment — not the resolved color value. This preserves the indirection layer, which is critical for maintaining layer-based standards.
✦

KEY TAKEAWAY

Think of Match Properties as a shallow copy operation on an object's metadata dictionary. Just as a shallow copy in Python duplicates the top-level key-value pairs of a dictionary without cloning nested mutable objects, MATCHPROP copies property fields (color, layer, linetype) from source to destination without altering either object's geometric data. The Settings dialog acts as a key filter, letting you specify which keys to include in the copy.

SECTION 3

Visual Explanation

Match Properties WorkflowSOURCE OBJECTLinetype: DASHEDColor: Cyan (4)Layer: UTILITIESLineweight: 0.50mmDESTINATION (Before)Linetype: CONTINUOUSColor: Red (1)Layer: WALLSLineweight: 0.25mmDESTINATION (After)Linetype: DASHEDColor: Cyan (4)Layer: UTILITIESLineweight: 0.50mmMATCHPROP① Select source → ② Click destination(s) → ③ Geometry untouched, properties transferredSource propertiesOriginal destinationAfter match
The diagram illustrates the three-phase MATCHPROP workflow. The source object (left) provides its property dictionary. The destination before matching (center) shows the original, divergent properties. The destination after matching (right) confirms that all four property fields — linetype, color, layer, and lineweight — have been overwritten to match the source, while the line's geometry remains unchanged.

As shown in the diagram, Match Properties performs a targeted overwrite of an object's metadata without any side effects on its spatial definition. The source object's dashed linetype, cyan color index, UTILITIES layer assignment, and 0.50 mm lineweight are transferred wholesale to the destination. Notice that this operation is idempotent — applying MATCHPROP from the same source to the same destination a second time produces no additional changes, a property that computer scientists will recognize from functional programming and REST API design. This idempotency means you can safely re-apply the command without fear of compounding errors.

SECTION 4

How Match Properties Works Internally

Under the hood, AutoCAD represents every drawing entity as a record in its drawing database (DWG file format). Each entity record contains a header with general properties and entity-specific data. When MATCHPROP executes, the software performs a field-by-field copy from the source entity's header into the destination entity's header. Understanding this mechanism clarifies why some properties transfer universally while others are type-dependent.

Entity Property Model

Every AutoCAD entity can be modeled as a composite data structure. In pseudo-object-oriented terms, all entities inherit from a base class AcDbEntity that exposes general properties, while subclasses like AcDbLine, AcDbText, and AcDbHatch add type-specific fields. MATCHPROP operates at two levels: it always copies general properties from AcDbEntity, and it conditionally copies special properties when both source and destination share a compatible subclass.

PROPERTY TRANSFER MODEL

P(destination)←p∈P(source)∣p∈FilterMask∧compatible(type(source),type(destination),p)P(destination) ← { p ∈ P(source) | p ∈ FilterMask ∧ compatible(type(source), type(destination), p) }

Where P(obj) is the property set of an object, FilterMask is the set of properties enabled in the Settings dialog, and compatible() returns true when the destination's entity type supports the given property field.

Invocation Methods

MethodCommand / ActionNotes
Command LineMATCHPROP or alias MAMost common invocation. Type S during command to open Settings.
RibbonHome → Properties → Match Properties (paintbrush icon)Visual toolbar access. Same underlying command.
Right-Click MenuNot available by default; can be added via CUI customization.Useful for context-menu-heavy workflows.
AutoLISP / .NET API(command "MATCHPROP" source dest "")Scriptable via AutoLISP or C# ObjectARX. Enables batch property transfer.

Four invocation methods for MATCHPROP

💡

API Scripting Tip

For batch operations, consider wrapping MATCHPROP in an AutoLISP routine. Use (ssget) to build a selection set programmatically, iterate over entities with (ssname), and invoke (command "MATCHPROP" sourceObj ent "") per entity. This approach scales linearly with the number of destination objects, making it O(n) in time complexity for n targets.

SECTION 5

Property Categories & Settings Dialog

The MATCHPROP command divides transferable properties into two major groups: General Properties and Special Properties. General properties apply to virtually every entity type in the drawing database, whereas special properties are type-specific — they only transfer when source and destination share a compatible object class. Pressing S (for Settings) at the "Select destination object" prompt opens the Property Settings dialog, where each property is represented as a checkbox — effectively a bitmask governing which fields participate in the copy operation.

MATCHPROP Property CategoriesGENERAL PROPERTIES✓ColorACI / True Color✓LayerLayer name✓Linetypee.g., DASHED✓Linetype ScaleFloat ≥ 0✓Lineweightmm value✓Transparency0–90%✓Thickness3D extrusion✓Plot StyleNamed/ColorApplies to ALL entity typesSPECIAL PROPERTIES✓Text StyleAcDbText✓Dimension StyleAcDbDimension✓Hatch PatternAcDbHatch✓Polyline WidthAcDbPolyline✓ViewportAcDbViewport✓Table StyleAcDbTable✓Multileader StyleAcDbMLeader✓Material3D SolidsType-specific: requires compatible entitiesPress S during MATCHPROP to toggle checkboxes
The Property Settings dialog presents two columns of checkboxes. General properties (left) apply to every entity type. Special properties (right) only transfer when the destination entity supports the relevant subclass — for example, Text Style only applies when the destination is an AcDbText-derived object.

From a type-system perspective, the Settings dialog implements a form of runtime type checking. If you attempt to match a hatch pattern from a source AcDbHatch onto a destination AcDbLine, the hatch property field is silently skipped because the destination entity lacks the corresponding property slot. General properties, however, always transfer because they reside in the shared AcDbEntity base class that all entities inherit from. This behavior mirrors the Liskov Substitution Principle: any entity can be treated as an AcDbEntity and will always expose the general property interface.

SECTION 6

Worked Example

Consider a scenario in which you have received a floor plan drawing from a collaborator. The drawing contains 45 polylines representing plumbing runs, but they are scattered across three incorrect layers (MISC, TEMP, and 0) with inconsistent colors and linetypes. You need all 45 polylines on layer PLUMBING with color ByLayer (which resolves to green, ACI 3), linetype HIDDEN, and lineweight 0.35 mm. One correctly formatted polyline already exists on the PLUMBING layer.

Standardizing 45 Plumbing Polylines with MATCHPROP

  1. 1

    Step 1 — Verify the Source Object

    Select the correctly formatted polyline and open the Properties palette (Ctrl+1). Confirm that its properties match the target specification: Layer = PLUMBING, Color = ByLayer, Linetype = HIDDEN, Lineweight = 0.35 mm. This verification step prevents propagating incorrect properties.
    Source confirmed: PLUMBING / ByLayer / HIDDEN / 0.35 mm
  2. 2

    Step 2 — Launch MATCHPROP and Configure Settings

    Type MA and press Enter. At the "Select source object" prompt, click the verified polyline. Before selecting destinations, type S to open Settings. In the dialog, ensure Color, Layer, Linetype, and Lineweight are checked. Uncheck properties you do not want to transfer (e.g., Linetype Scale if the source uses a non-default scale you want to preserve individually on each target).
    FilterMask = {Color, Layer, Linetype, Lineweight}
  3. 3

    Step 3 — Select Destination Objects

    Close the Settings dialog by clicking OK. Now click each of the 45 destination polylines. For efficiency, use a crossing window (C option) to select all polylines in a region, or use a selection filter (Quick Select) to pre-filter for polylines on layers MISC, TEMP, and 0. Each clicked object instantly receives the source properties.
    45 polylines selected and properties applied
  4. 4

    Step 4 — Press Enter to End Command

    Press Enter or Escape to terminate MATCHPROP. The command remains active until explicitly ended, allowing continuous painting — a design choice analogous to a modal editing state in Vim.
    Command terminated. All 45 polylines now on PLUMBING layer.
  5. 5

    Step 5 — Validate Results

    Run QSELECT to select all objects on layer PLUMBING. Verify the count includes the original polyline plus the 45 updated ones (46 total). Alternatively, freeze all layers except PLUMBING and visually inspect the drawing. This post-condition check is analogous to writing assertions after a batch database update.
    46 polylines confirmed on PLUMBING layer — operation successful

SECTION 7

Match Properties vs. Alternative Approaches

MATCHPROP is not the only mechanism for changing object properties in AutoCAD. Depending on the scope, volume, and specificity of the change, other tools may be more appropriate. The following comparison evaluates MATCHPROP against four alternatives: manual property editing, Quick Properties, Layer Walk, and AutoLISP scripting.

MethodStrengthsLimitationsBest For
MATCHPROPFast, intuitive, copies multiple properties in one operation, no coding requiredRequires a correctly formatted source object to exist; less efficient for thousands of objects without scriptingAd-hoc corrections of 1–100 objects where a template object exists
Properties PaletteFull control over every field; works on multi-object selections; exposes read-only infoMust manually type or select each property value; no "copy from reference" capabilitySetting specific values when no template object is available
Quick PropertiesLightweight floating panel; auto-appears on selection; fast for single-field editsShows limited fields; no batch-copy functionalityQuick single-property adjustments during drawing
AutoLISP ScriptFully programmable; can apply conditional logic; scales to millions of objectsRequires programming skill; debugging is cumbersome; harder to share across teamLarge-scale batch processing, conditional property assignment, automation
Layer Walk / LAYMCHSpecifically designed for layer reassignment; LAYMCH matches layer onlyOnly changes the layer property; does not affect color, linetype, lineweight, etc.Pure layer-reassignment tasks with no other property changes needed

Comparison of property-editing methods in AutoCAD

✦

KEY TAKEAWAY

MATCHPROP occupies a sweet spot in the trade-off between manual effort and scripting overhead — much like using a shell alias versus writing a full Bash script. For small to medium batches where a template object already exists, MATCHPROP is the most efficient tool. When the object count enters the thousands or when conditional logic is needed (e.g., only change color if the object is on a specific layer), graduate to AutoLISP or .NET scripting.

SECTION 8

Connection to Advanced CAD Standards & Automation

While MATCHPROP addresses immediate, interactive property transfer, professional CAD environments rely on broader systems to enforce drawing standards at scale. Understanding where MATCHPROP fits within this ecosystem helps you appreciate both its utility and its limitations. Two advanced systems are particularly relevant: CAD Standards Checking (STANDARDS command) and Drawing Template (DWT) inheritance. These operate at the drawing level rather than the object level, providing preventive rather than corrective enforcement.

AspectMATCHPROPCAD Standards (DWS)
ScopeObject-level: copies properties from one entity to anotherDrawing-level: audits layer names, linetypes, dim styles, text styles against a DWS reference file
TimingCorrective — applied after non-conformance is discoveredPreventive and corrective — can flag violations during periodic audits
AutomationManual (or scriptable via LISP/.NET)Batch audit with CHECKSTANDARDS; auto-fix capabilities
Analogy (CS)Like a deep copy utility or property-spreading operatorLike a CI/CD linter enforcing code style rules against a config file
GranularityFine-grained: per-object, per-property controlCoarse-grained: per-standard-category (layers, text styles, etc.)

MATCHPROP vs. CAD Standards Checking

In practice, MATCHPROP and CAD Standards Checking are complementary tools. A robust workflow might begin with a well-configured DWT template that predefines standard layers, linetypes, and text styles, then use MATCHPROP for ad-hoc corrections during active drafting, and finally run a CHECKSTANDARDS audit before deliverables are issued. This layered approach is analogous to using both an IDE auto-formatter (reactive, local) and a CI linting step (batch, global) in a software engineering pipeline.

ℹ

Looking Ahead: BIM and IFC

As the AEC industry migrates toward Building Information Modeling (BIM) and open standards like IFC (Industry Foundation Classes), property management becomes even more critical. In Revit and similar BIM tools, the concept of property matching extends to parametric families and shared parameters. AutoCAD's MATCHPROP remains relevant in BIM-adjacent workflows — particularly for 2D detail sheets and annotation cleanup — but understanding its scope helps you recognize when to leverage more powerful, model-aware property propagation tools.

SECTION 9

Practice Problems

Question 1: CONCEPTUAL

A source object has its color set to ByLayer, and its layer (ELECTRICAL) is configured with a red color. If you MATCHPROP this source onto a destination object currently on layer WALLS (which has a blue color), what color will the destination display after the operation? Explain your reasoning.
Show answer
The destination will display blue. MATCHPROP transfers the ByLayer color assignment and the layer name ELECTRICAL from the source. Wait — actually, the destination is moved to the ELECTRICAL layer (because Layer is a general property that transfers), and since the destination's color is now ByLayer, it resolves to the ELECTRICAL layer's color, which is red. The destination will therefore display red. The key insight is that MATCHPROP copies both the explicit 'ByLayer' color assignment and the layer name, so the destination inherits the source's layer and then resolves its color from that new layer's definition.

Question 2: BASIC CALCULATION

You have a drawing with 120 objects that need property correction. Using the Properties palette, each object takes approximately 15 seconds to update manually (selecting, changing 4 fields, pressing Enter). Using MATCHPROP with a crossing-window selection, you can process all 120 objects in approximately 25 seconds (command launch + source selection + window select + Enter). Calculate the time savings as a percentage.
Show answer
Manual approach: 120 objects × 15 seconds = 1,800 seconds (30 minutes). MATCHPROP approach: approximately 25 seconds. Time saved = 1,800 − 25 = 1,775 seconds. Percentage savings = (1,775 ÷ 1,800) × 100 ≈ 98.6%. This dramatic efficiency gain illustrates why MATCHPROP is indispensable in production environments. Even with more conservative estimates (e.g., selecting objects individually rather than via crossing window), the O(1) property-copy operation versus O(n) manual editing makes MATCHPROP the clear choice for batch corrections.

Question 3: INTERMEDIATE

You want to use MATCHPROP to transfer only the linetype and lineweight from a source line to 30 destination circles, but you do NOT want to change their layer or color assignments. Describe the exact sequence of actions, including which Settings checkboxes to modify.
Show answer
Type MA and press Enter. Select the source line. At the 'Select destination object' prompt, type S to open the Settings dialog. In the General Properties section, uncheck Color, Layer, Linetype Scale, Transparency, Thickness, and Plot Style. Leave only Linetype and Lineweight checked. Click OK. Then select the 30 circles (using a crossing window or individual clicks). Press Enter to end the command. The circles will adopt the source's linetype and lineweight while retaining their original layer and color assignments. Note that the Settings dialog state persists across MATCHPROP invocations within the same session, so remember to restore default settings afterward.

Question 4: APPLIED

You are managing an AutoCAD drawing for a campus site plan. A new standard requires all parking-lot striping polylines (currently on layer PARKING with color yellow and linetype CONTINUOUS) to be moved to layer SITE-STRIPING with color white and linetype DASHDOT. No polyline on the correct layer exists yet. Explain how you would create a source object and use MATCHPROP to update all striping polylines efficiently.
Show answer
First, create the target layer SITE-STRIPING using the Layer Properties Manager (LAYER command): set its color to white (7) and its default linetype to DASHDOT. Next, draw a temporary polyline anywhere in the drawing and assign it to layer SITE-STRIPING with color set to ByLayer and linetype set to ByLayer (ensuring it inherits the layer's definitions). This temporary polyline serves as your source object. Launch MATCHPROP (MA), select the temporary polyline as the source, verify Settings include Color, Layer, and Linetype, then use QSELECT or a selection filter to select all polylines on layer PARKING. Click them as destinations. Once complete, verify with QSELECT that all former PARKING polylines are now on SITE-STRIPING. Finally, delete the temporary source polyline and purge the unused PARKING layer if appropriate.

Question 5: CRITICAL THINKING

A colleague argues that MATCHPROP is redundant because the same result can always be achieved by selecting multiple objects, opening the Properties palette, and changing the Layer drop-down. Construct a counterargument identifying at least three scenarios where MATCHPROP provides capabilities that the Properties palette cannot replicate efficiently or at all.
Show answer
Three scenarios where MATCHPROP is distinctly superior: (1) Multi-property transfer in one operation — the Properties palette requires changing each field individually (layer, then color, then linetype, then lineweight), while MATCHPROP copies all simultaneously from a visual reference. This reduces cognitive load and error probability. (2) Special property matching — for object types like hatches, MATCHPROP can transfer hatch pattern, scale, and angle in one step. Replicating this via the Properties palette requires navigating pattern selection dialogs and manually entering scale/angle values, which is error-prone. (3) Visual reference workflow — when you need to match a destination to an existing exemplar but do not know the exact property values (e.g., which ACI color index or custom linetype name), MATCHPROP lets you point-click without ever reading or transcribing values. The Properties palette requires you to know or look up the exact values, introducing an extra query step. Additionally, MATCHPROP's persistent painting mode allows rapid sequential application to multiple objects without re-invoking the command.

SUMMARY

Summary

Summary

The Match Properties command (MATCHPROP / MA) enables efficient, point-and-click transfer of visual and organizational properties from a source object to one or more destination objects. Properties are categorized into General (color, layer, linetype, lineweight, transparency, plot style) and Special (text style, dimension style, hatch pattern, and others). The Settings dialog (accessed by pressing S during the command) acts as a bitmask filter, allowing selective property transfer.

The command preserves object geometry, transfers ByLayer indirection rather than resolved values, and applies runtime type checking to skip incompatible special properties silently. MATCHPROP is most effective for ad-hoc corrections on small to medium object counts; for large-scale batch operations, AutoLISP or .NET scripting offers superior scalability, while CAD Standards Checking (DWS) provides preventive, drawing-level enforcement. Together, these tools form a layered property management strategy analogous to combining local linters with CI/CD pipelines in software engineering.

Varsity Tutors • AutoCAD • Match Properties