Embed and Sharing
Embed your published ShapeBox scene on any website using an iframe or share it with a direct link.
Embed and Sharing
Once you publish a ShapeBox scene, you can share it in several ways: a direct link, a social share, or an embeddable iframe that drops your interactive 3D scene into any website.
Getting the Embed Code
- Open your project from the Dashboard
- Open File → Share & Embed (or use the Share button in the top-right)
- Make sure the project is published (toggle Publish on if needed)
- Copy the iframe snippet from the Embed tab
Example iframe snippet
<iframe
src="https://app.shapebox.io/embed/YOUR_PROJECT_ID"
width="100%"
height="600"
frameborder="0"
allowfullscreen
allow="xr-spatial-tracking"
></iframe>
Add
allow="xr-spatial-tracking"to enable WebXR / VR mode inside the embed.
Embed Options
Configure the embed appearance from the Share & Embed panel or by appending URL parameters:
| Parameter | Values | Description |
|---|---|---|
ui | full (default), minimal, none | Controls which UI chrome is visible |
autoplay | true / false | Start scene playback automatically |
bg | hex color e.g. ffffff | Override background color |
ar | true / false | Show AR launch button (mobile) |
vr | true / false | Show VR launch button (headset) |
Example: minimal UI, white background
<iframe
src="https://app.shapebox.io/embed/YOUR_PROJECT_ID?ui=minimal&bg=ffffff"
width="100%"
height="600"
frameborder="0"
></iframe>
Responsive Embeds
To make the iframe fill its container responsively, use CSS:
<div style="
position: relative;
padding-bottom: 56.25%; /* 16:9 */
height: 0;
overflow: hidden;
">
<iframe
src="https://app.shapebox.io/embed/YOUR_PROJECT_ID"
style="position:absolute;top:0;left:0;width:100%;height:100%;"
frameborder="0"
allowfullscreen
allow="xr-spatial-tracking"
></iframe>
</div>
Direct Link Sharing
Every published project has a shareable URL at:
https://app.shapebox.io/view/YOUR_PROJECT_ID
This opens your scene in the full ShapeBox viewer — no account required for visitors. Share this link on social media, in emails, or in presentations.
Social Share
From the Share panel, click the social icons to post a preview directly to X (Twitter), LinkedIn, or generate a QR code that links to your scene.
Custom Domains
On the Pro plan and above, you can serve your scene from your own domain (e.g. https://demo.yourcompany.com). See the Publishing guide for DNS setup instructions.
Privacy Settings
| Setting | Behaviour |
|---|---|
| Public | Anyone with the link can view — also indexed by ShapeBox Discover |
| Unlisted | Anyone with the link can view — not indexed |
| Private | Only project members can view |
| Password protected | Visitors must enter a password (Pro+) |
Embed codes always respect the project's privacy setting — private or password-protected scenes will not load in embeds for unauthorized visitors.