Netlify

The Netlify app integrates the Contentful Web App with Netlify. When deploying content changes from Contentful to Netlify via continuous delivery, editors can track the progress of the build process from within the web app.

Overview

The Netlify app provides the following functionality:

• Allows users of a space to trigger a build of a Netlify site

• Shows the build status in the Contentful web app, allowing editors to see build updates in real time.

Requirements

To use this app, you need:

• A website that fulfills the following requirements:

  • Generated using a static site generator (e.g. Middleman, Hugo etc.).

  • Pulling content from Contentful.

  • Pushed to a remote repository so Netlify can fetch the site's code when building.

• A Netlify setup including the following:

  • An account on Netlify.

  • A site on Netlify which is connected to the repo mentioned above (the site needs to be enabled for continuous deployment).

Under the hood

Internally, the app does the following:

1. Authenticates with Netlify via OAuth.

2. Asks you to select sites from your Netlify account to build.

3. Creates an incoming build hook to trigger the Netlify build.

4. Notifies Contentful if the build changes status (e.g. success or fail).

5. Adds a new sidebar widget in Contentful which can trigger the build and open the site.

Usage

Step 1: Install and configure

Click Connect... to authenticate with Netlify:

This authorizes the app to act on your behalf in API interactions from Contentful to Netlify.

Step 2: Configure Netlify sites to build from Contentful

Use the dropdown to choose a site on Netlify you want to build. Note that the site needs to have continuous deployment enabled. Usually, it makes sense to have two sites:

• A first site where you are building gatsby-netlify-contentful and will use the label Production

• A second site where you are building gatsby-netlify-contentful-preview and will use the label Preview

Having a production and preview site is not a requirement but is highly recommended. Using this setup you can make sure your changes look right before shipping to production.

Step 3: Use the Netlify build widget from the entry editor

The Netlify app creates a custom widget for the content preview experience.

The widget shows a Build button that:

• Shows the status of the build.

• Shows who triggered the last build and when.

It also shows an Open site button which opens the URL of your Netlify site picked in the configuration step.

FAQ

What happens with the OAuth token that the Contentful web app obtained during the configuration of the Netlify app?

The token is only used during the app's configuration phase and is not persisted. Therefore, you need to re-authenticate every time you want to change the app's configuration.

Who will be able to trigger Netlify builds with this app?

The installation and configuration of the Netlify app are only accessible to admins. However, the new build widget provided by the app is accessible to every user with content access.