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

# How to promote content

> Promoting content enables you to copy content from one project to another. It's especially useful when working with preview or development projects. You can promote charts created in your development projects to production, so it's easy to test and make changes without the fear of breaking things in 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](/guides/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/7WBRfynBKUVSamQe/images/guides/how-to-promote-content/promote-select-project-e07e66d0992c66cd8a80aa622806b523.png?fit=max&auto=format&n=7WBRfynBKUVSamQe&q=85&s=bd5747b5208e41f6f8ddcd7ba5ebb5a7" alt="" width="921" height="267" data-path="images/guides/how-to-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/7WBRfynBKUVSamQe/images/guides/how-to-promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png?fit=max&auto=format&n=7WBRfynBKUVSamQe&q=85&s=2eb6eb5c6d0a4e1ed2bcd68cda159077" alt="" width="383" height="434" data-path="images/guides/how-to-promote-content/promote-view-chart-ff272b8342757176cf677682227d3918.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash/7WBRfynBKUVSamQe/images/guides/how-to-promote-content/promote-list-chart-a7c351011bd6338d9b830465d69d133e.png?fit=max&auto=format&n=7WBRfynBKUVSamQe&q=85&s=43bbdab14dde498fa7f9f39ce424291a" width="1008" height="409" data-path="images/guides/how-to-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](/guides/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/7WBRfynBKUVSamQe/images/guides/how-to-promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png?fit=max&auto=format&n=7WBRfynBKUVSamQe&q=85&s=61116f6c9cabd6081cb35b447dbc9af0" alt="" width="252" height="313" data-path="images/guides/how-to-promote-content/promote-view-dashboard-44e664c3f7633a87b468d99911290f11.png" />
</Frame>

<br />

<Frame>
  <img src="https://mintcdn.com/lightdash/7WBRfynBKUVSamQe/images/guides/how-to-promote-content/promote-list-dashboard-6b6b69ab8ca0bae35b47307d316ecb36.png?fit=max&auto=format&n=7WBRfynBKUVSamQe&q=85&s=26d93fb22d65c281b813a38db3a08777" width="1038" height="235" data-path="images/guides/how-to-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](/guides/data-apps#promoting-an-app) in the data apps guide for details.
