--- title: "Import and Export a Screen" slug: "import-and-export-a-screen" updated: 2024-08-13T11:28:39Z published: 2024-08-13T11:28:39Z canonical: "docs.processmaker.com/import-and-export-a-screen" --- > ## 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 and Export a Screen Import a Screen that has previously been exported. ## Import a Screen Import a Screen that has been [exported](/v1/docs/screens/import-a-screen#export-a-screen) from the same [ProcessMaker Platform version](/v1/docs/participant-basics/application-version-details) or later. The imported Screen contains the [configured controls](/designer-screens/control-descriptions) from the exported Screen. Exported Screens have the `.json` file extension. ProcessMaker Platform ignores any [Projects](/v1/docs/projects) to which the importing Screen was assigned when it was exported. **Permissions** Your user account or group membership must have the following permissions to import a Screen unless your user account has the **Make this user a Super Admin** setting selected: - Screens: Import Screens - Screens: View Screens See the [Screens](/v1/docs/permission-descriptions-for-users-and-groups#screens) permissions or ask your Administrator for assistance. Follow these steps to import a Screen: 1. [View your Screens.](/v1/docs/screens#view-all-scripts) The **Screens** page displays. 2. Click the **Import** button. The **Import Screen** displays. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/0aacbc77-a261-4c31-af3e-d9bc429e32c0.png)Import Screen screen 3. Click **Browse** to locate the Screen to import. Screens have the `.json` file extension. 4. Click **Import**. The **Import Screen** screen displays to indicate that the Screen imported correctly. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/83de933f-74fc-44b4-ab43-5253a0480ee4.png) 5. Click **List Screens**. The **Screens** page displays the imported Screen with the same name as the original Screen except with a number "2" suffix. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e2684a94-8cd7-4b39-a845-ece0cce7c673.png) > [!WARNING] > If the original Screen cannot import successfully, the following message displays: **Unable to import the screen.** Ensure the following: > > - The `.json` file you tried to import is a Screen and not a Process. An [exported Process](/v1/docs/process-management/export-a-bpmn-compliant-process) also uses the `.json` file extension. > - The exported Screen was exported from the same [ProcessMaker Platform version](/v1/docs/participant-basics/application-version-details). ## Export a Screen Export a Screen to your local computer. The exported Screen may then be [imported](/v1/docs/screens/import-a-screen) to the same or another ProcessMaker Platform instance of the same [version](/v1/docs/participant-basics/application-version-details). An exported Screen may then be shared with others so they can import your Screen for their Processes. An exported Screen contains all the [controls](/designer-screens/control-descriptions) as the original at the time the original Screen was exported. The exported Screen has the `.json` file extension. **Permissions** Your user account or group membership must have the following permissions to export a Screen unless your user account has the **Make this user a Super Admin** setting selected: - Screens: Export Screens - Screens: View Screens See the [Screens](/v1/docs/permission-descriptions-for-users-and-groups#screens) permissions or ask your Administrator for assistance. Follow these steps to export a Screen: 1. [View your Screens.](/v1/docs/screens#view-all-scripts) The **Screens** page displays. 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/a3c6b5a8-e12b-4e87-ab00-c2273b37c401.png) menu, and then select the **Export** option for your Screen. The following message displays: **You are about to export a Screen. All the configurations of the screen will be exported.** ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/2d79e4ce-692e-4de9-9e1c-450b6be212ae.png)Export Screen screen 3. Click **Download**, and then browse for the location on your local computer to save the exported Screen. 4. By default, ProcessMaker Platform exports the Screen using the original Screen name except spaces in the name are replaced with underscores (`_`). The file has the file extension `.json`. Rename the default file name if necessary, though do not change the file extension. As a best practice, specify in the file name that this is an exported Screen to distinguish it from other exported assets. 5. Specify a directory location to save the file. ProcessMaker Platform exports the `.json` file to your local computer. The following message displays when the Screen exports successfully: **The screen was exported.**