# Share links & embeds {% embed url="" %} Sharing knowledge is critical to everyone being on the same page about how your system works and what is being built. IcePanel Share links make this easy, allowing a read-only and up-to-date version of your design to be shared with a URL. Share links can also be protected with passwords or SSO so only the right people can access your diagrams. Share links can be embedded in the following collaboration tools, as well as any tools that support iframes: * Confluence * Notion * Miro * Microsoft Sharepoint {% hint style="success" %} Viewers are free on all IcePanel plans. Only admins and editors in a landscape can create share links. {% endhint %} ## Create a share link Start by clicking the Share button in the top right corner to open up the sharing options. ![Click the Share button to open the sharing options for this diagram.](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_1.jpg) You can copy this link and embed it as an iframe in tools like Confluence, Notion, or any other platform that supports iframing. {% hint style="info" %} **Tip:** When you share a link, viewers will be put exactly where you are when creating your link with the same zoom level, selected objects, and tag groups displayed. You can also have viewers enter a specific flow directly by opening it and sharing a link. {% endhint %} ![Click Copy link to grab the shareable URL](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_2.jpg) {% hint style="info" %} You can restrict navigation by toggling 'limit to this diagram'. {% endhint %} Manage sharing lets you configure domain restrictions and SSO settings for who can access the shared links. ![Manage sharing](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_3.jpg) This field controls which domains are permitted to view your shared content through SSO authentication. {% hint style="warning" %} To set up SSO links, you need to have SSO enabled. See [SSO - SAML](/other-information/sso-saml.md) {% endhint %} ![Enter a domain here to allow SSO sharing specifically for that organization.](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_4.jpg) {% hint style="info" %} Password and SSO-protected links are only available on Growth and Isolation plans. {% endhint %} ## Sharing a specific version Select the version you'd like to share. In this example below, version 71 is selected, which will let us share that exact snapshot of the diagram. ![Select version 71 here so you can share the exact version that matters to your audience.](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_12.jpg) Navigating to the diagrams and selecting one, I can now see this diagram in version 71. Clicking Share now, the link will point to this exact version of the diagram. ![Click Share to generate a link for this specific diagram version.](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_15.jpg) Notice that the share link is locked to version 71, so anyone who uses this link will always see the diagram exactly as it appears in this version. ![Click Share to generate a link for this specific diagram version.](https://storage.saltfish.ai/demo-recordings/demo_1779920108203_21zbgu93c/step_16.jpg) For more information on versioning, see [Versioning](/future-state-design/versioning.md) ### Disabling share links Only admins and editors can create shared links for landscapes and diagrams by default. To disable share links globally in the organization: 1. Open the Organization dropdown and click on `Manage` (only visible to Admins) 2. Go to Sharing 3. Turn off the `Share links` toggle

Disabling share links in an organization

{% hint style="info" %} If you disable global share links, users will still be able to toggle share links on in the app (but they won't be accessible). {% endhint %} ## Embedding share links Landscapes and diagrams can be embedded via iFrames in other tools. If you share the latest version, these links will also remain up-to-date. To embed a landscape or diagram: 1. Click on the `Share` button on the top right of the navigation (in a landscape or diagram) 2. Click on the `Share link` tab 3. With Share links enabled, select the tool in the embed list 4. Copy the share link or the iFrame code ### Embed in Notion 1. In a Notion page, paste your IcePanel share link 2. Select the `Create embed` option in the dropdown 3. Resize the embedded URL to max width and height so it's readable by your viewers

Embedding a diagram in Notion

### Embed in Miro 1. In a Miro board, click on the `More apps` button and select `Embed iFrame code` 2. Copy the iFrame code from IcePanel with your share link 3. Paste the iFrame code in Miro's text field and click `Embed` Viewers must click on the iFrame image to load and interact with the landscape or diagram. We recommend adding a link to the up-to-date share link by: 1. Selecting the iFrame 2. Add a link by using hotkey `Cmd + K` or `Ctrl + K` or by selecting the 3 dots menu on the image and then selecting `Link to` 3. Paste in the share link

Embedding a diagram in Miro

### Embed in Confluence 1. Insert an iFrame macro with the + icon from the toolbar 2. Copy your IcePanel share link 3. Paste the share link in the URL field 4. Set the width to 100% and height to 800 5. If your Confluence page is set to a fixed width, set “Go full width” under iFrame *(optional)* 6. Add your share link under the iFrame for a direct link *(optional)*

Embedding a diagram in Confluence

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.icepanel.io/collaboration/sharing.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.