---
title: "Work with entity versions"
slug: "work-with-entity-versions"
abstract: "How to create and publish an entity version or view information about a particular version."
---
# Work with entity versions

By default, [versioning](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/entity-versions-and-publishing.html "Entity versions and publishing") is enabled for catalogs, categories, and sellable items. If you want to enable versioning for other types of Commerce entities, you can configure the functionality by [changing the configuration policy](https://doc.sitecore.com/xp/en/developers/103/sitecore-experience-commerce/commerce-engine-policies.html).

> [!note]
> Relationships are not versioned. All entity versions have the same defined relationships. This means if you make a change to the relationships associated with one entity version, the change is automatically applied to all versions. Changes to relationships are automatically reflected on the live site if any of the versions are already published. The only exceptions are BundleToSellableItem and BundleToSellableItemVariant, which are versioned and can be different with each version.

<details>
<summary><h2>Create a new entity version</h2></summary>

If you want to make changes to a Commerce item, you must create a new version of the item.

To create a new entity version:

1. On the **Details** page of the Commerce entity, in the **Entity Versions** section, click (to highlight) the existing version upon which to base the new version. The new entity version will be an editable copy of the one you highlight.

    > [!note]
    > When you first load the page, the last version is highlighted by default, regardless of its publishing status.

2. In the **Summary** section, in the drop-down menu, click **Add Entity Version**.

    A new version is added, modeled on the version you selected in [step 1.](https://doc.sitecore.com/xp/en/users/103/sitecore-experience-commerce/work-with-entity-versions.html#UUID-5a3d847e-a714-7686-3f80-4aa0071758c4_N1627574749952 "Step 1")

3. In the confirmation dialog box, to confirm your choice, click **OK**.
4. To edit the new version, in the **Entity Versions** section, in the **Version** field, click the corresponding number.

    > [!note]
    > The browser URL also changes to reflect the active entity version.

5. In the **Details** section, click the **Edit** icon, and in the **Edit Details** dialog box, make the required changes.
6. Click the check mark to save your changes.

</details>

<details>
<summary><h2>Publish an entity version</h2></summary>

When you are ready to publish your changes to the Commerce item, you place the entity version in the publishing workflow.

By default, a new entity version is always in a Draft state until it is promoted to the next state in the workflow. If an entity has already been published, you cannot change or re-publish it.

To publish an entity version:

1. On the **Details** page of the Commerce item, in the **Summary** section, in the drop-down menu, click **Promote to next workflow state** option.
2. In the **Promote to next workflow state** window, the current workflow state is shown as Draft. In the **Command** field, click **Submit** and then click the checkmark to confirm.
3. To move the Commerce item to the next state, in the **Summary** section, in the drop-down menu, click **Promote to next workflow state**.
4. In the **Promote to next workflow state** window, the current workflow state is shown as *Awaiting Approval*. In the **Command** field:
    - To accept changes to the item, click **Approve** - Sitecore publishes the new version of the Commerce item and sets the value of the Published field to true.
    - To reject the changes to the item, click **Reject** - Sitecore returns the entity version to the Awaiting Approval state ( and the value of the Published field remains false).

> [!note]
> As long as you have not published the entity version, you can continue to edit that version of the Commerce item, including when the entity is in the *Awaiting Approval* state.

</details>

<details>
<summary><h2>View information for different entity versions</h2></summary>

You can view different versions of an entity if you want to review the change history on an item.

To view the information associated with a particular entity version:

- On the **Details** page of the Commerce item, in the **Summary** section, click the relevant version number.

When you display the details for an older entity version, the system displays a message at the top of the page that a newer version exists (if the latest version has not been published), or that a newer version has been published.

When there are multiple versions of an entity with a *published* status, the newest is the version published on the storefront.

</details>