Embeddable Viewer

Embeddable Viewer lets you add interactive PCB and schematic viewing to your own web application – so stakeholders outside your Altium 365 Workspace can inspect designs without installing any ECAD tools.

When to Use It

  • Customer or supplier portals – let external partners review design snapshots in context, without needing Altium access.

  • Review and approval workflows – embed design viewing into tickets, release checklists, or approval tools so manufacturing, procurement, or management teams can inspect the design directly.

  • Internal engineering tools – link requirements, issues, or BOM line items to a live interactive design view.

How it Works

The viewer is embedded via a JavaScript library and a <div> container pointing to a design ZIP file. The ZIP must be accessible at a public URL – typically hosted in your Altium 365 Personal Space or your own storage.

Add the embed script to your page <head>:

<script src="<https://viewer.altium.com/client/static/js/embed.js>"></script>

Add the viewer container in your page body:

<div class="altium-ecad-viewer"
  data-project-src="<https://example.com/mydesign.zip>"
  style="height: 500px; max-width: 1280px; max-height: 700px; box-sizing: border-box;">
  <a href="<https://www.altium365.com/viewer/>">PCB File Viewer by Altium</a>
</div>

The embedded viewer will remain active for as long as the source design file is available. For a persistent source, save the design to your Altium 365 Personal Space – files there generate a stable URL.

Customization

Control which views are shown and how outputs are exposed using data-* attributes on the container:

Attribute

Description

Values

data-enabled-views

Views to show (comma-separated)

sch, pcb, 3d, bom – default: all

data-active-view

Initial view on load

sch (default), pcb, 3d

data-src-type

Restrict accepted file type

Design, Gerber – default: both

data-project-outputs

Export formats to offer

Gerber, Odb, Step, Pdf, Idf, Ipc2581

data-hide-project-src

Disable source file download

(presence of attribute disables it)

data-project-src-alternative

Alternate file for download (different from preview source)

URL

Example – PCB and 3D views only, with Gerber and PDF export:

<div class="altium-ecad-viewer"
  data-project-src="<https://example.com/mydesign.zip>"
  data-enabled-views="pcb,3d"
  data-active-view="pcb"
  data-project-outputs="Gerber,pdf"
  style="height: 500px; max-width: 1280px; box-sizing: border-box;">
  <a href="<https://www.altium365.com/viewer/>">PCB File Viewer by Altium</a>
</div>

Getting the Embed Code from the Viewer

If you've uploaded a design to the Altium 365 Online Viewer, you can copy a ready-made embed snippet directly:

  1. Open the design in the viewer.

  2. Click Share and select Embed this design anywhere on the web.

  3. Copy the generated HTML snippet.

The snippet uses data-project-token to reference a design uploaded to Altium's hosting. To point it at your own ZIP file, replace data-project-token with data-project-src and a URL to your file.

Further Reading

  • Standalone Viewer – full viewer functionality reference, including all embedding options and attribute details

  • Standalone Gerber Compare – comparing Gerber files in the viewer

  • Embedding Personal Uploads – designs and design data that you have uploaded to your Altium Personal Space can be embedded into a website for interactive viewing by anyone, using the embedded Altium Viewer.

  • Viewers Troubleshooting Guide – resolving common issues with the viewer and embedded designs

 

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