Organize Experience Orchestration entities into folders

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.

Folders help you keep experiences, components, templates, and fragments organized. They improve visibility, reduce clutter, and make it easier to find the right entity faster.

• Folder structures are organized by entity type. 

• Entities that can be added to folders are: experiences, components, templates, and fragments.

• Each entity can belong to only one folder.

• Folders are space-level. Changes to a folder, like deleting, reordering, or renaming it, apply to all environments in a space.

• Folders can be created, deleted, renamed, and reordered only by owner, admin, and developer organization roles. 

To create a new folder:

1. Log in to the Contentful web app.

2. Open the list view for the entity type you want to organize, such as experiences, components, templates, or fragments.

3. In the left sidebar, go to the folders area and click on a folder icon to create a new folder. A Create new folder window is displayed.

4. Enter a custom folder name.
   Tip: Use a clear name that reflects the grouping you want to use, for example, a brand, campaign, market, or page type.

5. Click Create. The new folder appears in the sidebar for that entity type.

Click on the three-dots menu next to the desired folder to do the following:

• Rename  - Enter a new name for your folder, then click Rename to confirm.

• Move up or Move down - Change the folder’s position in the folders’ order.

• Delete - Delete the folder. The entities will be moved to the default All folder.
  
  NOTE: Renaming, reordering, or deleting a folder applies to all environments in a space.

• Add an entity to a folder - A new entity can be added to a folder according to the following options:

  • In the new entity creation window - Either assign an entity to an existing folder from the Folder field, or create a new folder directly from that field so the entity is organized from the start.

  • From inside a folder - If you create an entity from within a folder context, that folder is selected as the default option during creation.

• Move an entity to a different folder - In the list view, change folder location for your entities according to the following options:

  • For a single entity - Click on the three-dots menu against the desired entity and select Move to folder, then select the desired folder. 

  • For multiple entities - Select the desired entities by checking their boxes, then click bulk action Move to folder and select the desired folder.

• Remove an entity from a folder - The entity will be moved to the default All folder:

  • In the list view - Click the three-dot menu next to the desired entity and select Remove from folder.

  • From inside a folder - Go to the required folder, select one or multiple entities from the list view, then click bulk action Remove from folder.