• Updated

Folders in the assets panel in Optimizely Content Management System (CMS) are used for organizing content, such as media files (images, videos, and documents) and blocks. You can have folders with content that can be shared between websites in a multi-site scenario (so-called global folders), or you can have folders with content that will only be available for a specific website, page, or block (so-called site-specific or local folders).


Media and blocks share the same folder structure. This means that if you create a folder under Media, the same folder is also created under Blocks.

Depending on your implementation, you may have the following predefined folders:

  • For All Sites – This is a global folder. Its content is available to pages and blocks for websites in a multi-site installation.
  • Content – This is a site-specific folder. Its content is available only on the current website (regardless of whether it is a single or multi-site installation).
  • For This Page or For This Block – This is a local folder. Its content is available only for a specific page or block and cannot be accessed by others. It is useful, for example, if you have images for a specific purpose that must only be used for a page or block.


If you have saved an image in the local folder, then copy the page content, including the image, and paste it into another page, you may still see the image on the page. However, this is due to browser caching, so the image is not copied to the new page's local folder, and the link is, in reality, broken.

Local folders are not available for catalog content in Optimizely Customized Commerce.

Create, rename, and move folders

  • To create a folder, select the desired folder in the structure under which you want to add a folder. Select New Folder in the context menu, and provide a name for the folder.
  • Select Rename in the context menu for the folder you want to rename and enter a name.
  • Use drag-and-drop or Cut-and-paste to move folders in the structure.

Renaming or moving folders does not cause broken content links on your website but might break incoming links from other websites or indexing from search engines.

Delete folders

Select the folder you want to delete and select Move to Trash in the context menu. The folder with its content is moved to Trash, where it can be restored. Local folders cannot be deleted.

Because blocks and media files share the same folder structure, removing a folder affects the block and the media structure. You are notified about existing references to the content before removing it.

Set access rights for folders

The predefined global folder is available to everyone by default. Local folders inherit the access rights from the content (page or block) to which they are associated. You can define access rights for specific folders in a structure. Set access rights for folders is done from the admin view in CMS, in the same way as for pages in the page tree structure.

Manage folders in multiple languages

Folders are not language-specific, and the folder structure for blocks and media will look the same regardless of the language selected under the Sites tab in the navigation panel. This means you cannot create language versions for folders but can use a language code when naming them.