Approval sequences

  • Updated

Approval sequences are used for content approvals, part of Optimizely Content Management System (CMS) (SaaS).

  • Content approvals ensure that content is reviewed and approved before publication. If content approvals are defined for an item, the editor cannot publish it but has to set it as Ready for Review. For a description of content approvals from an editor's perspective, see Approve content.
  • Change approvals ensure that certain actions affecting the application structure or content are reviewed and approved before they are applied. See Approve changes for information on which actions are affected.

When an item or a change is in review, one or more appointed reviewers must approve it before it can be published or the change is applied. The reviewers are defined by an administrator in an approval sequence.

You define an approval sequence for a specific page in the page tree or a global or application-specific assets folder in the assets panel. You can then let the item's or folder's children inherit the approval sequence, create an approval sequence for the children, or turn off approval sequences for the children. See Approve assets for information on how approval sequences work on assets.

You can add individual users and user groups. User groups and individual reviewers must have Read access rights and at least one other access right to the content item to review and approve it. You should use Read and Create because Create has the least capabilities because it prevents any actions on the content item, or Read and Change because Change alone cannot affect the visitor, unlike Delete and Publish. See Access rights.

The approval sequence overview is opened from a page's or asset folder's context menu:

approval sequence overview

In the approval sequence overview, you define the number of approval steps (you can have as many as you like) and the persons responsible for review and approval in each step.

define the number of approval steps

Content approvals on assets

Each page in Optimizely can have its approval sequence. Assets, such as blocks and media, cannot have individual approval sequences. Instead, the approval sequence is set on each assets folder, and the assets in the folder have the same approval sequence. Global and application-specific assets folders can inherit their approval sequence from a parent folder (up to the application root). Alternatively, you can define a unique sequence for it (or turn it off completely so that assets in the folder do not have to be approved). If no sequence is set on a parent item, children inherit the disabled state.

  • Blocks and media in global (For All Applications) and application-specific (For This Application) folders inherit the approval sequence from the parent node by default.
  • Content inherits from the Root, which is different for global and application-specific folders. The global assets folders inherit from Root, while application-specific assets folders inherit from the application's root.

Local assets folders inherit their approval sequence from the page they are associated with. See Folders for a description of global, application-specific, and local folders.

What happens if I want to move folders or assets that have content approval sequences set?

The following description assumes you are using Content approvals but not Change approvals. If you are using Change approvals, moving folders and assets will trigger an approval sequence that must be approved before the folders or files are moved.

Moving folders and assets with content approval sequences set works like the following descriptions.

Folders

  • If you move a folder to another global or application-specific folder, it keeps its original approval sequence. You can move the folder even if items are in review.
  • If you move a folder to a local assets folder, the folder's approval sequence is changed to the local assets folder's sequence. You cannot move the folder if items are in review.

Assets

  • If you move an asset to a global or application-specific folder, the approval sequence on the asset is changed to the new folder's approval sequence. You can move an item even if it is in review. However, in that case, it continues its original content approval sequence until it is approved or rejected. After that, it has the same approval sequence as the new folder.
  • If you move an asset to a local asset folder, the approval sequence on the asset is changed to the new folder's approval sequence. You cannot move the asset if it is in review.

The Blocks and Media folders in the assets panel are the same folders in the software and share the same approval sequences; the Blocks and Media tabs in the assets panel are merely a way of filtering out blocks if you are in the Media tab and vice versa. This means that if Adam is set as a reviewer on the block folder Bunnies, Adam is also a reviewer of media in the media folder Bunnies.

As a result, if you edit a block in the Bunnies folder, which links to images in the media folder Bunnies, and set the block to Ready for Review, the same content approval sequence is also triggered for the images.

Content approvals on multi-language applications

If you are working with a multi-language application, you can define different reviewers for the different languages in each step. Each language must have at least one reviewer, but it is recommended to have at least two reviewers per language. This is especially important if you select the Prevent users from approving their changes checkbox because an item could otherwise get stuck in the review process if the review request is started by a user who is the only reviewer.

Items, such as images that do not have a language set, can be approved by any reviewer (even by reviewers who only have access to a specific language).

You can view how the approval sequence is defined for all languages or each language individually by using the Display sequence for [language] drop-down list.

Display sequence for language drop-down

Set up an approval sequence

Set up an approval sequence (single language application)

This section describes how to set up an approval sequence for one language. If your application uses multiple languages, see Set up an approval sequence on a multiple languages application.

  1. Open the approval sequence overview from an item's context menu (in the navigation panel or assets panel).
  2. In the first step, type the first letter of the reviewer's name. Select the reviewer from the list of suggestions. You can also add a user group. Groups have a special group icon in the list of suggestions, and you can also see how many users are included in the user group.
    User groups and individual reviewers must have Read and at least one other access rights, such as Create or Change to the item, to review and approve it.

    You should not add large groups. Partly because users think someone else will review if there are many responsible reviewers and partly because many notifications are sent out, which may annoy users. 

    CMS SaaS approval sequence

  3. Add at least one more reviewer to the step if you added an individual reviewer. You should have at least two reviewers in each step in case one of the reviewers cannot review and approve.
  4. Optional: Click Untitled Step to rename the step to something more descriptive, for example, Product marketing or ISO compliance review.
  5. Optional: To add more steps to the approval sequence, click Add. You can rearrange the steps by drag and drop.
  6. Optional: To require a review requester to enter a comment on the review request, select the Require comment when sending for review check box.
  7. Optional: To require a reviewer to enter a reason for approving or declining the content, select the Require comment on Approve or Require comment on Decline (or both).
  8. Optional: Select Prevent users from approving their own changes if the user who sends a review request should not be allowed to approve the changes even if the review requester is one of the appointed reviewers.
  9. Click Save.

Set up an approval sequence for children items

When you have defined an approval sequence for an item, you can define if its children have to be approved or not.

  1. Open the approval sequence overview from a child item's context menu.
  2. Depending on how you want to set up the item's approval sequence, select one of the three radio buttons:
    • Enabled – This setting lets you edit and define the approval sequence any way you want. The approval sequence is not connected to the parent item's approval sequence. Set up the sequence in the same manner as described in the section above.
    • Inherited – This setting locks the approval sequence for the current item, and it gets whatever settings its parent has. If the parent item's approval sequence is changed, so is the approval sequence for the current item.
    • Disabled – This setting deactivates the approval sequence for the item, and it does not have to be approved.
Inherited is set by default, so if you do not define an approval sequence for an item's children, they automatically get the same approval sequence as the parent. If inheritance is set on children and the approval sequence is disabled on the parent item, the children inherit the disabled state. Local assets folders inherit the approval sequence on the associated page or block.

Set up an approval sequence on a multiple languages application

The language setting only applies to Content approvals. Change approvals do not consider this setting; appointed reviewers can approve changes in all languages.
  1. Open the approval sequence overview from an item's context menu.
  2. In the first step, type the first letter of the reviewer's name. Select the reviewer from the list of suggestions. You can also add a user group. Groups have a special group icon in the list of suggestions, and you can also see how many users are included in the user group.
  3. Click the world drop-down and select the languages the reviewer or group of reviewers can approve in the Select Language drop-down list. A reviewer or group of reviewers can approve content in one, several, or all languages.

    Click the world drop-down and select the languages the reviewer or group
    of reviewers can approve

    There is a difference between selecting Any language and selecting all languages individually. If you select Any language, the reviewer can approve an item in any language in which it exists, including any languages you may add. If you select available languages individually, these are the only languages the reviewer can approve content in. If you add a language in the future, the reviewer has no right to approve in that language.
  4. Add at least one more reviewer to the step if you added an individual reviewer. You should have at least two reviewers per language in each step in case one of the reviewers is unable (or not allowed as the review requester) to review and approve.
  5. Optional: Click Untitled Step to rename the step to something more descriptive, such as Product marketing or ISO compliance review.
  6. Optional: To add more steps to the approval sequence, click Add. You can rearrange the steps by drag and drop.
  7. Optional: To require a review requester to enter a comment on the review request, select the Require comment when sending for review check box.
  8. Optional: To require a reviewer to enter a reason for approving or declining the content, select the Require comment on Approve or Require comment on Decline (or both).
  9. Optional: Select Prevent users from approving their own changes if the user who sends a review request should not be allowed to approve the changes even if the review requester is one of the appointed reviewers.
  10. Click Save.

Edit an approval sequence

Open the approval sequence from the content item's context menu and make sure that the Enabled radio button is selected. Edit and save the approval sequence described in Set up an approval sequence. You can rearrange the approval steps by drag and drop. Hover over a group name to see the users included in the group.

If the selected content item has children set as Inherited, they will inherit all changes.

Approve and cancel approval sequences

As an administrator, you can approve the entire approval sequence in one go and cancel a review request. You do that from the Options button. When you approve an entire approval sequence, you must say why you are skipping the approval sequence and approving all steps. As an administrator, you can approve the entire approval sequence even if you sent the review request yourself and Prevent users from approving their own changes is selected.

Approve entire sequence menu option

Delete an approval sequence

You cannot delete an approval sequence, but you can deactivate it. Open the approval sequence from the item's context menu and select Disabled. The item can now be published immediately and does not have to be approved. If the selected content item has children set as Inherited, these children do not have to be approved.

Comment on content approvals

As an administrator, you decide whether review requesters have to add a comment on the review request and if reviewers have to add a reason when they approve or decline content. An exception to this is when you approve an entire sequence, in which case you are required to add a comment. For information on commenting, see the Collaboration between editors.

The comments are visible in the notification list in the user interface and email notifications. 

Comments are stored in the database as part of the change log and can be used later for auditing purposes without using projects.

Two-person approval of content

Certain businesses require at least two persons to approve content or changes to a application before the content is published or changes applied. To achieve this, you must set up an approval sequence with at least two steps and at least two reviewers in each step.

To avoid one of the reviewers in a step happens to be the user who starts the review and thereby can evade the four-eyes principle by approving their changes, you also need to select Prevent users from approving their own changes in the approval sequence.

Use notifications

Appointed reviewers can get notifications in the user interface (the bell icon Notification icon in user interface shows the number of unread notifications) and by email. These notifications let the reviewers know that they have a review request waiting. The editor who started the review request is also notified when the reviewers approve or decline the request.

Which actions trigger a notification?

The list shows which actions generate notifications for the different roles in the content approval workflow.

  • The user who sets the item to Ready for Review receives notification when:
    • A reviewer approves a review request.
    • A reviewer declines a review request.
    • An administrator force approves all steps in an approval sequence.
    • An administrator cancels the review request.
  • A reviewer receives notification when:
    • An item is ready to be reviewed by the user.
    • A review request is declined in the current (the same step as the user was defined in) or later in the approval sequence.
    • A review request is canceled in the approval sequence's current or later step.

Email notifications

A scheduled job run every 30 minutes and gathers notifications into one summary email containing the user's content approval notifications generated since the last email.