Edit Project Variant

Parent page: WorkspaceManager Dialogs

The Edit Project Variant dialog


This dialog provides controls required when initially adding a new variant for the design, or editing/cloning an existing one. It allows the variant to be given a meaningful name, as well as the ability to specify variant-level parametric data.


The dialog is accessed from the Variant Management dialog in the following ways:

  • When adding a new variant for the design, click the Add Variant button.
  • When editing an existing variant for the design. With the required variant made active, click the Edit Variant button.
  • When cloning an existing variant. With the required variant to be cloned made active, click the drop-down arrow at the right side of the Add Variant button, then choose the Clone Selected Variant command from the menu.
To make a variant active, either click on the variant's name in the column header or click in any of the variant's cells.


  • Description - use this field to give the variant a meaningful name. A meaningful name can aid in distinguishing between multiple defined variants and also provide some indication as to the purpose of the variant.
  • Allow variation of fabrication outputs - enable this option to allow the variant to drive fabrication outputs for your design. Essentially, this feature allows you to vary the comment for a component in your design, and feed this change through to the following fabricated outputs:
    • Gerber files
    • ODB++ files
    • Composite Drill Drawings
    • Drill Drawing/Guides
    • Final Artwork Prints

More specifically, this concerns the silkscreen layer – the layer upon which the component comment will appear.

Although it is fabrication output that is being changed, it is only changing the silkscreen output based on a variation in the component's Comment parameter. You cannot change any other aspect of the fabricated board, such as the routing, the layout of the components, or the layer stack.
  • Parameters - this region lists all of the parameters currently defined for the variant in terms of:
    • Name - the name of the parameter.
    • Value - the value of the parameter.
Standard multi-selection techniques are supported (Ctrl+click, Shift+click, click&drag).
Sorting by either column can be performed by clicking on that column's header - once to sort ascending, and again to sort descending.
  • Add - click this button to add a new parameter to the list. The Parameter Properties dialog will open. Use the dialog to define the parameter in terms of its Name and Value.
  • Remove - click this button to delete the currently selected parameter(s) from the list.
  • Edit - click this button to open the Parameter Properties dialog to modify the currently selected parameter.
A parameter can be edited directly in the grid; click once on a field to focus it then enter the new name/value as required.
The grid's right-click context menu provides Add, Remove and Edit commands, as well as commands for copying and pasting parameter entries.

Working with Variant Parameters

CircuitStudio supports parameters at various levels of the project. For example, you can add document-level parameters to each schematic sheet in the Document Options dialog. You can also add project-level parameters to the project on the Parameters tab of the Options for Project dialog. Parameters can also be added to a variant in the Edit Project Variant dialog.

Parameters have a hierarchy, which means you can create a parameter with the same name at different levels of the project, each having different values. CircuitStudio resolves this in the following way:

  1. Variant (highest priority)
  2. Schematic document
  3. Project

That means the parameter value defined in the schematic document overrides the value defined in the project options, and the value defined in the variant overrides the value defined in the schematic document. Note that schematic-level parameters are not available on the PCB or in the Bill of Materials; for these types of outputs, use project or variant parameters.


You are reporting an issue with the following selected text and/or image within the active document: