Installing Content Sync for DatoCMS

What is Content Sync?

💡 Content Sync brings new super-powers to CMS Preview. When content editors click Open Preview, Content Sync jumps into action and routes content editors to the correct URL. It also helps them understand the status of preview, so they know when it's ready and if anything went wrong.

Instructions

1. Install version gatsby-source-datocms@3.0.10 or later.
2. Make sure you're on the latest version of Gatsby core (gatsby@latest) as well as any other gatsby-* packages. (The latest Gatsby v3 or v4 versions will both work.) Commit and push these changes to Gatsby Cloud.
3. Confirm that CMS Preview Builds are enabled in your Gatsby Cloud Site settings.
4. Delete existing DatoCMS integration and then re-add it. This process installs the latest Gatsby Cloud extension for DatoCMS.
   
5. Now you are ready to edit content and preview it! Navigate to "Content" in the top navigation bar. Edit some content, chose "Save", then preview your changes with the purple "Open Preview" button on the right sidebar.

Note

Gatsby tries to determine the correct page for each preview automatically. If you find you're taken to a page where your content exists but it's not the page you want to preview on, for example arriving on a blog listing page instead of an individual blog post page, you can add an ownerNodeId to calls of the createPage action in your Gatsby site. See docs here.