Access and manage the section properties of a form

This topic applies to Dynamics 365 Customer Engagement (on-premises). For the Power Apps version of this topic, see: Add, configure, move, or delete sections on a form

A section in a form occupies the space available in a tab column. Sections have a label that can be displayed and a line may be shown below the label.

Sections can have up to 4 columns and includes options for displaying how labels for fields in the section are displayed.

Headers and footers are similar to sections but cannot be removed. If they don’t contain anything they will not be shown.

You can access Section properties in solution explorer. Under Components, expand Entities, expand the entity you want, and then select Forms. In the list of forms, open the form of type Main. Then double-click inside one of the sections to see the Section Properties page.

Section properties dialog box.

Tab Property Description
Display Name Required: The unique name for the section that is used when referencing it in scripts. The name can contain only alphanumeric characters and underscores.
Label Required: The localizable label for the section visible to users.
Show the label of this section on the form Sections are frequently used without labels to control formatting of the fields within them.
Show a line at top of the section A line at the top of a section can help break up the form layout.
Field Label Width Required: Set a value between 50 and 250 to specify the space allowed for field labels.

Header and footer elements also have this property.
Visibility Showing the section is optional and can be controlled using scripts. More information: Visibility options
Availability Choose if you want the tab to be available on the phone.
Lock the section on the form This will prevent the section from accidentally being removed and prevents people from removing the contents.

Removing a section will not only remove the section, but also any fields within it.

Someone wanting to remove this section would need to change this setting before removing it.

Header and footer components also have this property.
Layout Specify up to four columns to be in the section.
Field Label Alignment Labels for fields within the section can be aligned left, right, or center.
Field Label Position Labels for fields within the section can be positions on the side or on top of the fields.

A new type of section called Reference Panel can also be added. A reference panel is a single column section. You can insert sub-grids, quick view control, or a knowledge base search control inside a reference panel section. Each control that you added in the reference panel appears as a vertical tab within the panel at runtime. You can drag and drop the various controls within the reference panel section. The default tab at the runtime is the first control added in the reference panel. The other tabs appear in the order in which they are added in the form editor. To delete a tab, use the delete key on your keyboard.

When you insert a reference panel, by default it’s added as a last section in the tab. You can add only one reference panel per form.


By default, the reference panel section is locked in the out-of-the-box forms: Cases, Accounts, and Contacts. To remove it or change it, you must unlock it.

See also

Use the Main form and its components