Share links & embeds

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

Viewers are free on all IcePanel plans. Only admins and editors in a landscape can create share links.

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.

You can copy this link and embed it as an iframe in tools like Confluence, Notion, or any other platform that supports iframing.

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.

Click Copy link to grab the shareable URL

You can restrict navigation by toggling 'limit to this diagram'.

Manage sharing lets you configure domain restrictions and SSO settings for who can access the shared links.

Manage sharing

This field controls which domains are permitted to view your shared content through SSO authentication.

To set up SSO links, you need to have SSO enabled. See SSO - SAML

Enter a domain here to allow SSO sharing specifically for that organization.

Password and SSO-protected links are only available on Growth and Isolation plans.

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.

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.

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.

For more information on versioning, see Versioning

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

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).

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