Add an Experience Slot

Experience slots are the named connection points in your surface and component workflows. By assigning an experience to a slot, you control what users see when a workflow returns that slot. For example, the paywall or promotional component shown at a specific moment in their journey.

Viewing Experience Slots

To view the experience slots for a surface, navigate to Surfaces in the left-hand navigation menu and select the relevant surface. Then click the Experience Slots tab.

Your list of experience slots will show:

• Key and Description: The identifier and description of the slot
• Facet: The content type the slot accepts — web content, JSON, or text
• Linked Experiences: The experience currently assigned to this slot. You can update the linked experience directly from this column using the dropdown.
• Actions: Edit and delete icons for managing the slot

Adding an Experience Slot

To add a new experience slot, click 'Add Experience Slot'.

You will be prompted to give the slot a key and an optional description, as well as select the facet. The available options are:

• Web Content: For rich, pre-rendered HTML experiences such as banners or messages that surfaces embed directly
• JSON: For structured data where the surface controls how it is rendered
• Text: For simple values such as labels, messages, or short copy that surfaces can render directly

Once configured, click 'Create Experience Slot'.

Please note: Once an experience slot has been created, it must be referenced in the appropriate surface or component workflow in order to display the experience. Below is a reference example where an experience slot for a sticky footer is being used to call an experience that shows a user's remaining number of free video views.

const remainingStickyFooter = await experiences.resolveAsWebContent(
  "remaining-views-sticky-footer",
  {
    templateVariables: {
      "remaining-views-message": `${remainingViews} views remaining`,
    },
  },
);

return {
  content: {
    append: remainingStickyFooter,
  },
};

Editing an Experience Slot

To edit an experience slot, locate it in the list and click the edit icon in the Actions column. Update the key or description as needed, then click 'Update'.

Deleting an Experience Slot

To delete an experience slot, locate it in the list and click the delete icon in the Actions column.

You will be prompted to confirm you wish to delete the slot. This will permanently remove the experience slot. Any workflows referencing this slot may stop working. To continue, click 'Delete'. Otherwise, click 'Cancel'.