Smart Edit (SCH)

This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.


The Smart Edit dialog
The Smart Edit dialog


The Smart Edit dialog offers two different methods for performing powerful and complex string modifications.


From the SCH List or the SCHLIB List panel, select the string-type cell entries you want to modify for the required objects, right-click then select Smart Edit from the context menu.

The panel must be in Edit mode to access the Smart Edit command.


Batch Replace Tab

This tab is used for string substitutions. Click inside the From field and enter the portion of the current string that you want to replace. Then click inside the To field and enter the string to be used as the replacement. The standard string substitution syntax is displayed at the bottom.

For example, a design has a large number of net labels in the form:

GeneralPurpose_IO1, GeneralPurpose_IO2, and so on.

To change these to:

User_IO1, User_IO2, and so on,

enter the existing section of string to be replaced in the From field and the replacement section of string in the To field. Note that the string substitution that is about to be performed is displayed at the bottom of the tab.

The change is only applied to the characters entered into the From field. Any other characters in each targeted string, such as an incrementing numerical identifier, is not changed.

Formula Tab

This tab provides for more advanced modification, allowing you to apply a specific expression to the selected string objects. The expression can include any built-in arithmetic operators and functions that apply to strings (found in Pascal). If you want to use the current value for the attribute as part of the expression, you will need to make reference to this original value, either by using the full name of the attribute or by using the exclamation character (the supported substitute for the name of the attribute currently being modified). When using attribute names, if any names contain spaces, these must be replaced by the underscore character. For example, use of the Component Designator field within a formula should be entered as Component_Designator.

Consider, for example, three selected memory components specified in a design with designators U1, U3 and U5. You might want to extend the designators of these components by including some indication of their role. After loading the required components (or designators) into the appropriate List panel, open the Smart Edit dialog using the techniques described in the Access section above.

In the Formula tab, you could write an expression to add to the existing string value of the Name attribute. This would take the existing (original) string value and concatenate it with a specified new string, as illustrated below:

Name + '_MEM'

or, in shortened form:

! + '_MEM'

Note that the spaces are optional. After clicking OK, the designators of the components will be updated to U1_MEM, U3_MEM and U5_MEM, respectively.

Expressions entered in the Formula tab of the Smart Edit dialog are saved so they can easily be used again in the future. To re-use previously entered expressions, click the  button at the right end of the text field then select an expression from the drop-down menu.

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