Publishing & Sharing

Publish your ShapeBox scene to the web, share it, embed it, and control who can view it.

Publishing & Sharing

When your scene is ready, publishing makes it accessible anywhere on the web in seconds — no server, no deployment, no code.

Publishing your scene

  1. Open the project in the editor.
  2. Click Publish in the top-right corner.
  3. Configure your publish settings (see below).
  4. Click Go Live.

Once published, your scene is live at a permanent URL:

https://shapebox.io/s/your-project-name

Publish settings

SettingDescription
VisibilityPublic (anyone with the link), Unlisted (hidden from search), Private (invite only)
Custom domainServe from your own domain (Pro and above)
Password protectionRequire a password to view the scene
Loading screenCustom branding on the initial splash screen
Allow embeddingControl whether the scene can be shown inside iframes
SEO metadataTitle, description, and social preview image for link sharing

Embedding in a website

Copy the embed code from the Publish dialog and paste it into your webpage's HTML:

<iframe
  src="https://shapebox.io/s/your-project-name"
  width="100%"
  height="600"
  frameborder="0"
  allow="xr-spatial-tracking"
  allowfullscreen
></iframe>

For a responsive full-bleed embed, wrap the iframe in a container:

.shapebox-embed {
  position: relative;
  padding-top: 56.25%; /* 16:9 ratio */
}
.shapebox-embed iframe {
  position: absolute;
  inset: 0;
  width: 100%;
  height: 100%;
  border: none;
}

The xr-spatial-tracking permission is required for WebXR (VR/AR) to function inside embedded iframes.

Custom domains

On Pro and above, serve your scene from your own domain:

  1. Open Publish → Custom Domain.
  2. Enter your domain (e.g. experience.yourcompany.com).
  3. Add the CNAME record shown to your DNS provider.
  4. DNS propagation typically takes under 30 minutes.

HTTPS is handled automatically — no SSL certificate setup required.

Unpublishing

To take a scene offline without deleting it:

  1. Open the project in the editor or dashboard.
  2. Click Publish → Unpublish.

The URL immediately returns a 404. Visitors currently in the scene see a disconnect notice. All project data remains in your account and can be re-published at any time.

Sharing with collaborators

To give teammates editorial access to a project:

  1. Click Share in the editor toolbar.
  2. Enter email addresses.
  3. Choose a permission level: Editor (can make changes) or Viewer (read-only access).
  4. Click Send invites.

Collaboration is available on Team and Enterprise plans.

Analytics

On Pro and above, the Analytics tab in the Publish panel shows:

  • Total views and unique visitors
  • Average session duration
  • Geographic distribution of visitors
  • Device breakdown (desktop, mobile, VR headset)
  • Load time percentiles (p50, p90, p99)

Analytics data updates every hour and is retained for 12 months.

Version management

Every time you re-publish a scene, the live URL updates instantly. Previous versions are retained in File → Version History and can be restored if needed. There is no staging environment — changes go live immediately on publish.