Embedding Grist#

This is an experimental feature

The design of this feature is likely to evolve. Keep an eye on our Roadmap for updates.

Perhaps you’d like to list your product, prices and quantities on your website, or you want to display a pie chart of voting results that updates live. With public access turned on, you may embed your Grist document on your own site.

To do that, you first need to make it public and have access to your website’s code in order to place some HTML code in the desired location.

If your site is hosted on some popular cloud CMS platform (like Blogger or WordPress), you may find HTML code blocks in your theme editor, or may need to use a plugin to access your site’s code. If you have any problems editing your site, feel free to ask us or post a question on our Community Forum.

Once you have decided where to embed your document, paste this code snippet in your HTML file:

<iframe src="https://templates.getgrist.com/6D8E2h2DQNwS/Task-Management/p/6?embed=true" 
        height="250px" width="100%" frameborder="0">

The src attribute points to the URL of the page you want to embed. To get the URL for your document, simply navigate to the page you want to share and copy the URL from the browser’s address bar. Appending the ?embed=true parameter at the end tells Grist that it should show only the content of your page, removing any elements that are not necessary for the embedded version. You may wish to adjust height and width attributes to make it look better on your site.

Since this Help Center document is a regular HTML file, we can try it right away! Below you should be able to see an embedded live table (not a screenshot) from one of our examples:

This is live, read-only view of the Grist page and it gets updated as soon as someone edits it. You can, of course, embed any page you wish, including card view, charts and any page with multiple sections.

Here are two more examples with a chart and a card list view:

Embedding editable documents is not yet supported, but we are working on it and will make it available soon. You can track our progress on our Roadmap.

Sharing an Embedded Style View

Adding ?embed=true or ?style=light to the end of a document’s page URL renders the document without the toolbar on top, the page menu on the left or creator panel on the right. ?style=light can be edited and follows access rules, while ?embed=true is read-only. To learn more about link sharing, see Public access and link sharing