Core Concepts Exporting and Importing a Canvas or Project

Exporting and Importing a Canvas or Project

As teams collaborate across several instances of Navigator within an Organization you may need to share a single Canvas or an entire Project folder to another team member. Using the Export and Import features within Navigator allows you to do just that!

In this guide we will walk through the process of Exporting and Importing individual Canvases and entire Project folders. As mentioned in other articles all flows built within a Canvas are stored locally to your machine, so sharing Canvases and Projects with other team members before Deployment can be critical for testing and iterating over specific builds.

Exporting

Single Canvas

  1. To export a single Canvas - Open the Projects tab in Navigator from the left panel
  2. All Canvases NOT a part of a Project folder will be under the "Single Canvases" header.
  3. Click the three dots ... next to the Canvas you would like to Export
  4. Click Export as JSON
  5. Choose the location on your machine for this file and give the file a name
  6. Click Save

The name of the JSON file is not what will appear after the import process completes. Each Canvas and Project folder has a distinctive name given inside of Navigator which will be referenced from this JSON file on the import.

Once this file is saved you shouldn't need to update this JSON file before importing. Updates to the exported JSON code can cause the import process to fail.

Project Folder

  1. To export an entire Project folder - Open the Projects tab in Navigator from the left panel
  2. Project folders are located under the "Projects" header.
  3. Click the three dots ... next to the Project folder you would like to Export
  4. Click Export as JSON
  5. Choose the location on your machine for this file and give the file a name.
  6. Click Save

The name of the JSON file is not what will appear after the import process completes. Each Canvas and Project folder has a distinctive name given inside of Navigator which will be referenced from this JSON file on the import.

This Project folder will be saved as a single JSON file that contains all of the configured Canvases. You shouldn't need to update this JSON code. If you need to export specific Canvases from this project, see the steps above for exporting a single Canvas.

Importing

Regardless if you have a Project folder or a single Canvas you need to import the process should be the same!

  1. Open the Projects tab in Navigator from the left panel
  2. Click the Create button on top the left panel
  3. Select Open

Keyboard shortcut Command + O allows you to open a file as well.

  1. Select the JSON file of a Canvas or Project folder exported from Navigator
  2. Click Open

You should now see the selected Canvas or Project folder appear inside of Navigator with the same naming conventions that were originally created in Navigator when this JSON file was exported.

Next Steps