Configure multistep form metadata for Power Pages

Article
01/09/2025

Multistep form metadata adds behavior modification logic to enhance or override form field functionality beyond native basic form editing capabilities.

Add a new record

On the Multistep form step with fields to modify, go to Related > Metadata
Select New Multistep Form Metadata.

Multistep form metadata properties

The following attributes provide additional styling and capabilities for elements on a form.

Name	Description
Multistep form step	The multistep form step associated with the multistep form metadata record.
Type	Options: Attribute Section Tab Selecting Attribute displays options for modifying fields on the current form. Selecting Section displays options for modifying a section on the form. Selecting Tab displays options for modifying a tab on the form.

Multistep form metadata type = Attribute

The following properties are displayed when the Type selected is Attribute.

Name	Description
Attribute Logical Name	The logical name of the attribute field to modify.

Note: Columns of type choices don't appear in the drop-down list of columns. Enter the logical name of the choices column directly in the Attribute Logical Name text box. | | Label | Replaces the default label assigned to the attribute on the table with the specified text. For each installed and enabled language pack in the Microsoft Dataverse environment, a field is available to enter the message in the associated language. |

Control style

These options modify the style and functionality of an attribute's field.

Name	Description
Style	Options: Option Set as Vertical Radio Button List Option Set as Horizontal Radio Button List Single Line of Text as Geolocation Lookup Validator (requires Bing Maps Settings - details found here) Group Whole Number as Constant Sum (requires Group Name) Group Whole Number as Rank Order Scale No Ties (requires Group Name) Group Whole Number as Rank Order Scale Allow Ties (requires Group Name) Multiple Choice Matrix (requires Group Name) Multiple Choice (requires Group Name) Group Whole Number as Stack Rank (requires Group Name) Code component Render Lookup as Dropdown
Group Name	A name used to group controls together as a composite control.
Multiple Choice Minimum Required Selected Count	The required minimum values selected in the multiple choice question. Only necessary if 'Multiple Choice' Control Style is selected.
Multiple Choice Max Selected Count	The maximum number of values permitted to be selected in the multiple choice question. Only necessary if 'Multiple Choice' Control Style is selected.
Constant Sum Minimum Total	The required minimum value applied to a constant sum response field. Only necessary if 'Group Whole Number as Constant Sum' Control Style is selected.
Constant Sum Maximum Total	The maximum number of values permitted to be applied to a constant sum response field. Only necessary if 'Group Whole Number as Constant Sum' Control Style is selected.
Randomize Option Set Values	Specifying Yes results in randomly ordered options listed for an Option Set control. Only applicable to attributes that are of type Option Set.
CSS Class	Adds a custom CSS class name to the control.

Prepopulate field

The following options provide a default value for fields on the form.

Name	Description
Ignore Default Value	Ignores the default value of the specified attribute field. Useful for attributes that are Two Option fields that are rendered as Yes and No radio buttons. Because a value of yes or no is automatically assigned by default, this option makes it possible to display Yes/No questions without a predefined response.
Type	Options: Value Today's Date Current User's Contact Selecting Value requires a value to be specified in the Value field that is assigned to the field when the form is loaded. Selecting Today's Date assigns the current date and time to the attribute field. Selecting Current User's Contact requires a From Attribute that is an attribute on the contact table that is retrieved from the current user's contact record and set on the attribute field specified.
Value	A value assigned to the field when the form is loaded.
From Attribute	An attribute on the contact table that is retrieved from the current website user's record and assigned to the field when the form is loaded.

Set Value On Save

The following options specify a value to be set when the form is saved.

Name	Description
Set Value On Save	Yes indicates that a value should be assigned to the attribute using the input provided in the Value field. Note: All attribute types are supported except the following types: Unique Identifier.
Type	Options: Value Today's Date Current User's Contact Selecting Value requires a value to be specified in the Value field that is assigned to the field when the form is loaded. Selecting Today's Date assigns the current date and time to the attribute field. Selecting Current User's Contact requires a From Attribute that is an attribute on the contact table that is retrieved from the current user's contact record and set on the attribute field specified.
Value	Value assigned to the attribute when the form is being saved. For Two Option (Boolean) fields use true or false. For Option Set field use the integer value for the option. For Lookup (TableReference) fields, use the GUID. Note: If the attribute is also on the form, the user's value is overwritten with this value.
From Attribute	An attribute on the contact table that is retrieved from the current website user's record and assigned to the field during save.

Lookup Settings

The lookup setting Basic form for Create is used to populate the Basic Form for creating a new record from the lookup when the metadata created for an attribute is of lookup type.

Validation

The following section contains properties that modify various validation parameters and error messages.

For each language pack installed and enabled for the Dataverse environment, a field is available to enter the message in the associated language.

Name	Description
Validation Error Message	Overrides the default validation error message for the field.
Regular Expression	A regular expression to be added to validate the field.
Regular Expression Validation Error Message	The validation error message to display if the regular expression validated fails.
Field is Required	Check to make the attribute field required to contain a value.
Required Field Validation Error Message	Overrides the default required field error message if the field doesn't contain a value.
Range Validation Error Message	Overrides the default range validation error message if the field's value is outside the specified minimum and maximum values for Whole Number, Decimal Number, Floating Point Number, or Currency types.
Geolocation Validator Error Message	If the attribute is a single line of text and the control style is specified as Geolocation Lookup Validator, this overrides the default error message displayed if input validation fails.
Constant Sum Validation Error Message	If the attribute is a whole number type and the control style is Group Whole Number as Constant Sum, this overrides the default error message displayed if input validation fails.
Multiple Choice Validation Error Message	If the attribute is a Two Option type and the Control Style is Multiple Choice, this overrides the default error message displayed if input validation fails.
Rank Order No Ties Validation Error Message	If the attribute is a whole number type and the control style is Group Whole Number as Rank Order No Ties, this overrides the default error message displayed if input validation fails.

Description and instructions

The following properties specify the location and content of custom description or instructions.

Name	Description
Add Description	Yes results in custom text being displayed on the form in the position specified.
Position	Options: Above the field Below the field Above the label
Use Attribute's Description Property	Select 'Yes' to use the description assigned to the attribute metadata on the table. Select 'No' to provide a custom description. Default is 'No'.
Description	Custom text to be displayed on the form. Used in conjunction when Use Attribute's Description Property is set to 'No'. For each language pack installed and enabled for the Dataverse environment, a field is available to enter the message in the associated language.

Multistep form metadata type = Section

The following properties are displayed when the Type selected equals 'Section'.

Name	Description
Section Name	The name of the section on the table's form to be modified.
Label	Replaces the default label assigned to the section on the table with the specified text. For each installed and enabled language pack in the Dataverse environment, a field is available to enter the message in the associated language.

Multistep Form metadata type = Tab

The following properties are displayed when the Type selected equals 'Tab'

Name	Description
Tab Name	The name of the tab on the table's form to be modified.
Label	Replaces the default label assigned to the tab on the table with the specified text. For each installed and enabled language pack in the Dataverse environment, a field is available to enter the message in the associated language.

Share via