# Promote a folder or a language

> Put every published page of a folder, or of a whole language, live in Production at once, with its redirects, after checking what would change.

Source: https://docs.bifrostorbit.com/cms/editors/promote-to-production/

When a folder or a whole language is ready in Staging, such as after a migration or a new section of the website, promote it in one go instead of page by page.

## Promote

1. Open **Pages** in Staging, in the region and language you want to promote.
2. For a folder, open its **…** menu and choose **Promote to…**. For everything in this language, open the **…** menu beside **New page** and choose **Promote this language to…**.
3. Choose the environment, such as **Production**.
4. Leave **Copy redirects** on to bring the redirects along. For a folder, those are the redirects to and from its pages; for a language, every redirect for that region and language.
5. Choose **Check**. CMS Orbit works out what would change, without changing anything: how many entries would be added and updated, how many are already up to date there, and which redirects would be added or changed.
6. Choose **Promote**. A large language takes a while; the dialog shows how far it has come.

A whole language includes every entry in it, not only pages: authors, shared sections, settings and the entries of other content types. A folder includes the folders inside it.

## What is promoted

- **What is published.** Each entry goes live in the other environment as it is published here, the same as **Promote to › Production** on one page. See [Publish, schedule and take offline](https://docs.bifrostorbit.com/cms/editors/publish-and-schedule/).
- **Drafts stay behind.** Entries that were never published are left out, and unpublished changes to a published entry stay a draft here.
- **Links follow.** Links and references point at the entries in the other environment, whatever order they arrive in.
- **Only what changed.** Entries that are already up to date there are left as they are, so promoting again after a few fixes only changes those.
- **One problem doesn't stop the rest.** If an entry can't be promoted, for example because another page there already uses its address, the dialog lists it and the others go ahead. Fix it and promote again.

Promoting needs permission to publish in both environments, and **Copy redirects** needs permission to manage redirects. Every promotion is in the [audit log](https://docs.bifrostorbit.com/cms/editors/organisation-pages/).

> **Tip:** Developers can do the same from the command line, with `npx cms-orbit promote`, or the Management API. See [Plan a migration to CMS Orbit](https://docs.bifrostorbit.com/cms/developers/plan-a-migration/).
