SOLIDWORKS Assemblies Document

FEATURE AVAILABLE IN: SOLIDWORKS 3D, SOLIDWORKS PDM

How to Export SOLIDWORKS Assembly Document Using PDMPublisher

This article provides a step-by-step walkthrough for exporting a SOLIDWORKS assemblies document using PDMPublisher, covering the entire process from setup and final output.

SOLIDWORKS Assemblies Document and Screenshot of SOLIDWORKS 2025 showing an assembly modelling environment with a cut-away view of a grey gas cylinder (or pressure vessel) featuring internal components and a red-highlighted valve at the top. The FeatureManager tree on the left lists the assembly “Tank_Re” with standard planes, origin, and mates.
On the right, the PDMPublisher (SOLIDWORKS) add-in pane is open on the “Output” tab. A blue banner at the top announces “A new version is out. Click here to download it”. The export settings show:

Export Location set to “C:\speaker_project” (evaluated as “C:\speaker_project”)
Filename template: “File name without extension” + “Revision” (evaluated example: “speakerPublished”)
File format set to “step”
Checkbox “Open Export Location On Completion” is checked
“Export sheet metal parts to 1:1 flat pattern DXF” is checked
“PDF” is also checked
Other options such as exporting references individually and ignoring sub-assemblies when condition checks fail are unchecked

A large “PUBLISH” button is visible at the bottom. The interface demonstrates configuring the PDMPublisher add-in to automatically export the assembly as STEP and PDF files (and flat-pattern DXFs for any sheet metal parts) to a specific folder upon publishing.

1. Enable the PDMPublisher Add-In

Screenshot of the SOLIDWORKS “Add-Ins” dialog box showing the list of currently loaded add-ins. The window has three sections: “SOLIDWORKS Professional Add-ins” (empty), “SOLIDWORKS Add-ins” (empty), and “Other Add-ins”. Under “Other Add-ins”, the only entry is “PDMPublisher (SOLIDWORKS)”, which is checked (enabled) at both Start Up and during the current session. The row is highlighted with a red border and a blue checkmark in the rightmost column. Buttons at the bottom are “OK” (highlighted in blue) and “Cancel”. This dialog confirms that the third-party PDMPublisher add-in is active and set to load automatically every time SOLIDWORKS starts.

Before using PDMPublisher, ensure the add-in is enabled inside SOLIDWORKS.

  1. Go to Tools → Add-Ins.
    1. Scroll down to the Other Add-Ins section.
    2. Locate PDMPublisher (SOLIDWORKS) and check both boxes:
    3. The left box enables it for the current session.
    4. The right box ensures it loads automatically at startup.
  2. This guarantees that PDMPublisher will always be available when you launch SOLIDWORKS.

2. Set the Export Location

Screenshot of the PDMPublisher (SOLIDWORKS) add-in pane open on the Output tab. A blue banner at the top announces “A new version is out. Click here to download it”.
Key settings shown:

Export Location is set to “C:\PDMPublisher”
Filename template is currently “File name without extension” + “Revision” (shown with red X marks on both segments, indicating the template is incomplete or invalid)
File format is set to “pdf”
Checked options include: “Open Export Location On Completion”, “Export references to file formats individually”, “PDF”, “Merge exported PDFs into one master PDF”, and “Add table of content to merged PDF”
Table columns for the PDF are set to “Name & Quantity”

A dropdown menu is open on the right showing available variables for the filename template (e.g., Configuration name, Date, Target Extension, Top Assembly Name, BOM Quantity, etc.). The interface is being used to configure automatic PDF publishing with merged output and table of contents, but the filename template needs to be corrected before publishing can proceed successfully.

With the add-in loaded, switch to the PDMPublisher tab in the SOLIDWORKS Task Pane. The first step is to specify where the exported files will be stored.

In the Output section, define the Export Location. This can be a fixed directory such as C:\PDMpublisher, or any custom folder on your local or network drive. Use the Browse button to navigate to a location, or type the path directly.

3. Customize the Output Filename (Optional)

Screenshot of the PDMPublisher (SOLIDWORKS) add-in pane on the Output tab. A blue banner at the top reads “A new version is out. Click here to download it”.
The Export Location is set to “C:\PDMPublisher” (evaluated value also shown as C:\PDMPublisher).
In the Filename section, the current template is “File name without extension” + “Revision” (both parts are marked with red X icons indicating an invalid or incomplete template). An open dropdown menu on the right lists available variables such as File name without extension, File name, Configuration name, Date, Target Extension, Extension, File Folder, Top Assembly Folder, Top Assembly Name, BOM Quantity, SOLIDWORKS PDM Professional, and SOLIDWORKS File Properties.
File Formats is set to “pdf”. Checked options include:

Open Export Location On Completion
Export references to file formats individually
PDF
Merge exported PDFs into one master PDF
Add table of content to merged PDF

Table columns are set to “Name & Quantity”.
The interface shows the user in the process of fixing an invalid filename template for automatic PDF publishing with merged output and a table of contents.

PDMPublisher allows dynamic file naming using built-in variables. This feature is especially useful when you want to include metadata such as revision numbers, configuration names, or custom properties in the file name automatically.

Click inside the Filename field and use the dropdown button  >... to insert elements such as:

  • File name without extension
  • Revision
  • Configuration name
  • Target extension
  • SOLIDWORKS File Properties
  • BOM quantity

For example, a template combining “File name without extension” and “Revision” will produce a result like membraneA-01.step.

Remark on Missing Variables

Screenshot of a small section of a configuration dialog (PDMPublisher add-in) showing the "Filename" field. The current template is displayed as two highlighted segments: "File name without extension" (in blue) followed by "Revision" (in blue), both marked with a red X icon indicating the combination is invalid or incomplete. Below, the evaluated value preview reads "[FileNameWithoutExtension][Revision]". A dropdown arrow on the right is visible, ready to select alternative variables. This highlights an incorrect filename template that needs to be fixed before publishing can proceed.

If a variable cannot be resolved in either the configuration-specific tab or the Custom tab, the pill turns red. This visual cue indicates that PDMPublisher will not be able to substitute a value for that variable at publish time. This behavior applies both in the Filename field and the Export Location field. It’s a simple but effective way to catch misnamed or undefined variables before publishing.

Remark on the >... Button

To the right of the Filename (or Export Location) field, there is a >... button. Clicking this opens a menu of special filename variables that can be inserted at any point in the naming pattern. These include:

  • File name without extension
  • Revision
  • BOM Quantity
  • Configuration name
  • Extension
  • Various SOLIDWORKS and PDM-specific properties

This feature allows users to build rich, metadata-driven file naming conventions that are automatically evaluated at publish time. It ensures consistent, traceable filenames across exported deliverables without requiring any manual editing.

Variable Pills and Evaluation Order

When you insert variables, they appear as “pills” inside the filename editor. Each pill represents a specific property or variable that will be evaluated when the file is published. PDMPublisher evaluates these pills from left to right, building the filename string dynamically in the exact order you define.

For example, if your filename template is:

[File name without extension] - [Revision] - [BOM Quantity]

The final exported file might be:

GrillAssembly-A01-5.step

depending on the document’s metadata.

Configuration-Specific Resolution

When PDMPublisher evaluates a variable pill, it first looks for a configuration-specific value. This is especially relevant for SOLIDWORKS file properties such as DescriptionPart Number, or Revision, which can differ between configurations. If the property exists at the configuration level, that value is used.

If the property is not found at the configuration level, PDMPublisher automatically falls back to the Custom tab value for that property. This behavior ensures consistent results even if some properties are defined globally rather than per configuration.

4. Select the File Formats

Next, choose the output format. In the File Formats field, open the dropdown list and select step for example. You may also select other formats simultaneously (such as PDF or DXF), but for this example, only STEP is required.

This tells PDMPublisher to generate a .step file during the publishing operation.

5. Checked Export References To File Format Individually

Screenshot of a small section of the PDMPublisher (SOLIDWORKS) add-in Output settings. The “File Formats” dropdown is set to “step”. Below it, the “Export” collapsible section is expanded (arrow pointing down). The first checkbox inside is checked and labelled “Export references to file formats individually” (highlighted with a red border). The second checkbox, “Ignore sub-assemblies children when condition checks fail”, is unchecked. This setting means that when the publish task runs, every referenced component (parts, sub-assemblies, drawings, etc.) will be exported individually as a separate STEP file, regardless of any condition failures on child items.

By checking this option, you tell PDMPublisher to export the references of the active assembly. If you want to export select references, you can accomplish that with Conditions.

6. Open An Assembly Document

PDMPublisher operates on the currently active SOLIDWORKS document. This means that before publishing, the assembly that you intend to export must be open and active in the SOLIDWORKS window.

If you attempt to publish without an active document, SOLIDWORKS will display an error message indicating that no document is currently open:

Screenshot of SOLIDWORKS 2025 Professional (2023 SP0.1) showing the PDMPublisher add-in pane open on the Output tab. A blue banner at the top announces "A new version is out. Click here to download it". The main drawing area is empty, displaying only the SOLIDWORKS splash screen with the large "DS SOLIDWORKS 2025" logo. A centered orange error dialog from SOLIDWORKS reads "No active document found" with an OK button. In the PDMPublisher pane, the Export Location is set to "C:\PDMPublisher", the Filename template shows an invalid combination "File name without extension" + "Revision" (marked with red X icons), and File Formats is set to "pdf". Checked options include "Open Export Location On Completion", "Export references to file formats individually", "PDF", "Merge exported PDFs into one master PDF", and "Add table of content to merged PDF". The large "PUBLISH" button at the bottom is disabled. The interface demonstrates that publishing cannot proceed because no document is currently open in SOLIDWORKS.

7. Run the Publish Operation

Once the export location, filename pattern, and file format are set, click the PUBLISH button at the bottom of the PDMPublisher panel.

Publish Button

PDMPublisher will process the active document and generate the required export files according to the selected configuration. This includes handling references, multiple formats, and naming conventions automatically.

If the operation is time-consuming, you can cancel it from the progress dialog:

Screenshot of SOLIDWORKS with the PDMPublisher add-in active during a publishing operation. A centred progress dialog titled “Processing Tank_&Regulator&.SLDASM…” shows “66% complete” with a blue progress bar. The current status line reads “regulator_&.SLDPRT: Saving Default as .step…”, and a Cancel button is visible at the bottom. In the background, a large red 3D model of a hammer is visible in the graphics area. The PDMPublisher pane on the right is partially visible, showing the Output tab with Export Location set to “C:\speaker_project”, File Formats set to “step”, and the option “Export references to file formats individually” checked. The image captures the PDMPublisher add-in automatically exporting referenced part files as STEP during the publishing process of an assembly.


8. Verify the Exported Documents

Navigate to the folder you specified as the export location earlier. You should now find STEP files generated from your active SOLIDWORKS model, named according to your chosen template.

Screenshot of a Windows File Explorer window (in dark mode) opened to the folder “C:\speaker project”. The folder contains exactly three files displayed as large icons:

Tank & Regulator_&.step
tank 20lb propane_&.step
regulator_&.step

The right pane shows the folder summary “speaker project (3 items)” with the default prompt “Select a single file to get more information and share your cloud content.” The navigation bar at the top confirms the full path “This PC > Windows (C:) > speaker project”. The image shows the successful result of a PDMPublisher export task that automatically saved multiple referenced parts as individual STEP files into the designated output folder.

These files are ready for downstream use in CAM, manufacturing, or supplier collaboration.

get started with pdmpublisher

Automate exports and publishing in SOLIDWORKS and SOLIDWORKS PDM with a reliable, repeatable process that saves time and ensures consistency.