--- title: "Import a Process" slug: "import-a-processmaker-platform-process" updated: 2025-09-30T14:52:00Z published: 2025-09-30T14:52:00Z canonical: "docs.processmaker.com/import-a-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. # Import a Process Importing and [exporting](/v1/docs/export-a-bpmn-compliant-processmaker-platform-process) processes and their related assets makes it easy for designers and business analysts to share complete business solutions that can quickly be deployed to production. ### Process Importing Requirements Import Processes that meet the following requirements: - The Process successfully validates as [BPMN 2.0 compliant](https://www.omg.org/spec/BPMN/2.0/About-BPMN/). - The Process was exported from a ProcessMaker Platform version the same or later than the ProcessMaker Platform version importing the Process. - The JSON file exported from the ProcessMaker Platform instance contains relevant assets for that Process. This file may include but not limited to Screens, Scripts, and assets referenced in that Process. This file may be password protected, especially if the exported process contains Environmental Variables and/or Data Connectors, both of which may contain sensitive business information. A password-protected business solution is encrypted. If the JSON file has a password, then you must know that password to import the Process and/or its asset(s) ### Imported Components When a process is imported, the following components are automatically imported as well: - [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 Script configurations - [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. - Process permission(s), such as the Process Manager role - [Process Launchpad configurations](/v1/docs/edit-launchpad-configuration) --- ## Process Import and Commit Behavior When a process is imported into ProcessMaker Platform, the system automatically generates a set of commits in the [Process Version History](/v1/docs/configure-process-version-history). These commits are essential for accurately reconstructing the process in the new environment. ### What to Expect Each import action initiates a sequence of commits that reflect key configuration and compatibility updates. These commits may vary depending on: - The complexity of the imported process - The presence of related or dependent packages - The current features enabled in the target instance ### Examples of System-Generated Commits System actions during import may result in commits such as: - **Launchpad upgrades**: Ensures the latest interface and features are correctly applied to the process UI. - **Asset ID synchronization**: Aligns asset identifiers (e.g., Screens, Scripts, Collections) with the new environment to avoid conflicts. - **Environment compatibility updates**: Adjusts internal references based on available packages or modules. ### Important Notes for Administrators - **Multiple commits are expected.** These are not redundant; they capture distinct operations required for successful import. - **Version History transparency.** The Process Version History allows administrators to track and audit changes made by the system during import. --- ## Import a Process **Permissions** Your user account or group membership must have the following permissions to import a ProcessMaker Platform Process unless your user account has the **Make this user a Super Admin** setting selected: - Processes: Import Processes - Processes: View Processes See the [Processes](/v1/docs/permission-descriptions-for-users-and-groups#processes) permissions or ask your Administrator for assistance. > [!WARNING] > Processes that are not BPMN 2.0 compliant can be [exported](/v1/docs/export-a-bpmn-compliant-processmaker-platform-process) successfully. However, such Processes will not import successfully. Follow these steps to select the Process to import into ProcessMaker Platform: 1. [View your active Processes.](/v1/docs/process-management#view-your-processes) 2. Click the **Import** button. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5c33ef5f-f889-4140-a35c-ec395ce252d1.png) 3. Click the **Select file from computer** link to locate the process to import. Processes have the `.json` file extension. 4. If the process being imported is password-protected, enter the password that was set during export, and click **Import**. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image(359).png) 5. From the **Select Import Type** setting, select one of the following options, and then click **Import**: - **Basic:** Import the complete process and all its assets. - **Custom:** Select which assets to import. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ccb865e9-2f3c-4f2c-aaf3-9f4a142d2419.png) 6. Click **Import**. If the import is basic jump to the section [Import as New or Update Current Assets](/v1/docs/import-a-processmaker-platform-process#import-as-new-or-update-current-assets), otherwise, go to the next step. 7. The **Summary** page provides information about each asset being imported. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e8431fd1-f5a6-4324-97c4-f87ca4af3a54.png) 8. To view details of the the assets being imported, click the **Linked Assets** link. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/db342631-b9f4-4a4f-a159-0fcea929e2e2.png) 9. From the **Summary** page, select the **Import All Process elements** option to import all assets. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/c135deb6-55ac-4e6c-9948-f590bf698d26.png) 10. To import only certain assets, deselect the **Import All Process elements** option and select each asset manually. 11. Click **Import** to begin the import procedure. ### Import as New or Update Current Assets If the process or its assets already exist, follow these steps to choose whether to update the existing items or import them as new. Keep in mind that archived processes also count as existing and must be considered when deciding whether to update or create a new import. 1. If the asssets already exist, the following message will appear. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ac8a552a-0a14-40bf-bcb2-cb6ba115098f.png) 2. Select **Update** to overwrite the existing assets. Use this option with caution—changes apply system-wide. For example, if a screen linked to the imported process is also used in another process, updating it here will also affect that other process. 3. Select **Import as New** to import this Process and its assets with unique IDs. 4. The **Configure Process Details** screen displays. Enter process name, description and select a category. 5. Click the **Import** button to complete the import. --- ### Potential Errors During Process Import A process import may fail or complete only partially due to the following reasons: - The process has a design inconsistency that prevents it from successfully importing. - An existing process already exists with the same name but a different unique identifier. During the importing of such a process in this scenario, designers will be prompted to change the name of the process being imported to prevent this conflict. - When importing a process from an older version of ProcessMaker Platform, only basic import is available. Advanced options, such as selecting specific assets, are disabled, and all assets are imported automatically ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/7d0d1ca5-5990-4a48-97d7-da9ba994e1f1.png) > [!NOTE] > Note: > > Processes created in ProcessMaker versions earlier than 4.x cannot be imported into the current Platform. --- ### Import Logs After a process import, the system generates logs that capture details about the import activity. These logs help track what occurred during the import and provide useful information for reviewing outcomes or troubleshooting issues. The logs may include: - Details of the imported assets - Date and time of the import - The user who performed the import - Error messages if the import was unsuccessful