Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Table of Contents
stylenone

Copy an Application

There are two ways to copy your application: in the same project space or a different project space.

Copy an Application

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

1. To do this, access the application you would like to copy by clicking on the "Application" option on the ribbon menu, found at the top of the page. Then click on the specific application name you would like to copy. 

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.

3. In the "Copy this app to project*" box type or select the project space you’d like to copy the application to (it can be the same project space you’re currently on).

NOTE: You need to be an admin web user in the project space you're trying to copy the application to. 
4. In the "Name*" box, you can also give the Application a new default name before copying.

5. When copying an app, you can chose the version to be copied.

6. 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 Server

Multiexcerpt include macro
macro_uuid846f10d6-3459-462c-8ce9-b12bb0b90265
nameTechnical Documentation
templateDataeJyLjgUAARUAuQ==
page[Internal] CommCare Public Management
addpanelfalse

If you need to transfer an application between servers (for example, if you are a developer running CommCare HQ locally, or have a second instance of CommCare HQ running elsewhere):

  1. On the server containing the app you want to copy, go to the URL: http://[SERVER ADDRESS]/a/[PROJECT NAME]/apps/source/<APP_ID>.  For example: https://www.commcarehq.org/a/demo/apps/source/071abeb39a1039df30613c494caa9bc3

  2. You should see a block of JSON-formatted text. Right click to save this page as a file with .json extension.

  3. On the new server, go to the following URL http://[SERVER ADDRESS]/a/[PROJECT NAME]/apps/import_app/.

  4. Add an application name, and upload the app json file downloaded above.

  5. Click Import Application.

Notes:

  • This will not copy users and groups.

  • This will not copy organization structure or levels.

  • This will not copy user fields. 

  • This will not copy lookup tables (aka fixtures).

  • This will not copy multimedia from the app. Use the bulk multimedia download/upload to move multimedia.

  • This will not copy feature flags, although it will copy over any feature-flagged content in the application (e.g., advanced modules), which may behave unexpectedly if the domain being copied to does not have the correct flags enabled.

Delete an Application

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

1. To do this, 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'.