--- title: "Import a Process Template" slug: "import-a-process-template" updated: 2024-08-12T13:59:03Z published: 2024-08-12T13:59:03Z canonical: "docs.processmaker.com/import-a-process-template" --- > ## 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 Template Download a Process Template from ProcessMaker Template Gallery, Import, and then configure that Template for your ProcessMaker Platform instance. ## Overview [ProcessMaker Template Gallery](https://www.processmaker.com/resources/customer-success/templates/) provides ready-to-use [Process Templates](/v1/docs/process-templates#what-is-a-process-template) to customize and publish your next business solution. Refer to the following sections to use Process Templates from ProcessMaker Template Gallery: - [Download a Process Template from ProcessMaker Template Gallery](/v1/docs/import-a-process-template#download-templates-from-processmaker-template-gallery) - [Import the Process Template](/v1/docs/import-a-process-template#import-a-process-template) - [Configure a Process Template for your ProcessMaker Platform instance](/v1/docs/import-a-process-template#configure-a-process-template-for-your-processmaker-platform-instance) ## Download a Template from ProcessMaker Template Gallery Follow these steps to download a ready-to-use Process Template from ProcessMaker Template Gallery to import it into your ProcessMaker Platform instance: 1. Access [ProcessMaker Template Gallery](https://www.processmaker.com/resources/customer-success/templates/) to view a list of available Templates. A list of Templates with a brief description for each displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/362171cb-f2f8-4bca-9d7a-f677fe33cf78.png)ProcessMaker Template Gallery from which to download Process Templates 2. Click on a Process Template's tile to view a description that Template. Details of the Template display. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/438aa0f5-55af-4ce1-8521-4daa345b14c0.png)Viewing a Process Template from ProcessMaker Template Gallery 3. Click on the **Template** link below the Process Template's name to download that Template. If this is the first time downloading a Process Template, or your Web browser's cookies have expired from ProcessMaker's web site, do the following. Otherwise, continue to step 4. 1. The **Get Access** screen displays. Enter your contact information, and then consent to the [ProcessMaker Privacy Statement](https://www.processmaker.com/privacy-policy/). 2. Click the **Access Resources** button to download the Process Template. 4. A ZIP file contains the Process Template. Select the location where to save the ZIP file. 5. Extract the contents of the ZIP file. The Process Template is a JSON file. ProcessMaker Platform files are in JSON format. 6. [Import the Process Template](/v1/docs/import-a-process-template#import-a-process-template) into your ProcessMaker Platform instance. ## Import a Process Template **Permissions** Your user account or group membership must have the following permissions to import a Process Template unless your user account has the **Make this user a Super Admin** setting selected: - Process Templates: View Process Templates - Process Templates: Import Processes Templates See the [Process Templates](/v1/docs/permission-descriptions-for-users-and-groups#process-templates) permissions or ask your Administrator for assistance. > ### Want to Import Process Templates? > > [Download Process Templates from ProcessMaker](https://www.processmaker.com/resources/customer-success/templates/) to expedite the time to design your next business solution. Follow these steps to import a Process Template: 1. [Ensure you have downloaded the Process Template from ProcessMaker Template Gallery in which to import](/v1/docs/import-a-process-template#download-process-templates-from-processmaker-template-gallery) or otherwise acquired the Template to import. 2. [View all Process Templates](/v1/docs/process-templates#view-process-templates). The **Templates** tab displays. 3. Click the **Import** button. The **Import Process Template** page displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/0012c4fc-3205-4a00-9f69-9af9579c04f8.png)Import Process Template page 4. Click the **Select file from computer** link to locate the Template to import. Process Templates have the `.json` file extension. ProcessMaker Platform evaluates the file to import. If the Process Template was not exported from a ProcessMaker Platform Spring 2023 version or later instance, that Process Template may not be imported completely. The **Import Process Template** screen displays. Only the **Basic** import option is available for Process Templates and all assets within the Template will be imported. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/98822344-b6be-4546-8898-4892a5492fe4.png)The Import Process Template screen 5. Click the **Import** button to complete the import procedure. The Process Template appears in the **Templates** tab. You may then [configure the Process Template for your ProcessMaker Platform instance](/v1/docs/import-a-process-template#configure-a-process-template-for-your-processmaker-platform-instance). > Assets used in the Process Template that are not installed in the importing ProcessMaker Platform instance are removed from the Process Template upon import. The following message displays: **Some elements are not supported**. > [!WARNING] > If a Template with the same name already exists, the following warning message displays: **Caution: Process Template Already Exists**. > > ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/7a6d1087-3791-4323-8530-63658cef4d45.png) > > Do one of the following: > > - Click the **Update** button to update the current Process Template. > - Click the **Import as New** button to create a new Template with unique IDs. A new Process Template is created with a numerical suffix added to the original Template's name. ## Configure a Process Template for Your ProcessMaker Platform Instance After [downloading](/v1/docs/import-a-process-template#download-a-template-from-processmaker-template-gallery) and [importing a Process Template](/v1/docs/import-a-process-template#import-a-process-template), that [Template](/v1/docs/process-templates) may require additional configuration to properly function in your ProcessMaker Platform instance. For example, a [Send Email connector](/v1/docs/send-email-connector) must be configured with your unique email server for your ProcessMaker Platform instance. The Process Template that uses that Send Email connector cannot be configured prior to you downloading and importing it to your ProcessMaker Platform instance. This section references ProcessMaker Platform features that require configuration to your ProcessMaker Platform instance after importing a Process Template. After a Process Template is [edited](/v1/docs/edit-export-and-delete-a-process-template) and [published](/v1/docs/publish-your-process-model), that Template can be used with those customized settings to your ProcessMaker Platform instance. Refer to the following sections regarding any custom configurations to a Process Template after it has been imported. Note that not all Process Templates have all of these features within them. [Edit the Process Template](/v1/docs/edit-export-and-delete-a-process-template), and then inspect for any of the following features that would require customization to your ProcessMaker Platform instance if they are used: - [BPMN Element Configurations](/v1/docs/import-a-process-template#bpmn-element-configurations) - [Connector Configurations](/v1/docs/import-a-process-template#connector-configurations) ### BPMN Element Configurations Refer to the following sections regarding configurations for BPMN elements after [importing a Process Template](/v1/docs/import-a-process-template#import-a-process-template): - [Script Tasks: Select from Which User Account to Run Each Script](/v1/docs/import-a-process-template#script-tasks-select-from-which-user-account-to-run-each-script) - [User Tasks: Assign to Users and/or Groups Form Tasks and Manual Tasks](/v1/docs/import-a-process-template#user-tasks-assign-to-users-and-or-groups-form-tasks-and-manual-tasks) #### Script Tasks: Select from Which User Account to Run Each Script Scripts configured for Script Tasks must be assigned a user account from which to run within your ProcessMaker Platform instance. Ensure that the selected user's account has the appropriate API [permissions](/v1/docs/permission-descriptions-for-users-and-groups) to access the ProcessMaker Platform REST API. If your ProcessMaker Platform instance only has the default user and groups, then do the following: 1. [Create](/v1/docs/create-a-new-user-account) and [edit](/v1/docs/edit-a-user-account) users to whom to assign user Tasks. 2. [Create](/v1/docs/create-a-new-group) and [edit](/v1/docs/edit-a-group) groups to more easily organize users and other groups. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for each [Script Task](/v1/docs/script-task). Script Tasks are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/50cb6138-3d2d-40aa-be90-8003f7db0449.png)icon by default. 2. Locate the **Script** setting in the **Configuration** panel. This setting already has a Script to run. Do not change this **Script** setting. 3. [View the Scripts in your ProcessMaker Platform instance](/v1/docs/scripts#view-all-scripts). 4. [Configure the settings](/v1/docs/configure-a-script) for the Script shown in the **Script** setting. 5. Locate the **Run script as** setting. 6. From the **Run script as** setting, select the user account with appropriate permissions to access the ProcessMaker Platform REST API. #### User Tasks: Assign to Users and/or Groups Form Tasks and Manual Tasks User Tasks must be assigned to users and/or groups within your ProcessMaker Platform instance. These users and/or groups must exist prior to assigning user Tasks. If your ProcessMaker Platform instance only has the default user and groups, then do the following: 1. [Create](/v1/docs/create-a-new-user-account) and [edit](/v1/docs/edit-a-user-account) users to whom to assign user Tasks. 2. [Create](/v1/docs/create-a-new-group) and [edit](/v1/docs/edit-a-group) groups to more easily organize users and other groups. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for each user Task. There are two types of user Tasks: - [**Form Tasks elements**](/v1/docs/form-task)**:** Form Task elements are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/bbfacd67-4ca5-46f0-a03f-d3d8f32ed9e9.png)icon by default. - [**Manual Tasks elements**](/v1/docs/manual-task)**:** Manual Task elements are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5efc6730-0352-41d0-8777-69def48ddef2.png) icon by default. 2. Do the following for each user Task: - **Form Task elements:** [Select to Whom to Assign the Task](/v1/docs/form-task#select-to-whom-to-assign-the-task). - **Manual Task elements:** [Select to Whom to Assign the Task](/v1/docs/manual-task#select-to-whom-to-assign-the-manual-task). 3. Inspect the Process model for a Send Email connector. Send Email connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/adcc0c63-1507-477e-beb5-2023aa98969b.png) icon by default. If the Process Template uses a Send Email connector, then configure email Task notifications for each user Task by doing the following: - **Form Task elements:** [Configure email Task notifications](/v1/docs/form-task#email-notifications-panel-settings). - **Manual Task elements:** [Configure email Task notifications](/v1/docs/manual-task#email-notifications-panel-settings). ### Connector Configurations Refer to the following sections regarding configurations for [connectors](/v1/docs/connectors#overview) after [importing a Process Template](/v1/docs/import-a-process-template#import-a-process-template): - [Actions By Email: Configure Which Email Server to Use in the Process Template](/v1/docs/import-a-process-template#actions-by-email-configure-which-email-server-to-use-in-the-process-template) - [Data Connectors: Configure Which Data Source(s) Each Data Connector Connector Uses in the Process Template](/v1/docs/import-a-process-template#data-connectors-configure-which-data-source-s-each-data-connector-connector-uses-in-the-process-temp) - [Decision Tables: Configure Which Decision Table(s) Each Decision Task Connector Uses in the Process Template](/v1/docs/import-a-process-template#decision-tables-configure-which-decision-table-s-each-decision-task-connector-uses-in-the-process-te) - [DocuSign: Configure DocuSign Connectors in the Process Template](/v1/docs/import-a-process-template#docusign-configure-docusign-connectors-in-the-process-template) - [IDP: Configure IDP Connectors in the Process Template](/v1/docs/import-a-process-template#idp-configure-idp-connectors-in-the-process-template) - [PDF: Configure Which Screen Each PDF Generator Connector Converts to a PDF in the Process Template](/v1/docs/import-a-process-template#pdf-configure-which-screen-each-pdf-generator-connector-converts-to-a-pdf-in-the-process-template) - [Send Email: Configure Which Email Server to Use in the Process Template](/v1/docs/import-a-process-template#send-email-configure-which-email-server-to-use-in-the-process-template) - [Slack: Configure Slack Notification Connectors in the Process Template](/v1/docs/import-a-process-template#slack-configure-slack-notification-connectors-in-the-process-template) #### Actions By Email: Configure Which Email Server to Use in the Process Template Actions By Email connectors must be configured with which configured email server to use. An [email server must be configured](/v1/docs/email-default-settings#create-a-new-email-server-configuration) prior to configuring an Actions By Email connector. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for an Actions By Email connector. Actions By Email connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/846f7855-8a6a-4234-ac4b-1cd389caa0b3.png)icon by default. 2. [Configure the Actions By Email connector](/v1/docs/actions-by-email-connector#configuration-panel-settings). #### Data Connectors: Configure Which Data Source(s) Each Data Connector Connector Uses in the Process Template Data Connector connectors must be configured to reference which [Data Connector](/v1/docs/data-connectors) each uses to access its data source. Note that your ProcessMaker Platform instance must have at least one [Data Connector created](/v1/docs/create-a-new-data-connector) to select and configure its use. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a Data Connector connector. Data Connector connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/3a6f7832-c56d-45a7-93f4-d9111562e9e3.png)icon by default. 2. [Configure the Data Connector connector with which Data Connector the Data Connector uses to access its data source](/v1/docs/data-connector#settings). #### Decision Tables: Configure Which Decision Table(s) Each Decision Task Connector Uses in the Process Template [Decision Task connectors](/v1/docs/decision-task-connector) must be configured to reference which [Decision Table(s)](/v1/docs/decision-tables) each uses to evaluate business rules within that Process Template. Note that your ProcessMaker Platform instance must have at least one [Decision Table created](/v1/docs/create-a-new-decision-table) to select and configure its use. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a Decision Task connector. Decision Task connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ebe75f47-fd3c-4469-93c5-6e66f0d123e5.png)icon by default. 2. [Select which Decision Table(s) to run business rules](/v1/docs/decision-task-connector#select-which-decision-table-s-to-run-business-rules). #### DocuSign: Configure DocuSign Connectors in the Process Template [DocuSign connectors](/v1/docs/docusign-connector) must be configured to prior to use. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a DocuSign connector. DocuSign connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/85f3ba31-f0bb-4b33-b030-f8e24670f9ab.png)icon by default. 2. [Configure the DocuSign connector](/v1/docs/docusign-connector#settings). For an example how to configure a DocuSign connector, see [DocuSign Example](/v1/docs/docusign-example). #### IDP: Configure IDP Connectors in the Process Template [IDP connectors](/v1/docs/idp-connector) must be configured prior to use. A ProcessMaker IDP instance is required. ProcessMaker IDP is ProcessMaker's intelligent document processing (IDP) solution. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for an IDP connector. IDP connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/9426a272-ba03-4c76-8cec-080f18886b62.png)icon by default. 2. [Configure the IDP connector](/v1/docs/idp-connector#settings). #### PDF: Configure Which Screen Each PDF Generator Connector Converts to a PDF in the Process Template [PDF Generator connectors](/v1/docs/pdf-generator-connector) must be configured to prior to use. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a PDF Generator connector. PDF Generator connectors are denoted by an![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/33c22796-acd5-48cb-ad29-f4a75ff8b3a5.png)icon by default. 2. [Configure the PDF Generator connector](/v1/docs/pdf-generator-connector#settings). #### Send Email: Configure Which Email Server to Use in the Process Template [Send Email connectors](/v1/docs/send-email-connector) must be configured with which configured email server to use. An [email server must be configured](/v1/docs/email-default-settings#create-a-new-email-server-configuration) prior to configuring a Send Email connector. Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a Send Email connector. Send Email connectors are denoted by an ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/adcc0c63-1507-477e-beb5-2023aa98969b.png) icon by default. 2. [Configure the Send Email connector](/v1/docs/send-email-connector#configuration-panel-settings). 3. Configure email Task notification settings. #### Slack: Configure Slack Notification Connectors in the Process Template Slack Notification connectors must be configured prior to use. A Slack instance is required. Ensure to [grant ProcessMaker Platform access to your Slack workspace](/v1/docs/slack-notification-connector#grant-processmaker-platform-access-to-your-slack-workspace). Follow these steps after [importing the Process Template](/v1/docs/import-a-process-template#import-a-process-template) and [editing it](/v1/docs/edit-export-and-delete-a-process-template): 1. Inspect the Process model for a Slack Notification connector. Slack Notification connectors are denoted by an ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/119ea357-9d73-419f-80f8-ae387e1415ad.png) icon by default. 2. [Configure the Slack Notification connector](/v1/docs/slack-notification-connector#settings).