Region Definitions

Each region definition contains a list of associated element definitions. This list of definitions is the complete list of elements available to use in the layout of the region template, after the region template and region definition are associated.

A region template is not required to use all elements available in a region definition. Usually, not all elements are used to display in the region template. However, after Contributor is launched, all elements displays in the editor, whether or not they are displayed in the associated region template.

The association between a region template and a region definition is stored in the xRegionDefinition metadata for the region template.

Associating an element definition with a region definition

The region definitions list the element definitions available to use with the region template. Adding an element definition to, or removing an element definition from, a region definition is a very simple task.

To associate an element definition with a region definition, follow these steps:

1. Open the region definition from the Site Assets pane.

   The Region Definition dialog (see Region Definition Dialog) appears.

2. Click Add.

   The Element Dialog (see Element Dialog) appears.

3. Enter the information for the element (using a good naming convention to easily recognize the element definition as it is used), select the element definition from the menu, and click OK.

4. The element definition is now associated with the region definition.

It is also possible to embed the element definition in the region definition. When you embed the element definition, you are creating a singular instance of the named element definition within the region definition, which is not affected by global changes in the way that including the element definition by reference would.

To embed an element definition in a region definition, add it as you would normally, but on the Element Dialog (see Element Dialog), check the Embed the element definition inside the region definition check box.

To remove an element definition from a region definition, follow these steps:

1. Open the region definition from the Site Assets pane.

   The Region Definition dialog (see Region Definition Dialog) appears.

2. Select an element definition. Click Remove.

3. The element definition is now removed from the region definition.