cs-icon.svg

Edit an Experience

Contentstack Personalize feature allows you to create and manage personalized experiences for your website or application. Regularly editing experiences is crucial because it allows you to keep your content targeting up to date and relevant. As your products, services, and offers change, you can easily update the variants and audiences in your experiences to reflect those changes. This ensures that your visitors always see the most accurate and relevant content.

This guide provides a step-by-step walkthrough for editing experiences in Contentstack Personalize. You will learn how to ensure that your personalized content is always accurate, relevant, and precisely targeted. Note that, at any given point in time, only 1 draft can exist for each experience in your Personalize project.

Prerequisites

  • Contentstack account
  • Access to the Contentstack Organization that has Personalize enabled
  • Access to a project in Personalize
  • Experience created in your Personalize project

Note: Users with Owner and Member access to a Personalize project can edit existing experiences.

Steps for Execution

Note: For this guide, we have assumed that you have already created a Personalize project. If not, please follow this guide and create a project in Personalize.

Editing an Experience Draft

To edit an existing experience (draft which was never activated previously), log in to your Contentstack account and perform the following steps:

  1. In the left navigation panel, click the Personalize icon.
  2. You will be redirected to the Personalize Projects landing page. Click the project for which you want to edit an existing experience.
  3. You can edit an existing experience by clicking your experience to open it or by clicking the corresponding vertical ellipses under Actions and selecting Edit.

    Note: An experience must be in the 'Draft' status to edit.

  4. On the Experience page:
    1. In the Overview tab, make the necessary changes to the Name and Description and then click Save General Details.
    2. In the Configuration tab, make the necessary changes to the existing Variants or click the + Add Variants to add more variants and then click the Save Draft button.
  5. You can choose to activate the draft by clicking the Activate Draft button.

You will get a success message after the experience draft has been successfully updated.

Editing an Active Experience

Warning: Editing an experience might affect your personalization for visitors and analytics. Exercise caution and update accordingly.

To edit an experience (which is currently active or paused), log in to your Contentstack account and perform the following steps:

  1. In the left navigation panel, click the Personalize icon.
  2. You will be redirected to the Personalize Projects landing page. Click the project for which you want to edit an existing experience.
  3. You can edit an existing experience by clicking your experience to open it or by clicking the corresponding vertical ellipses under Actions and selecting Edit.
  4. On the Experience page:
    1. In the Overview tab, make the necessary changes to the Name and Description and then click Save General Details.
    2. In the Configuration tab, click the Create Draft button to create a clone of the current active version and switch to the Draft mode.

      Note: You can also choose to pause the active version by clicking the Pause Version button and then creating a draft by clicking the Create Draft button. This, however, disrupts the personalization running with this experience for your visitors on your site. In such a case, the content from the Base Entry of the Entry Variant will be displayed.

    3. Make the necessary changes to the existing Variants or click the + Add Variants to add more variants and then click the Save Draft button.
  5. You can choose to activate the draft by navigating to the Draft tab and then clicking the Activate Draft button.
  6. When you activate a draft of a previously activated experience, the currently active version is automatically archived which you can find in the right sidebar widget.

You will get a success message after the experience has been successfully updated.

Additional Resource: You can use the Personalize Management API to create, edit, delete, and retrieve all existing experiences.

Was this article helpful?
^