---
title: "Create a custom Commerce Engine environment"
slug: "create-a-custom-commerce-engine-environment"
abstract: "How to create a custom Commerce Engine environment."
---
# Create a custom Commerce Engine environment

You can create a custom Commerce Engine environment if you do not want to use the Sitecore XC default environments.

To create a Commerce Engine environment:

1. Make a copy of an existing environment JSON file (for example, `Plugin.Habitat.CommerceAuthoring-1.0.0.json`).
2. Rename the file to reflect your custom environment name.
3. Open the file and replace all instances of the old environment name (for example, *Habitat*) with the your custom environment name.
4. Change the `ArtifactStoreId` parameter to a unique GUID.
5. Make any required changes to the policy set and policy configuration, and save the file.
6. [Bootstrap the Commerce Engine](https://doc.sitecore.com/xp/en/developers/101/sitecore-experience-commerce/bootstrap-the-commerce-engine.html "Bootstrap the Commerce Engine") to load the new environment into the Global database.
7. Open the `wwwroot\bootstrap\Global.json` file for the Commerce Engine and add an entry for the new environment in the `EnvironmentList` component, to ensure the environment is visible in the Business Tools.

    ![Examples of policies in the Global.json file.](https://doc.sitecore.com/api/markdown-image/xp/en/developers/101/sitecore-experience-commerce/images/Global_json.png)

8. Open IIS Manager, and restart the Commerce Engine site.