Add the Gatsby Preview App to the Contentful Sidebar
Adding this app to the Contentful sidebar will make your preview edits update faster.
Prerequisites
The site must be set up with a Gatsby Preview instance. Please see “Getting Started with Gatsby Cloud and Contentful”.
Installing App
To install the sidebar extension in your Contentful space follow the steps below.
-
Log in to your Contentful Dashboard
-
From the “Apps” Menu, select “Manage Apps”.
-
Find “Gatsby Cloud” in the list of apps and select.
-
A modal will open titled, “App details”, click install and you will be navigated to configure the app.
-
Authorize the Gatsby Cloud App to access your Contentful Space.
-
Fill in the input labeled “Site URL” with the URL of your Gatsby preview instance. You can find this on ‘/dashboard/sites’ or in the settings for the Preview instance.
-
Fill in the input labeled “Webhook URL” with the webhook URL of your Gatsby preview instance. You can find this in the settings for the Preview instance.
-
(Optional) Fill in the input labeled “Authentication Token” with an
authToken
. This is necessary for Gatsby Preview instances that require the user to login before they can view the Preview. -
Select all content types where you’d like the Preview button to be available in the side bar. (This can be changed later from the Sidebar settings page for each content model).
-
Click Install in the top right corner to finish configuring the app.
-
Navigate to a piece of content within Contentful. The sidebar will be installed and displayed to the right.
You can navigate to the preview instance by clicking “Open preview”. Automatic updates are debounced 1000ms.