Create a model to represent your application’s business processes. After creating the model, you choose paths in the model to test based on your testing strategy.

Create a model

You can create a model using units you have already defined, or using placeholders that you later replace with units. You can also include a model as a sub-model, inside a larger model.

Tip: You can also import a BPMN file to inject its model into MBT. For details, see BPMN integration.

To create a model:

  1. Select a folder in the left pane, or create a new folder. This structure enables you to organize your MBT models in a way that is meaningful to you.

  2. In the Models tab, click + Model.

  3. Enter the model's name, and fill any other fields that are relevant.

    Note: For details on working with options in the form such as auto-fill, attachments, or custom fields, see Common functionality.

  4. Click a model ID's to open it for editing.

    Build a model using the components in the left pane, and the toolbar in the model editor pane, as described in the following steps.

  5. From the left pane, drag and drop units or models on to the model diagram.

    Use the filter and search buttons at the top of the left pane to locate components.

    Note: When you open a model in the model editor, the units included in the Components pane are filtered by default. Unless you modify this filter, you will only see units that are directly related to the model’s branch in the hierarchy, and not all of the units in the workspace.

    If you modify this filter, your new settings will override the default branch filter until the filter is completely cleared.

  6. Drag and drop elements from the toolbar:

    Tool Description


    Temporary element to reserve a space for another component.

    Drag and drop a placeholder in the model diagram. Later, you can drop an element from the Components area on to the placeholder to replace it. Alternatively, select a unit from the placeholder's context menu.

    This can be useful if you want to first build a theoretical model, and then create corresponding units.

    New unit

    Drag and drop to the diagram to create a new unit. For details, see Model units.

    The unit is then added to the Components area.


    Add a note to the diagram.

    • You can drop a comment element in an empty space to create a general note in the model. This is not connected to a specific element in the diagram.

    • You can also drop a comment on to a specific unit or model in the diagram. In this case a comment icon appears on the element, and you can hide or show the comment. If you move the element, its comment moves with it.


    A gateway can have multiple inputs and outputs, and is used to build optional process flows.

    End point

    A model can have a single or multiple end points.

    Note: To add an endpoint to a sub-model, you need to open the sub-model for editing. You cannot drag an end point into a sub-model when it is in the context of the model.

  7. Nested models: You can nest a model inside a model. In this case you can expand the sub-model to see its contents, but they are read-only. To edit it, open the sub-model from the left pane.

    You can also nest a sub-model inside another sub-model, but you cannot expand the nested sub-model.

  8. Within a model diagram, you can use the following actions:

    • Zoom in or out of the diagram using the controls at the lower left corner.

    • Activate Pan or Selection mode using the toolbar buttons.

    • Undo or redo actions using the arrows on the toolbar.

    • Copy, Cut, or Delete elements using their right-click menu commands.

      The Start element is permanent and cannot be removed or copied.

    • If you select multiple items, you can use the Bulk Update menu command to update their shared properties.

  9. After placing tools and components on the diagram, click and drag from the edge of one element to another to connect them.

  10. Use the buttons at the top of the diagram to Save changes, Discard changes, or Refresh the model using the last-saved display.

    Use the Grid option to apply a grid to the model for visual purposes.

    Click Apply layout to automatically organize the model in an structured display.

After saving a model, you can select it in the Models tab and view its diagram in the right pane.

To generate a .jpg image of your model that can easily be shared, select the Export to Picture menu command.

Back to top

Add relations to a model

You can create requirements and features, and then link models to those entities. This can help ensure that new features or requirements are properly covered in testing.

Relations are automatically created between models or units and their tests.

To add relations to a model:

  1. Create requirements or features using the Requirements module. For details, see Requirements.

  2. In the Models tab, open a model.

  3. In the Relations tab, create relations between the model and its related requirements or features. For details, see Connected items.

    Relations between models or units and a test are created automatically when you generate the test. In addition, if you add a sub-model or unit to a model with related tests, the tests are automatically related to the new unit or sub-model.

    Example: In this example, the model "Card selection" is a sub-model in the "New bank customer" model. It is covered by two tests, and it is related to one feature and one requirement.

    You can open each of the related entities using its link.

Back to top

Modify a model's details and phases

You can add the following details to your model:

  • In the Details tab you can define further information such as adding tags to a model, assigning a model to your My Work area, or work with custom fields. For details on using these options, see Common functionality.

  • In the upper right corner of the screen, set the Model's Phase. MBT uses phases to represent the current state of an item. As you work on items, advance them from phase to phase. When you set a model's phase to Ready, the icon representing the model changes color from gray to blue. For details, see Phases.

Back to top

Export and import a model across workspaces

You can export one or more models from a workspace, and import them to another workspace.

Before importing, we recommend that you configure an MBT runner in the new workspace that is associated with the Git repository you want to work with. If you do not configure a runner before importing, you will need to manually update the relation of each of the units in the new workspace with the Git repository.

To export a model:

  1. In the Models tab, select one or more models for export.

  2. In the More menu, select Export to JSON and save the export file.

To import a model:

  1. In the target workspace, open the Settings menu and select Import > Model Items.

  2. Select JSON and browse to the saved file.

    Note: If you want to run tests automatically, you must have an MBT runner configured in the workspace that is associated with the Git repository.

  3. Click Import.

    The model is imported to the new workspace.

Back to top

See also: