AUTOCAD • ORGANIZATION AND LAYER MANAGEMENT

Match Properties

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

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.

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.

Visual Explanation

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.

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) }
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

Four invocation methods for MATCHPROP
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.
💡 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.

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.

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.

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
Step 1 — Verify the Source ObjectSelect 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
Step 2 — Launch MATCHPROP and Configure SettingsType 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
Step 3 — Select Destination ObjectsClose 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
Step 4 — Press Enter to End CommandPress 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
Step 5 — Validate ResultsRun 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

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.

Comparison of property-editing methods in AutoCAD
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
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.

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.

MATCHPROP vs. CAD Standards Checking
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.)

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.

Practice Problems

PROBLEM 1CONCEPTUAL
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.
PROBLEM 2BASIC 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.
PROBLEM 3INTERMEDIATE
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.
PROBLEM 4APPLIED
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.
PROBLEM 5CRITICAL 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.

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