/
Copy or Delete an Application

Copy or Delete an Application

This page provides a high-level overview of how to copy or delete your CommCare applications(s).

Screenshot 2024-05-20 at 3.20.49 PM.png

Copy an Application

You can make a copy of an existing application within the same project space or to a different project space.

Permissions Required

We want to make sure that project spaces are protected in receiving copied applications only from approved users.

As such, to copy an application, you will need to have Web Users permissions to manage Apps (see below) in the project that you are copying the application to. If the project space that you are copying to uses locations, you will need to have Locations configured as well.

Screenshot 2024-05-20 at 4.11.36 PM.png

These can be selected either through the pre-existing Role Configurations or by setting up a new Role Configuration under “Add Role.”

Instructions

  • Click “Applications” at the top of the page. Select the specific application you would like to copy. 

  • In the upper lefthand corner, select the ⚙ gear icon to proceed to the Application Settingsarchived page. Select the 'Actions' tab.

  • Fill in the following information

    • Copy this app to project*: Type or select the project space you’d like to copy the application . This can include your current project space. As a reminder, you will need to have Admin permissions in the project space you are copying to.

    • Name*: Give the Application a new default name before copying.

    • Copy Version: When copying an app, you can chose the version to be copied. This can include teh most current version.

    • Copy as Linked Application: This will create an application that can be updated from changes to this application. This requires your app to have at least one released version.

  • Finally, click the Copy button. Clicking the button will bring you to the same/new project space, into the newly made copy of the application where you can proceed with building your application. 

Copy an Application to a Different Cloud Location

In some cases, users may want to copy an application between CommCare Cloud Hosting Locations . This includes if you want to copy your application from the CommCare cloud platform to a locally hosted platform. Follow the below process to import an Application from one location to another.

Please click the instructions below to learn how to do this.

  1. Open the app you want to copy from the source server.

  2. In your browser's address bar, copy the full URL. It should look like this:
    https://[SOURCE SERVER]/a/[PROJECT NAME]/apps/view/[APP_ID]
    Example:
    https://www.commcarehq.org/a/aashima-testing/apps/view/e24ab639e5b7d1b609cf2894f7c0902c/

    image-20250715-085021.png

  3. In a new tab, log in to the server where you want to import the app and open the relevant project space.

  4. Click on Project Settings, then select Import App from Another Server.

    image-20250715-074342.png

  5. In the App URL field, paste the link you copied in step 2 and click Next.

    image-20250715-084034.png

  6. Follow the on-screen instructions to download the application source file:

    554b7fd5-b3a4-4d96-9c24-7b094a676b74.png

    • Open the App URL in a new tab.

    • Click on the browser’s File menu at the top (e.g. File → Save As…).

      image-20250715-084545.png

    • In the dialog: Change the name to end with .json (e.g., my_app.json)

    • Click Save.

  7. Enter the name of the Application in the Application Name field

  8. Upload the .json file you saved

  9. Click on Import Application

  10. (Optional) If your application includes multimedia, follow the steps shown on the screen to transfer the Multimedia from source App to destination App:

    • Click on the multimedia page link that shows up in the screen. This will take you to the source app’s multimedia page

      image-20250716-063308.png

    • Click on “Download ZIP” to download all multimedia files.

      image-20250716-064500.png

    • Now click on the New App Multimedia Upload page link. This will take you to the new app’s bulk multimedia upload page

      image-20250716-063655.png

    • Upload the multimedia ZIP file you just downloaded.

      image-20250716-064334.png

You can now start using your newly imported application on the destination server.

Delete an Application

You can delete an existing application if you do not need it anymore.

1. Access the application you would like to delete by clicking on the "Application" option on the ribbon menu, found at the top of the page, and then click on the specific application name. 

2. Select the gear icon in the upper left hand corner at the top of the page to proceed to the application settings page. On this screen, select the 'Actions' tab and click on Delete this Application button.

Screenshot 2024-04-22 at 1.00.20 PM.png

3. A confirmation modal will pop-up where you will need to confirm the deletion. Once you click Delete, the application will be deleted. 

4. Immediately after deleting, you will be returned to the current project space's dashboard. At the top of the screen, there will be a notification that you successfully deleted the application with an option to 'Undo'.

Note: A deleted application can remain on the mobile worker’s device, and users may continue to submit data using it. Kindly ensure to get the deleted application uninstalled from the mobile worker’s device.