Control the Sections Displayed on the Page

You can change the sections in a container directly in the Properties pane, or use the container's rules editor if you want to use conditions to define which sections are displayed.

If you don't need to define any rules or conditions in your container, you can modify the container's built-in rule directly in the Properties pane, to add, remove, and change the order of sections. This means that the sections listed under Displayed Sections in the Properties pane are always displayed. You can modify the container in the Properties pane if you see sections with handles listed under Displayed Sections in the Properties pane:

Description of the illustration metadata-container-properties-handle.png

If you see All Sections instead of Displayed Sections in the Properties pane, this means the container already uses some rules in addition to the built-in rule, and you need to define the container's sections in the rules editor.

To change the sections displayed in a container:

1. Locate the container in the Properties pane.

   The Properties pane lists all the sections that you can display in the container under Available Sections. These sections are usually defined in dependencies, but also includes sections defined in your extension.

2. Define the container's sections without creating rules and conditions:
   If the container already uses rules, skip to step 3 below to define the sections using the rules editor.
   1. Add a section by hovering over the section in the list of available sections and clicking .
      
      

      
      Description of the illustration metadata-container-properties-add.png

      
      

      The section is added to Displayed Sections.

   2. Re-order the sections under Displayed Sections by grabbing a section's handle and moving it into the position you want.
      
      

      
      Description of the illustration metadata-container-properties-move.png

      
      
   3. Remove a section from Displayed Sections by hovering over the section and clicking.
3. Define a container's sections using rules and conditions:
   1. In the Properties pane, click to create a rule, or Rules Editor to open the editor.

      The rules editor displays a list of rules for determining the sections displayed in the container. Rules listed under Built-in Rules are defined in the extension dependency, and you cannot edit them.

      When you create a rule, it is added to the list of Extension Rules:

      
      

      
      Description of the illustration metadata-container-ruleeditor.png

      
      

      To duplicate a rule, right-click the rule in the list and select Duplicate in the popup options menu.

      To delete a rule, right-click the rule and select Delete in the options menu.

   2. Change the order your extension rules are listed by selecting the rule, and then dragging it into the position you want.

      Rules are evaluated in order, from the top down. If a rule's conditions are met, the rule is applied, and none of the rules below it are evaluated. When you create a rule, it is added to the top of the Extension Rules list, so you need to make sure your rules are in the correct position.

   3. Define the rule's conditions in the condition builder by selecting the rule, and then clicking Edit.

      The condition builder is the same one used to create conditions in business rules. If you're not familiar with using the condition builder, see Set Conditions for a Rule.

   4. Choose the sections you want displayed in the container when the rule's conditions are met.
      • To add a section to the list of displayed sections, click the section's button in the list of Available Sections.
      • To remove a section, click .

      To change the order the sections appear in the container, grab the section's handle next to the section name and move it into position.

4. Create new sections in the container.

   You can create sections if a 'template' for new sections is defined for the page in the dependency. New sections are based on this template. You can't create sections if no template is defined.

   1. Click + Section.
      
      

      
      Description of the illustration metadata-container-addsection.png

      
      

      When you create a section, it is added to the list of Available Sections in the rules editor, and to the All Sections list in the Properties pane.

   2. Click the new section in the All Sections list in the Properties pane.
   3. In the Properties pane, edit the section's name, description, and properties.

      To edit the section name, hover over the name and click :

      
      

      
      Description of the illustration metadata-container-editsection.png

      
      

      Sections might have other editable properties. These properties are based on the template used for creating sections in the container.

      You can delete a section you created by opening the section's details pane in the Properties pane, and then selecting Delete Section in the options menu.

      
      

      
      Description of the illustration metadata-container-deletesection.png

      
      
   4. Click Back.
5. Close the rules editor.