> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-docs-feature-availability-map.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How to promote content

> Copy charts and dashboards from a development or preview project into production

## How promoting works

If you are promoting a chart, from a `development` project to a `production` project, this will happen:

* If the chart exists in both the `development` project and the `production` project, the chart in `production` will be updated with the changes from `development`. You can always revert this chart to a previous version using [version history](/explore/version-history). Lightdash matches charts based on the name used when you first created them. Even if you change the names later, the two charts will still be linked.
* If the chart is new, we will replicate the `development` chart into the `production` project. We will also create a new space if a space does not exist with the same name.

## Configure upstream project

Before you can start promoting content, you need to configure your upstream project. To do this, on your `development` project go to settings > Data ops.

Select the project where you want to copy the content to.

<Frame>
  <img src="https://mintcdn.com/lightdash-docs-feature-availability-map/l-Kj6wYvLuSwm436/images/explore/promote-content/promote-select-project-e07e66d0992c66cd8a80aa622806b523.png?fit=max&auto=format&n=l-Kj6wYvLuSwm436&q=85&s=c905c421d53d05248e4423b8988c5414" alt="The Data ops tab of the development project's settings, with a picker for the upstream project to promote content into" width="921" height="267" data-path="images/explore/promote-content/promote-select-project-e07e66d0992c66cd8a80aa622806b523.png" />
</Frame>

## Promote charts

<Info>
  **You must be a `developer` and have access to the chart and space in both the `development project` and the `upstream project`.**

  If the chart is in a space that doesn't exist in the `upstream project`, then this space will be created with the same user access and the content will be put in this space. If the chart is in a space that exists in the `upstream project`, the access to this space will not be updated.
</Info>

You can promote charts from the `chart` in view mode or from any listing (like home page or all charts), click on the `...` button and then select `promote chart`.

<Frame>
  <img src="https://mintcdn.com/lightdash-docs-feature-availability-map/l-Kj6wYvLuSwm436/images/explore/promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png?fit=max&auto=format&n=l-Kj6wYvLuSwm436&q=85&s=4cf38ca1ee63b8e2f2835db3add3654a" alt="A chart in view mode with its three-dot menu open and Promote chart in the list" width="383" height="434" data-path="images/explore/promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash-docs-feature-availability-map/l-Kj6wYvLuSwm436/images/explore/promote-content/promote-list-chart-a7c351011bd6338d9b830465d69d133e.png?fit=max&auto=format&n=l-Kj6wYvLuSwm436&q=85&s=993fd9a9531c92d0bb97556417416acb" alt="A chart row in a listing page with its three-dot menu open and Promote chart in the list" width="1008" height="409" data-path="images/explore/promote-content/promote-list-chart-a7c351011bd6338d9b830465d69d133e.png" />
</Frame>

Once the chart is promoted, you can click on the `success` banner to open a new tab into this chart in the `production project`

## Promote dashboards

<Info>
  **You must be a `developer` and have access to the dashboard and space in both the `development project` and the `upstream project` as well as have access to all the charts in the dashboard.**

  If the dashboard is in a space that doesn't exist in the `upstream project`, then this space will be created with the same user access and the content will be put in this space. If the dashboard is in a space that exists in the `upstream project`, the access to this space will not be updated.
</Info>

You can promote dashboards from the `dashboard` in view mode or from any listing (like home page or all dashboards), click on the `...` button and then select `promote dashboard`.

This will promote the dashboard to the `upstream` project as well as all the charts in this dashboard (for both charts within spaces and charts within this dashboard), any embedded [data app](/data-apps) tiles, and all other non-chart tiles like markdown.

If the dashboard, charts or data apps are in a space that doesn't exist in the upstream project, then these spaces will be created and the content will be put in these spaces.

<Frame>
  <img src="https://mintcdn.com/lightdash-docs-feature-availability-map/l-Kj6wYvLuSwm436/images/explore/promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png?fit=max&auto=format&n=l-Kj6wYvLuSwm436&q=85&s=4793e62b2d6e60d3c93dac759b2e863e" alt="A dashboard in view mode with its three-dot menu open and Promote dashboard in the list" width="252" height="313" data-path="images/explore/promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash-docs-feature-availability-map/l-Kj6wYvLuSwm436/images/explore/promote-content/promote-list-dashboard-6b6b69ab8ca0bae35b47307d316ecb36.png?fit=max&auto=format&n=l-Kj6wYvLuSwm436&q=85&s=51977f7e033c934d0a6aed7dc6e253d4" alt="A dashboard row in a listing page with its three-dot menu open and Promote dashboard in the list" width="1038" height="235" data-path="images/explore/promote-content/promote-list-dashboard-6b6b69ab8ca0bae35b47307d316ecb36.png" />
</Frame>

Once the dashboard is promoted, you can click on the `success` banner to open a new tab into this dashboard in the `production project`.

## Promote data apps

You can also promote data apps from a preview project into their upstream project. See [Promoting an app](/data-apps#promoting-an-app) in the data apps guide for details.