Component Name Template

Now reading version 20.0. For the latest, read: Component Name Template for version 21

The Component Name Template dialog
The Component Name Template dialog


The Component Editor (in its Batch Component Editing mode only) provides support for the use of parameter-based Component Name Templates. Such templates allow you to precisely name, or rather rename your components - their Item ID - based on the currently defined values of parameters (user/template parameters - not system parameters) available to those components in the editor. Use the Component Name Template dialog to define your naming template as required.


Access to the dialog is made from within the Component Editor, when operating in its Batch Component Editing mode. Select the component(s) to be renamed (in the area for component definitions at the bottom of the view), right-click, and choose the Operations » Rename Component (Operations » Rename n Components) command from the context menu.

A managed component is defined/edited using the Component Editor, which can operate in two modes - Single Component Editing and Batch Component Editing. The latter provides the interface for defining/editing multiple components, but can be used to define/edit a single component, should you wish. With the Component Editor in its Single Component Editing mode, access to batch editing mode is made by choosing the Tools » Switch to Batch Editor command, from the Editor's main menus.


  • Initial Index - use this field to specify the starting index for the components that are being renamed using the defined naming scheme, and where an iterator macro has been added to the template.
Note that the dialog will initially show the default naming scheme entered into the Component Editor's Document Options dialog. If you leave this scheme, you will not be able to change the Initial Index. The latter can only be changed if a different naming scheme is used.
  • Naming Scheme - use this field to define your naming scheme. Include a parameter into the naming template using the format [<ParameterName>]. Examples might be:
    • CMP-[Value]
    • CMP-[Part Number]
    • [Part Number]-[Value]
    • [Value]
    • [Part Number]
    • You can also use multiple parametric declarations in your templates, for example:

    • CMP-[Part Number]-[Value]
    • CMP-[Manufacturer Part Number]-[Value]-[Tolerance]

In addition, and purely optional, you can also add an iterator macro, specified within curly braces (e.g., {000}, {00A}), for example:

  • CMP-[Value]-{001}
  • CMP-[Part Number]-{00A}

You can then control the starting point of that iterator by defining the required value in the Initial Index field.

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.