Staging and publishing components
When a component built in Components is ready to be used in a webpage designed with the page builder, you must stage it . Staged components appear on the Components tab of the page builder, organized by collections, and ready to be dragged onto the page's canvas. When you want that component to be visible on the live website, you must publish it.
Staging and publishing states of components
At any time, a component can have a combination of the following states:
-
Draft - the draft state is the initial stage of the publishing workflow. This is the state assigned to newly added components in the builder, and it remains in this state while the component is being built.
-
Never staged – Staged - Previously staged - Unstaged
Never staged is the initial state of a component. To make a component available in the page builder, it must be staged.
When staged, any new change made to the component in the Components builder brings the component to a Previously staged state. This means that the component in XM Cloud Components is different from the component seen in the page builder.
To send the latest edits to Pages, you must restage the component.
A staged component can also be unstaged, in which case the component is no longer available for use in the left-hand side pane of the page builder. Existing embedded versions of that component remain unchanged.
At any time, unstaged components can be restaged. If the component has changed at the time of restaging, the changes affect the components previously embedded in pages.
-
Never published - Published – Previously published - Unpublished - the last step in the publishing workflow is to publish the component to the Edge. Never published is the initial state of a component. A published component automatically becomes staged if it was not staged previously.
When published, any changes made to the component bring the component to a Previously published state. This means that the component in XM Cloud Components is different from the component staged in the page builder and saved on the Edge. To send the latest changes to production, you must republish the component.
Publishing can be reversed by unpublishing. When a version is unpublished, the version is not available on your Content Delivery Network until changes are published again. However, the component is still available in the the page builder if it is staged.
-
Changed - this label indicates that the component in XM Cloud Components is different from the staged or published component.
-
Up to date - a component that is drafted and published and the staged and published versions are similar to the one in XM Cloud Components.
-
Archived - a version can be archived when it is no longer required.
When a version is archived, it is hidden from the canvas but not deleted. Archived versions are still shown in production until they are unpublished. Likewise, archived components are still available in the page builder until they are unstaged. Unarchive the version to see it again, or to make changes.
There may be times during the publishing workflow when different states may exist simultaneously. For example, after staging and publishing, if the component is updated it enters into a new draft mode. The most recent changes are ahead of both what is staged and published.
If a component's changes are staged, but not published, both the components builder and the page builder show the most up-to-date version while production still shows the last published version.
Unstaging those changes above results in the page builder no longer showing the previously published version or the newly updated version.
Viewing staged and published components
You can see which stage a component is in when you click near the component, but outside of the canvas.
You can also see the component as it looks like as draft, staged, or published by clicking on the Display snapshot labels. The eye icon 
indicates which stage you are currently looking at. Snapshots cannot be edited.
Revert a component to a previous state
It is possible to revert a component in a draft state to a previous state:
-
On a component that is staged or published, edit the draft. The component now is labeled as previously staged and/or previously published.
-
Click the previously staged or previously publishedDisplay snapshot tag. You are now looking at a snapshot of a previous stage of the component. This snapshot cannot be edited, but you can revert the draft to this version.
-
Click Revert.
