Determining if you are using the correct container variable


Determining if you are using the correct container variable to avoid:

Release or Environment

All versions


To configure container variables, navigate to the Variables related list on the Catalog Item form.

This example shows an item with four variables and no containers:

If no containers are defined, the item view shows them rendered top to bottom, in increasing order:

To control the layout to use anything other than the top-to-bottom linear format, container records are needed.

Using containers

There are several methods for using containers to control layout.

Method 1: Use the <Container Start> - <Container Split> - <Container End> Formation

In this formation, variables appear in the first column, ordered from top to bottom until the split appears. After the split, the variables appear in the second column, ordered from top to bottom in that column.

For example, if you set up your containers as follows:

The item appears as follows:

Having multiple splits within the same start-end formation does not make any impact. Only the first split is recognized.

To have multiple splits, set up a second start-split-end formation nested inside the first. For example:

This helps you create three columns:

It is not necessary to set up containers right at the top of the variables. Any variable outside the containers is rendered using the full width across the two columns. For example:

Renders as: 

Method 2: Use the <Container Start> - <Container End> that is using '2 column wide, alternating sides' formation 

To set this up, open the Container Start record, then in the Type Specification tab, set the Layout field to 2 columns wide, alternating sides.

There is no need for a split, as each variable is rendered on alternative sides. The first variable is on the left side, then the next is on the right-hand side, the next is left, and so on. For example:

Renders as:

Using an odd number of variables means the left-hand side has one more.

Method 3: Use the <Container Start> - <Container End> that is using '2 column wide, one side, then the other' formation 

To set this up, open the Container Start record, then in the Type Specification tab, set the Layout field to 2 columns wide, one side, then the other.

Similar to the last formation, this type of formation does not need a <container split> because the split is done evenly halfway through. If there is an odd number of variables to render, then the right-hand side renders one more variable.

For example:

Renders as: 

Containers and variable sets

The previous descriptions assume that there are no variable sets being used. However, variable sets can also contain containers. Variable set containers offer the flexibility of defining layouts using two mechanisms:

  1. The same standard three formations as for variables. 
  2. Specifying the layout on the variable set itself, without using containers at all (also see Defining Variable Set Layout).

Ensure that you specify an order both on the variable set and also on its variables to get the desired layout.

The ordering fields left empty have an impact on the layout. To fully understand the impact, see Defining Variable Set Order.

Additional Information

Possible container pitfalls are: