--- title: "Export a Process" slug: "export-a-bpmn-compliant-processmaker-platform-process" updated: 2025-09-25T19:04:12Z published: 2025-09-25T19:04:12Z canonical: "docs.processmaker.com/export-a-bpmn-compliant-processmaker-platform-process" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # Export a Process You can export processes and their related assets from your instance in a BPMN 2.0–compliant format. By exporting a Process with its related assets, the complete business solution can quickly be shared with other ProcessMaker Platform instances. Processes are exported as JSON files and can be imported into the same or later versions of the platform. ### Exported Components When a process is exported, the following components are exported with it: - [Process model elements](/v1/docs/process-modeling-object-descriptions) - [Scripts](/designer-advanced/what-is-a-script) configured for [Script Task elements](/v1/docs/script-task) as well as their configurations and Script Executors - [Screens](/v1/docs/screens) configured for [Form Task](/v1/docs/form-task) and [Manual Task](/v1/docs/manual-task) elements in both their original and translated natural languages - [Environment Variables](/v1/docs/environment-variables) - The **Assignment Rules** configured for **Form Task** and **Manual Task** elements. However, **user accounts are not imported** as part of the process package. To ensure that assignment rules are displayed and function correctly, make sure to manually create the corresponding user accounts and group associations in the new environment. - The complete business solution - Process permission(s), such as the Process Manager role - [Process Launchpad configuration](/v1/docs/edit-launchpad-configuration) An exported Process, along with its related assets, exports as one file with the `.json` extension. ### Considerations When Exporting a Process Keep the following in mind when exporting a business solution: - Ensure the process validates as [BPMN 2.0 compliant](https://www.omg.org/spec/BPMN/2.0/About-BPMN/) before exporting. - Exported processes can be imported into the same or later version of the platform. - The exported JSON file includes the process and related assets (e.g., screens, scripts). If it contains environmental variables or data connectors, the file is password-protected and encrypted. The password is required to import it. - ProcessMaker exports the **most recent published version** of a process. If changes exist only in draft mode and have not been published, **those changes will not be included** in the exported file. As a best practice, always **publish your process** before exporting to ensure that the latest configuration is included. - A process must have **at least one published version** to be eligible for export. --- ## Export a Process **Permissions** Your user account or group membership must have the following permissions to export a Process unless your user account has the **Make this user a Super Admin** setting selected: - Processes: Export Processes - Processes: View Processes See the [Processes](/v1/docs/permission-descriptions-for-users-and-groups#processes) permissions or ask your Administrator for assistance. > Ensure the following prior to exporting a Process: > > - The Process must be complete and validates as [BPMN 2.0 compliant](https://www.omg.org/spec/BPMN/2.0/About-BPMN/). > - The Process, and its related assets, functions properly as intended. > [!WARNING] > Processes that are not BPMN 2.0 compliant can be exported successfully. However, such Processes will not [import](/v1/docs/import-a-processmaker-platform-process) successfully. Therefore, validate that your Process is BPMN 2.0 compliant before exporting it. See [Validate Your Process is BPMN 2.0 Compliant](/v1/docs/validate-your-process-is-bpmn-20-compliant). Follow these steps to select the Process to export from your ProcessMaker Platform: 1. [View your Processes](/v1/docs/view-edit-and-search-for-processes). 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Ellipsis Icon.png) menu, and then select the **Export** option. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Export Process Window.png) 3. From the **Select Export Type** setting, select one of the following options, and click **Export**: - **Basic:** Export the process along with all its associated assets. If the export contains sensitive information, it’s recommended to [set a password to protect the file](/v1/docs/export-a-bpmn-compliant-processmaker-platform-process#set-a-password-for-export). - **Custom:** Select the assets to export. 4. If selected custom operation, the **Summary** page for the exporting Process displays. The **Summary** page provides detailed information about each asset associated with the exporting Process. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/781705ee-09e3-4aa3-8ce9-d574d3cd0727.png) 5. Click the **Linked Assets** link to view details of all assets. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/b97d4b31-c193-44fa-8251-c1119d30361d.png) 6. From the **Summary** page, select the **Export All Process elements** option to export all assets. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5ba29469-2bd8-47fb-91dd-d1ce3b62fb39.png) 7. Deselect the **Export All Process elements** option to select only some assets for the export. 8. Click the **Export** button to begin the export procedure. ### Set a Password for Export When exporting a process and its related assets, you can set a password to encrypt the JSON file. A password is **required** if the export includes any of the following: - [**Environmental Variables**](/v1/docs/environment-variables) – may contain sensitive business data. - [**Data Connectors**](/v1/docs/data-connectors) – may include API tokens, access credentials, or bearer tokens that grant access to external data sources. If these asset types are not part of the export, setting a password is optional. Follow these steps to set the password for an exported process: 1. After you have selected the assets to be exported, the **Set Password** screen displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e2f2c495-dcaf-4dc0-b966-45efd4b32443.png) 2. In the **Password** setting, enter a password that is at least eight (8) characters long. [Password special characters](https://www.owasp.org/index.php/Password_special_characters) are recommended. 3. In the **Verify Password** setting, re-enter the password to confirm it. 4. Click the **Export** button. 5. The **Process Export Successful** screen displays with a list of the exported selected asset(s) for Process. The `JSON` file is named after the Process. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/cb5db1f0-f0ce-4fda-b93a-97f9550508a1.png) 6. Click the **Close** button.