# Duplicating and Sharing Dashboards

## Duplicating a Dashboard

You can duplicate a dashboard and use it as a starting point for a different dashboard.

To duplicate a dashboard:

1. Click the three dots icon next to the share icon
2. Select "Duplicate dashboard" from the drop-down menu.
3. A new, identical dashboard will be created with "(Copy)" appended to the original dashboard name.
4. Click the title section of the new dashboard to edit its name.
5. Click "**Save**."

<figure><img src="/files/sJTVlObrzRokF29jt1c3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Use **Duplicate** to create a copy of a dashboard; do not rename a dashboard and save it. If you rename a dasboard and then save it, the *original dashboard is overwritten with the renamed dashboard*, and no duplicate is created.
{% endhint %}

## Sharing a Dashboard

You can share a saved dashboard with specific users or roles.

To share a dashboard:

1. Click **Share**.
2. Click the **Search** field to browse a list of users and roles. You can also type the first few characters of a user or role name to search.
3. Click to select a user or role. To remove a user or role, click the **x** at the end of the row.
4. Click the **Copy** icon at the bottom to copy the dashboard URL.
5. Click **Apply**.
6. Send the URL to the selected users and let them now they are authorized to use the dashboard.

When viewing the dashboard, you can click the **Share** icon at any time to add or remove users.

On the Dashboards page, the **Shared** column lets you distinguish between dashboards you have shared versus dashboards shared with you by others.

| ![Dashboard Shared By Me](/files/nNlLd5op8upjLkTKvaZn)   | Dashboards you have shared             |
| -------------------------------------------------------- | -------------------------------------- |
| ![Dashboard Shared with Me](/files/xmZiV2aYM27tq10EaSVK) | Dashboards others have shared with you |

{% hint style="info" %}
Users that have been assigned the restricted\_sharing role cannot share a dashboard, and the **Share** icon is unavailable.
{% endhint %}

## Exporting and Importing a Dashboard Definition

You can use `heavysql` to export a dashboard definition as a JSON file, then import the dashboard definition to another HEAVY.AI instance.

To export a dashboard definition:

1. Start [heavysql](/v8.3.0/apis-and-interfaces/heavysql.md).
2. Enter the following backslash command:

   ```
   \export_dashboard "<dashboard-name>" <file-path>
   ```

   Where `<dashboard-name>` is the name of the dashboard in Heavy Immerse and `<file-path>` is the name and location to create the JSON file.

   For example:

   ```
   heavysql> \export_dashboard "Sample Dashboard" /home/heavyai/exported_dash.json
   ```

To import a dashboard definition:

1. Copy the export file to a location available to another HEAVY.AI instance.
2. Enter the following backslash command:

   ```
   \import_dashboard "<dashboard-name>" <file-path>
   ```

   Where `<file-path>` is the location and name of a file exported from another OmniSci instance.

   For example:

   ```
   heavysql> \import_dashboard "Sample Dashboard" /home/heavyai/my_dashboard.json
   ```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.heavy.ai/v8.3.0/immerse/working-with-dashboards/duplicating-and-sharing-dashboards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
