Only available for

Onshape allows you to release configured parts and treats each configuration as a unique revisionable object.

To release a configuration directly, set the desired configuration inputs in the Part Studio or assembly, then right-click the configured part or instance and select Release. The currently active configured part is displayed by default in the Create Release candidate dialog.

You can release only that configuration or add additional configured parts by clicking the Plus sign icon icon at the top of the dialog to open the Add Items to Release dialog:

Add Items to Release dialog

This dialog works the same as the Insert parts and assemblies dialog:

  1. Select and modify the desired configuration inputs to create a configured part.
    • Click the Set to last viewed configuration dropdown (Configurations icon) to select the last active configuration in the source element, or select Reset to default to set all inputs to their default values.
  2. Click Generate to build the configured part or assembly.
  3. Click on the newly-generated part to add it to the Release candidate. You can generate and include multiple configurations of each part in a single Release.
  4. Click Add to finish the workflow and return to the Create Release candidate dialog.

To remove undesired objects from the Release candidate, click the red X next to the object.

When you release a configuration (or multiple configurations) of a part, only those specific, released configurations will be available for reuse from the Released version. Other configurations of that part will need to be released separately. Similarly, when you insert a released version of a configured part, you are inserting a specific, released object and will not be permitted to change configuration inputs.

Excluded configurations are treated as having their default values. Release packages and revision references use those defaults. If visibility conditions prevent using the default value, the first visible value is used.

Assemblies containing configured parts

Releasing an Assembly that contains configured parts releases only the specific configurations of each part referenced by the Assembly. No additional configurations are released unless you add them as described above.