Publish experience

This documentation relates to Experience Orchestration, the name of an internal program focused on developing several new capabilities for the Contentful platform. It is not a standalone new product. The materials shared here are intended exclusively for customers and partners participating in the Design Partner Program and reflect our current direction at this stage of development; as the program continues to evolve toward general availability, details may change. These materials are confidential and not for onward distribution.

When publishing an experience, you have the following options:

• Publishing references - Make sure to publish any draft or changed references of the experience. This helps make sure the live experience displays the expected content.

  • If a required dependency is left unpublished, the publish action is blocked.

  • If a referenced item has a validation error, publishing for that item is blocked.

  • If you do not have permission to publish a referenced item, you cannot complete the publish action until the permission issue is resolved.

• Locale-based publishing - You can publish one or more selected locales without publishing all locales at the same time. If you want to publish specific locales, make sure locale-based publishing is enabled for your environment. When locale-based publishing is enabled:

  • You can select one or more locales in the publishing modal.

  • The selected locales are published for the experience and for referenced entries and assets that support locale-based publishing.
    
    NOTE: For entries and assets, the default locale must be published. For experiences, publishing the default locale isn’t required.

  • Fragments, components, and templates don’t support locale-based publishing and are published fully even if you selected only some locales.

To publish an experience:

1. Log in to the Contentful web app.

2. In the Create area of the navigation pane, click Experiences and select All experiences.

3. Go to the required experience and click to open the experience editor.

4. In the experience editor, click Publish.

5. In the publishing modal:

   • Select locales - In this tab, select one or multiple locales that you want to publish.
     NOTE: The Select locales tab is displayed only if locale-based publishing is enabled for the environment. 

   • Add references - In this tab, select the references you want to publish with the experience.
     NOTE: If there is a validation error on an entry to be published, open the entry in a new tab and resolve the validation error (e.g., fill in a required field). Then, click Revalidate in the publishing modal.

6. Click Publish. Your experience is live.