Skip to main content

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 one 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 the production will be updated with the changes from development. You can always revert this chart to a previous version using version history
  • If the chart is new, we will replicate this chart into the production project. We will also create a new space if needed.

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

In there, select the project where you want to copy the content to.

Promote charts

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

info

You must be a developer and have access to the chart/space in both the development project and the upstream project

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

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) and all other non-chart tiles like markdown.

If the dashboard or charts 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.

info

You must be a developer and have access to the dashboard/space in both the development project and the upstream project as well as have access to all the charts in the dashboard.

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