Wizard form pattern


Dynamics 365 for Finance and Operations has evolved into purpose-built applications to help you manage specific business functions. For more information about these changes, see Dynamics 365 Licensing Guide.

This article provides information about the Wizard form pattern. A wizard is a special form of user assistance that takes the user through a task by using an ordered series of tab pages.


A wizard is a special form of user assistance that takes the user through a task by using an ordered series of tab pages. Wizards are especially useful for complex or infrequent tasks that the user might have difficulty learning or doing, or for tedious, frequently performed tasks.


Wireframe for Wizard form

Pattern changes

Here are the main changes to this pattern since Microsoft Dynamics AX 2012:

  • The secondary instruction for a wizard step was previously defined in the Help Text property of that step’s Tab Page. This instruction will now be modeled on the Tab Page as a Static Text control.


High-level structure

  • Design (Style=Wizard; Caption=<wizard title>)

    • WizardContent (Tab)

      • WizardContentPage (TabPage) [repeats 1..N times, can be named anything; Caption set to page title]

        • MainInstruction (StaticText)
        • Body (Group)

Core components

  1. Apply the Wizard pattern on Form.Design.
  2. Address BP Warnings:
    1. Design.Caption isn't empty.
    2. The form must be referenced by at least one menu item.
    3. TabPage.Caption isn't empty (for all wizard content pages).
    4. MainInstruction.Text isn't empty (for all wizard content pages).

Commonly used subpatterns

UX guidelines

The verification checklist shows the steps for manually verifying that the form complies with UX guidelines. This checklist doesn't include any guidelines that will be enforced automatically through the development environment. Open the form in the browser, and walk through these steps.

Standard form guidelines:

Wizard guidelines:

  • Each tab page should have a title.
  • Each tab page should have a main instruction.
  • Content should be subdivided into logical groups per page.
  • A wizard should have <Next> and <Previous> buttons on the appropriate pages.
  • The user should also be able to cancel the wizard, and cancellation should return to the state that existed before the wizard was started.
  • Only one question should be asked per wizard page (tab page).
  • When a set of choices is presented to the user, radio buttons should be used to make the alternatives clear, even if a check box or combo box is otherwise acceptable.
  • Wizard forms must not have these elements:
    • FactBoxes
    • FastTabs


Form: WrkCtrBulkResReqEditWizard

Wizard example


Frequently asked questions

This section will have answers to frequently asked questions that are related to this guideline/pattern.

Open issues

  • None

AX 2012 content

AX 2012 example

Previous version example