> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-a1dca41c.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-mintlify-a1dca41c/R0B0xhFqft6R0ZTm/images/explore/promote-content/promote-select-project-e07e66d0992c66cd8a80aa622806b523.png?fit=max&auto=format&n=R0B0xhFqft6R0ZTm&q=85&s=eb8bcb4338aa8f2c2a32aa82347dac38" alt="" 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-mintlify-a1dca41c/R0B0xhFqft6R0ZTm/images/explore/promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png?fit=max&auto=format&n=R0B0xhFqft6R0ZTm&q=85&s=743f0cb994cbdca5e5b514b36f1be2be" alt="" width="383" height="434" data-path="images/explore/promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-a1dca41c/gL5D4Nt1uVOfE9Jh/images/explore/promote-content/promote-list-chart-a7c351011bd6338d9b830465d69d133e.png?fit=max&auto=format&n=gL5D4Nt1uVOfE9Jh&q=85&s=b38e65363db5ad2436e02a865e3fbc55" 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-mintlify-a1dca41c/R0B0xhFqft6R0ZTm/images/explore/promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png?fit=max&auto=format&n=R0B0xhFqft6R0ZTm&q=85&s=25ddeb45045794c08e279ad552493658" alt="" width="252" height="313" data-path="images/explore/promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-a1dca41c/R0B0xhFqft6R0ZTm/images/explore/promote-content/promote-list-dashboard-6b6b69ab8ca0bae35b47307d316ecb36.png?fit=max&auto=format&n=R0B0xhFqft6R0ZTm&q=85&s=bbe6a4137a18ba8044ec59ed428848fc" 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.
