> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Share your Models

> View your 3D Model anywhere

## What is model sharing in Speckle?

Model sharing in Speckle means sharing model access with links or embeds so
others can view and interact in a browser.

## Share using a URL link

With Speckle, sharing your 3D models is as easy as copying a link or embedding an interactive viewer—no huge file
transfers required. Because Speckle is a web app, you can access and interact with your models from any device—desktop,
tablet, or phone—from anywhere with an internet connection. **No special software or licenses are required to view and
interact with models;** everything runs right in your browser.

<Tip>
  Looking to create advanced analytics and dashboards from your model data?
  Check out [Speckle Intelligence
  Dashboards](/analytics/intelligence-dashboards) for interactive dashboards and
  insights.
</Tip>

You have two simple ways to share your Speckle model:

1. **Copy and paste the URL**\
   Just grab the link from your browser's address bar and send it to anyone who needs access.

2. **Use the Share button**\
   Click Share in the top-right corner, then select Copy link. Paste that link wherever you like.

<Frame caption="Share your model using the URL link">
  <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/3d-viewer/share_url_link.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=3a0381f545c83b004f7aa24725c6d847" width="1620" height="1080" data-path="images/3d-viewer/share_url_link.jpg" />
</Frame>

<Warning>
  If someone can't open your link, check your project's permissions. You may
  need to give them access to your workspace or project first. For details, see
  [Managing Access and Permissions](/workspaces/roles-and-seats) guide.
</Warning>

## Embed the 3D viewer

<Frame>
  <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/3d-viewer/embed_1.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=a5643e660ad6fb684253557ef46cd73e" width="1620" height="1080" data-path="images/3d-viewer/embed_1.jpg" />
</Frame>

### Options and settings

* **Embed code (iframe)**: Use when adding the viewer to another website.
* **Embed URL**: Use when you need a direct link without iframe code.
* **Viewer options**: Choose transparent background, hide controls, hide
  selection panel, prevent scroll zoom, or enable manual load.

<Frame caption="Embed your model using the iframe code">
  <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/3d-viewer/embed_options.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=6badd4d89ae25be9fe0ab0e665eefdd1" width="1620" height="1080" data-path="images/3d-viewer/embed_options.jpg" />
</Frame>

## Secure share links

The Share dialog can create a share token instead of relying only on workspace
or project membership.

* **Set an expiry date:** Make links stop working automatically after a specific
  date.
* **Add password protection:** Require recipients to enter a password before
  they can open the shared model.
* **Add a label:** Add an internal label (for example `Client review`) so you
  can identify the token later.

If a link is password protected, recipients are redirected to an unlock page
before the model loads.

You can review and revoke issued share tokens in **Project settings > Tokens**.

## If sharing does not work

Check these first:

* User cannot open link -> confirm project visibility and role permissions.
* Embed does not load -> confirm URL is full and iframe is not blocked by host.
* User can open but not interact -> check viewer options used in embed settings.
* Private view still hidden -> shared link does not override private visibility.

## FAQ

<AccordionGroup>
  <Accordion title="Does sharing a link make a private project public?">
    No. Regular project links still follow project visibility and role-based
    access.
  </Accordion>

  <Accordion title="Can recipients view models without installing Speckle connectors?">
    Yes. Recipients can open shared model links in a browser without connector
    installation.
  </Accordion>

  <Accordion title="When should I use embed URL vs iframe embed code?">
    Use embed URL for direct navigation links. Use iframe code when placing the
    viewer inside another product or page.
  </Accordion>

  <Accordion title="Can I share a model privately without adding users to a workspace?">
    Yes. Create a share link from the Share dialog. You can optionally add an
    expiry date and password. Anyone with the link can view the shared model
    without signing in.
  </Accordion>

  <Accordion title="What happens when a share link expires?">
    The token stops working. Recipients can no longer access the shared model
    with that link. Create a new share link if access is still needed.
  </Accordion>

  <Accordion title="Can I revoke a share link before it expires?">
    Yes. Open **Project settings > Tokens** and revoke the token.
  </Accordion>

  <Accordion title="Why does an embed load but show limited controls?">
    Viewer behavior may be constrained by embed options, such as hidden controls
    or manual load mode.
  </Accordion>
</AccordionGroup>

## Examples

### Speckle in Miro

<div
  style={{
position: "relative",
paddingBottom: "56.25%",
height: 0,
overflow: "hidden",
}}
>
  <iframe
    src="https://player.vimeo.com/video/1087137665"
    allowFullScreen
    loading="lazy"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
}}
  />
</div>

### Speckle in Notion

<div
  style={{
position: "relative",
paddingBottom: "56.25%",
height: 0,
overflow: "hidden",
}}
>
  <iframe
    src="https://player.vimeo.com/video/1087045865"
    allowFullScreen
    loading="lazy"
    style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
}}
  />
</div>