The Embed feature in Astrato lets you take content from a published workbook and embed it in other web-based material. The content retains its interactivity and connection to the live source data meaning you have a single source of truth for your analytics wherever they’re used.

Share key live content from the business applications your team uses every day - CRM, HubSpot, Confluence, Qlik Enterprise (using Vizlib Live!), publicly on your website or in another SaaS product.

⚠ Please note: Actions are not supported within embedded objects, groups, or sheets.

The Embed feature creates a link to the source content you select from a published workbook. You can use the Embed link within an HTML <iframe> tag (Inline Frame) on a destination web page - or you can use the link on its own to display the content in a web browser.

Please note: Although most web browsers support the <iframe> tag, not all web-based text editors do. Please check with your Astrato Administrator or the documentation of the destination application or platform where you want to embed content.

Back to Top

The first step to using the Embed feature for external links requires your Astrato Administrator to enable its use.

Figure 1: Embed Links option in the Administration settings in Astrato.

Figure 2: Switch to enable or disable external embed links.

Administrators manage the list of domains allowed to embed Astrato content. This ensures that the live data source access stays inside approved platforms and applications.

The error message: Domain not added. Please contact your administrator displays if you have not added the domain to your list of allowed sites.

Figure 3: List of allowed domains.

Figure 4: Enter the Domain URL and click Save.

Replace the subdomain name with an (*) asterisk (as a wildcard). This allows all subdomains to be used as Embed link destinations within that domain.

Using the example in Figure 4, you'd enter *.qlikcloud.com in the Domain URL field.

Back to Top

To create an Embed link, you must have one of the following roles: Creator, Workspace Owner, or Administrator.

⚠ Please note: There is no support for Actions within embedded objects, groups, or sheets.

Figure 5: Object source options for Astrato Embed links.

Please ensure the object you want to use as an Object embed link is not layered under other objects. You can paste the link in the browser to check you've selected what you want to use.

This ensures you can click on it easily from your published workbook to create the link to the object.

The parent object group is used as the source of your Embed link when you select the option to create a Group objects Embed link. The nested group of objects (child) of a parent object group can’t be selected for use as a group.

All Creators can generate restricted Embed links within their domain and share the link with other Astrato users in their company. This function for Creators does not need to be enabled by Astrato Administrators.

⚠ Please note: Viewers of any content in Astrato must have permission to view the underlying data.

The option to select 'External' is only available to action if your Administrator has enabled the feature for External Embed links.

⚠ Please note: Restricted links are not displayed when viewed in a browser's Incognito mode.

Figure 6: Select Embed link view permissions.

Figure 7: Select either the Copy Link or Copy embed code.

Tip: it is good practice to include a title attribute with an <iframe> as screen readers use it to read out the content inside the <iframe>.

Back to Top

You can apply a filter (as a parameter) to the view of the source data on an embedded sheet, thereby restricting the scope of the visible data.

Use this feature to produce contextual embeds, highlighting the data most relevant to where you've shared your embedded data.

Figure 8: Astrato Embed filter source data

You can append a filter to a link by adding the filter query to your URL. The filters added to the link are structured as follows:

So, for example:

This filter query applies a filter on the United States in the Country field from the Territory table in the Sales schema.

At the end of your Embed link, add the code:

In this example, the chart data refreshes every 60 seconds.

Back to Top

Administrators can see all Embed links; however, users with a Creator role can only see the Embed links they’ve made.

There are detailed sorting and searching options to help you manage your Embedded links.

From the Items list tab, the options are:

The icon beside the link name is linked to the type of object the link is for:

Users can change a link’s view permissions from Restricted to External or vice versa.

To modify an Embed link's permissions:

Back to Top