> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/models.md). # Models Workflow Designer uses models to refer to the different building blocks of a workflow: | Model | Description | | ------- | --------------------------------------------------------------------------------------------- | | Process | A business process diagram that uses the Business Process Model and Notation (BPMN) standard. | | Form | A form presenting or requesting information that a workflow users interacts with. | ## Find and view models Every workspace and app has a **Models** page where you can see the models associated with the workspace or the app, with various options to help you efficiently locate and view your workflow models: * Filter by name: Enter part or all of a model name to narrow down the list of models. * View options: Click Sliders icon **View options** to open the controls for changing how models are shown: * View: Select **List view** or **Grid view** to change the layout. * Sort: Choose to sort by **Name** or **Key**, and in **Ascending** or **Descending** order. * Filter by tags: Filter models by one or more tags. ## Add models The Add icon **Create** button on the **Models** page of a workspace or app allows you to: * Create new workflow models from scratch by defining their basic properties. * Import existing workflow definitions from BPMN or XML files or forms from FORM files. * Include models from other workflows or other workspaces into your current app, allowing for reuse and consolidation of forms and processes. You can also create a form or process from the **Actions** section of the search bar. ## Manage models After you added models, you can manage them by modifying their properties, downloading definitions, tracking their usage, starring them for quick access, or removing them when they are no longer needed. 1. On the **Models** page of a workspace or an app, locate the desired model. 2. Click the More icon more icon next to it.\ :chevrons-right: A drop-down menu appears with available actions: | Action | Description | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Edit | Opens the model in the process form designer for modifications, in the **Editing** page. | | Download | Downloads the model file to your local machine. This is useful for backup, version control, or sharing outside of the Workflow Designer. | | Properties |

Opens a dialog box where you can view and edit the model metadata, including the name, key, tags, and description.

You must open the model in an app to modify the model key.

| | Usage | Shows a list of other processes, forms, or apps where the selected model is currently being used. This is a critical feature for understanding dependencies before making changes or removing a model. | | Star model | Marks the model as a favorite, making it easier to visually find it. | | Remove |

Deletes the model permanently from the Workflow Designer.

Removing a model is a permanent action. If the model is referenced or used in any other processes, form, or application, the removal causes errors or breaks functionality in those dependent items. Always check the usage of a model before removing it.

| ## Model versions Whenever you save a process or a form, Workflow Designer automatically creates a new version of the form. This helps you track the evolution of your workflow models throughout their development, compare different versions, and revert to a previous version if necessary. Model versions are different from [app revisions](/workflows/designing-workflows/apps/app-revisions.md), which are manual workflow app at a specific point in time with the included models and model versions. ### Manage versions You can view, compare and restore a previous version of a process or form from the model **Editing** page by clicking Version explorer icon the version explorer icon: * View: Select a past model version.\ :chevrons-right: A preview of the selected version appears. * Compare: 1. Click the **Compare with version** button. 2. Select any two versions to visually compare.\ :chevrons-right: Differences are highlighted in green for added elements, yellow for modified elements, and red for deleted elements. * Restore a previous version: * Click the **Revert to this version** button. * In the **Revert this model** dialog box, click **Accept** to confirm the change and close the version explorer.\ :chevrons-right: A new version of the model is created based on the selected past version. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.collibra.com/workflows/designing-workflows/models.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.