HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket


Describes the projects feature.

A project lets an editor manage the publishing process for multiple related content items. The editor can add a landing page, blocks, pages, and products (if Optimizely Customized Commerce is installed) to a project and publish them (manually or scheduled) simultaneously.

You have the following options when working with projects:

  • The Projects feature is enabled for the entire site.
  • Each user can use the "old" Project gadget independently of others.

Projects features

  • The Projects feature is turned on (default) or off for the entire site and affects all users. To turn off Projects, you must configure ProjectUIOptions.ProjectModeEnabled to false. When enabled, a project bar displays at the bottom of the user interface. A project overview and a Project Items navigation panel also display.
  • Editing actions, such as creating and updating items, automatically associate a content item with a currently active project. Exceptions to this rule include moving items in the structure, setting content to expired, and changing access rights or language settings. These actions do not associate content items with the active project.
  • You must manually deactivate a project to stop items from being automatically added to the project.
  • Project items are only available to users who have access rights to the items.
  • Content associated with a project is locked for editing if another project is active.
  • It is a version of the content associated with a specific project, which means you can associate one draft of a page with Project A while another can associate a draft of the same page with Project B.
  • You can continue working on a project after some or all of the items within a project are published.
  • The project overview has a commenting feature, letting editors collaborate by adding comments and replies to comments on project items and projects. Editors also can tag users in the comments.
  • You can set up email notifications to editors.

Example workflow when working with projects

  1. Create a project (or set a project as active).
  2. Edit content items.
  3. Collaborate with other editors by adding comments to the edited project items and review changes.
  4. Preview the site as if the items in the project are published.
  5. Set items in the project as Ready to Publish.
  6. Publish items at once (or schedule them for later publishing).


Versions in Optimizely work differently when the projects feature is turned on. See Projects in the Optimizely user guide.

Email notifications

You can email editors when someone comments on project actions (such as setting a project to Ready to Publish) or reply to their comments. Editors also get an email if someone else tags them in a comment. How often these notifications are sent depends on the system configuration.



You need to configure the SMTP settings for Optimizely Content Management System (CMS) to send out email notifications. See Configure your email server.

Scheduled jobs

Notification Message Truncate

The Notification Message Truncate job truncates (deletes) 3-month-old notification messages that could not be sent and are still in the system. The job is turned on by default and set to run every day.

Notification Dispatcher

The settings in the Notification Dispatcher job determine how often Optimizely CMS sends notifications of new or updated comments or replies posted in projects by a notification provider (for example, an email provider). Notification messages are sent to users who:

  • are tagged in a comment or reply
  • receive replies to their comments
  • receive comments on their project actions (such as setting a project item to Ready to publish),
  • have previously replied to the same comment

No notification is sent if no comments or replies were posted since the job was last executed.

The job is turned on by default and set to run every half hour.

Optimizely Labs app Project Enhancements

See also the Project Enhancements in the Optimizely Labs app, which contains further improvements to the projects feature.

Related blog posts