Skip to end of metadata
Go to start of metadata

This feature is only available for the BiZZdesign cloud solution and only available at request. If you want to have the embedding feature activated for your organization, please contact BiZZdesign Support and include the addresses that should be allowlisted in your request. If you prefer not to use IP allowlisting in conjunction with this feature, please mention that explicitly in your request.

This feature enables views inside HoriZZon to be embedded inside external content sharing platforms (such as SharePoint or Confluence). Embedded views can be seen by anyone who has access to the respective SharePoint or Confluence page or the unique URL for the embedded view. Views that are embedded outside HoriZZon in this way will redirect any visitor that clicks on it to HoriZZon itself, where they must have a Consumer role (or higher) to further explore the view there.

In order to embed a view, it is required that:

  • You are Lead Designer.
  • You are invited to the model package or project the site containing the view is based on, or you are the creator of the site.
  • Embedding is enabled for the site.

For examples of embedding, see the BiZZdesign blog Unleash the power of HoriZZon on SharePoint & Confluence.

Required roles

Lead Designer

On this page:

Security considerations

Unauthenticated access to content

Embed links, which are created when embedding views, allow unauthenticated access to a view. Anyone with the correct link will be able to access the view. This should be taken into consideration when embedding views. While it is possible to protect the systems where the embed link is used (such as SharePoint or Confluence) there is no way to control whether the link is shared outside that context. To protect against unauthorized access BiZZdesign offers two security measures:

  1. IP allowlisting: This will limit access to the shared content to requests from one or more IP addresses, typically your company's main internet gateway(s). It is highly recommended to use IP allowlisting if you intend to share views containing confidential information.
  2. Non-reusable embed links: If an embed link for a view somehow leaks beyond your intended audience, disabling and re-enabling sharing of that view will invalidate the old link. 

If you want to enable or modify the IP allowlist please contact BiZZdesign Support.

Security-related settings in third party applications

Use of embedded content in Confluence requires your Confluence Administrator to enable the HTML macro (Confluence server). Likewise, use of embedded content in SharePoint requires your SharePoint Administrator to enable embedding external content from your HoriZZon domain name.

Enabling embedding for a site

By default, sites are not enabled for embedding. This means that the views within that site are only available to appropriate users inside the HoriZZon platform.

In order to make views available outside HoriZZon, embedding needs to be enabled for the site that the view belongs to: 

  1. In HoriZZon, open the manage page of the site from which you want to embed one or more views.

  2. In the Manage site menu, select Share and embed, and then select All users.

  3. Under Enable embedding of views, select On.

  4. Click Apply to save the changes.

  5. Click Got it to confirm embedding.

The site now supports embedding its views in external sharing platforms.

Embedding content in a SharePoint page

  1. In HoriZZon, open the view you want to share embed, and click Share at the top of the page.

  2. In Embed view, click SharePoint.

  3. In the pop-up window, click Copy, and close the window.

  4. In SharePoint, open the page in which you want to embed the HoriZZon view, and put it in edit mode.

  5. On the SharePoint page, add an </> Embed web part, and paste the code you copied from from HoriZZon in the embed.

  6. Republish the page.

The result is an embedded view in the SharePoint page.

Example of an embedded view in a SharePoint page

Embedding content in a Confluence page

  1. In HoriZZon, open the view you want to embed, and click Share in the upper right corner of the page.

  2. In Embed view, click Confluence.

  3. In the pop-up window, select a size for the view to embed (Small, Medium, Large), click Copy, and close the window.

  4. In Confluence, open the page in which you want to embed the HoriZZon view.

  5. On the Confluence page, add an HTML macro, and paste the code you copied from from HoriZZon into the macro.

    If the HTML macro is not available (Confluence server), it has likely not been enabled. If enabling is not an option because of security reasons, an alternative solution can be creating a user macro for framing an external website on a Confluence page, and use this macro for embedding your views. Creating user macros requires Administrator permissions in Confluence.

    If you are working with Confluence cloud, you can use the Iframe macro instead of the HTML macro.

    Alternative macros may also be available via Confluence plugins.

  6. Update the page.

The result is an embedded view in the Confluence page.

Example of an embedded view in a Confluence page

Accessibility of embedded views without required permissions

While an embedded view in a SharePoint or Confluence page is visible to anyone with access to that page, accessing this view in HoriZZon is limited to anyone who is a registered HoriZZon user with the Consumer role. When clicking the embedded view the user is automatically redirected to HoriZZon. If they are not signed into HoriZZon already, they will see the HoriZZon sign-in window after clicking the embedded view.

In certain circumstances the view may be hidden to visitors. Instead of seeing a view, they will see an embedded page indicating to the user that the content is not available:

This will happen:

  1. To visitors who have an IP address that is not within the IP allowlist.
  2. If the view is no longer allowed to be embedded, or the secure URL to the view has been refreshed.
  3. If embedding as a feature is disabled for this instance of HoriZZon.

Stopping a view from being available outside HoriZZon

Once a view is embedded outside HoriZZon, it is accessible to anyone with access to the sharing platform page it is embedded in, or to anyone who has the URL from the embed code.

When you stop sharing the view, it will no longer be visible to others and the unique URL for the view will be invalidated. This means that it will no longer be available anywhere that it may have been embedded or via the unique URL from the contained within the original embed code. This also means that if you decide to embed the same view(s) in the future, you will need follow the steps again to embed content inside your content sharing platform.

Disable embedding for the site

By disabling embedding for the site, all embedded views within that site will be made unavailable outside HoriZZon, meaning any embedded views or embed links for that site will no longer be accessible.

To disable embedding for a site:

  1. In HoriZZon, open the manage page of the site for which you want to disable embedding.

  2. In the Share and embed section, under Embed views, select Off.

  3. Optional: If you want to stop sharing the view with all users, under Share the site with groups, clear All users.

  4. Click Apply to save the changes.

All embedded views for the site will now be inaccessible outside HoriZZon. If you wish to embed the view again, you will need to enable the site for embedding again and embed the view for your particular platform.

By disabling embedding for a site, all embedded views will no longer be available outside HoriZZon. If you wish to embed these views again you will need to re-enable sharing for the site and generate new embed codes for each view and paste them into SharePoint or Confluence where you wish to view them. 

Remove the embed link of the view

If you only want to stop sharing the view without blocking any other views in the site from being embedded, remove the embed link from the SharePoint or Confluence page.