The Insert Options pipeline

Abstract

Overview of the Insert Options pipeline.

The Insert Options pipeline contains processors to define effective insert options. The /configuration/sitecore/pipelines/uiGetMasters element in the web.config file defines the Insert Options pipeline.

Note

Because the use of aliases results in multiple URLs for a single content item, which can confuse search engines, ensure you use aliases consistently.

The default Insert Options pipeline consists of the following three processors that manipulate the list of effective insert options:

  • Sitecore.Pipelines.GetMasters.GetItemMasters - populates the list with insert options assigned to the item or its data template’s standard values.

  • Sitecore.Pipelines.GetMasters.GetInsertRules - invokes insert rules defined in insert options assigned to the item or its data template’s standard values.

  • Sitecore.Pipelines.GetMasters.CheckSecurity - removes insert options that the context user does not have access rights to use.

For examples of how to use the Insert options pipeline, see Example: Code for the Insert Options pipeline processor to allow folders anywhere and Example: Code to limit the number of child items under any item.

Note

You can manipulate effective insert options for all items using processors in the Insert Options pipeline.