Loading

B2C Commerce Realm Split FAQ

Дата публикации: Mar 13, 2026
Описание

The goal of this document is to provide a central place for storing or linking any information related to the process required to split and migrate part of a live customer realm into a new realm on a different POD. This is different from the regular realm move process described in B2C Commerce POD Move FAQ - Common Questions about POD Moves.

This is a high-level view on the various data components within a realm a customer should consider when moving to another realm.

Решение
Please note:
  • When moving a site to a new realm, if that will be the first site in that realm, you will need to do the full Go Live process before we can mark that site live in the new realm. Please refer to Open a Go Live Ticket for B2C Commerce.
  • You may need to move data over in multiple steps - Delta and the remaining entities should be exported based on how you would time the cutover.

 

The following data can be migrated to a new realm:
1. Customer

2. Orders (migrated by Commerce Cloud Support if site is live).
  • Order HistoryOpen
  • Orders in-stock pre/back ordered items

3. Product
  • Catalog
  • Product Images
  • Migration of URLs/title of images for existing products
  • Content Assets associated with the product
  • Product Swatch relationship

4. Static Content (Non-Product Content)
  • Generic Content

5. Campaigns/Promotions
  • Coupons (see also section 17 if using system-generated codes)
  • Customer Groups

6. Catalog
  • Categories
  • Assigning products to categories
  • Sorting
  • Facets
  • Recommendations/Cross Sell/Perfect Pairing

7. URL Setup

8. Stores

9. Metadata
  • Store set up

10. Site Preferences

11. Business Manager Users/Roles

12. Custom Objects  

13. Custom Code

14. Active Data
CAUTION: If the information below is not provided on time, the migration process will be impacted and can cause process failures resulting in data corruption!
  1. Notify the Salesforce Support team at least Ten working business days prior to the migration.
  2. Provide <source realm code><site name> and <destination realm code><site name>
  3. Specify the migration date in yyyy-MM-dd format in ticket.
  4. Specify the time of migration in ticket in Customer's local timezone and specify time difference between customer timezone and US EST.

On the day of migration, the Support ticket must be updated with the information below as soon as site statuses have been changed:

  1. The time when the old site is set to Maintenance mode. The migration process can be started only 90 mins after the old site is finally set to Maintenance mode. Make sure that, once the site status for the old site is changed to maintenance mode and migration process starts, the site is not changed to Online mode again, or else there will be data corruption.
  2. The time when the new site is put to online mode. The new site should be marked Online at least 6 hours before the close of business customer's timezone, on the same day the old site is set to Maintenance mode.

Once the site is set to Online mode and the migration process starts, the site cannot be put back in Maintenance mode again unless it is for permanent discontinuation.

Please note that the migration does not have to start immediately after 90 mins of setting the old site to Maintenance mode.

The migration must be completed within the same day of Target realm Instance Timezone (Administration > Global Preferences > Instance Time Zone). The migration time varies depending on the data/sites involved.

The migration activity is independent of all the storefront activities and there will be no downtime for customers during the migration. Customers can continue with all their activity on the new site while the Support team works on the migration activities and ensures migration is completed during the same day of Target realm Instance (by timezone as shown under Administration > Global Preferences > Instance Time Zone) and the migrated active data will reflect on the new site on the next business day of target realm instance timezone.


Note: Active data collection tracking should be enabled on both Source and Target instances as a prerequisite. This can be done either in Business Manager (Merchant
Tools > Site Preferences > Privacy Settings) or can be enabled per session via custom code.


15. Commerce Cloud Einstein (If deployed with Commerce Cloud Einstein Prior to realm change)
  1. Submit a Support case requesting to "Override new realm site with previously deployed Einstein site"
    • In the request, provide the following:
      • The new Production instance URL and Business Manager site
      • The old Production instance URL and Business Manager site
      • Confirmation that the data should be transitioned to the new instance
    • If you are a Partner submitting the request on behalf of a customer, the owner of the previous realm must also provide approval in the comments of the support ticket
  2. When the new site goes live, Schedule Predictive Intelligence catalog and order jobs to run daily from new realm per site as outlined in How to Setup Predictive Intelligence Data (Einstein) Feed Process. 
  3. Immediately after the new realm/sites feeds have been scheduled disable the old realm/sites feeds.
  4. Support will override for customer prd/stg/dev unless there a specific reason for not to have it the same. 

16. eCDN 
  • With the new Proxy Zone feature, you can simply create the zones on the new realm right away. If they already exists on the old realm, you will just see a yellow pop-up warning indicating that the Zone already exists.
  • However, you can just click on "Create Zone" to continue. The zone will be created as a Proxy Zone on the new realm getting a dedicated CNAME.
  • Once created and if you are ready to take traffic, you can activate the zone (Secure Zone), upload a valid SSL certificate, validate the TXT record and change the new CNAME from BM in DNS. More information can be seen in the "Create a Zone" information center topic.
  • If you want to get rid of the zones in the old realm, this can be requested in a dedicated Support ticket.

17. Coupon Seed Migration (System-Generated codes only)

  • When using system-generated coupon codes, migrating the coupon ‘seeds’ is essential for ensuring system-generated coupon codes remain valid in the new realm.
  • If seeds are not migrated, previously issued coupons will cease to work due to dependency on these seeds for verification.
  • This step is crucial for sites with active promotions using system-generated codes. To initiate this process, please open a support case with Salesforce Commerce Cloud Support with the subject “[Realm Move] Migrate Coupon Seeds”, specifying a list of the specific coupons you need to migrate.
  • If you do not utilise system-generated coupon codes, this section does not apply.


Q&A
1) What elements don’t transfer?

  • Payment instruments associated with orders cannot be transferred.
  • Analytics data: Fresh Analytics data for the new realm will be available in Reports and Dashboards as well as Business Manager.
  • ​​​Salesforce Payments Configuration: You will need to re-configure Salesforce Payments on the new realm.  
    • Note: To use Salesforce Payments on the new realm, Commerce Support team must enable the Salesforce Payments feature switch in Business Manager.
2) What level of support will Commerce Cloud provide in preparation for and during the realm move?
  • Support will need to be engaged for importing orders as well as to reset on order and turn over values.
  • Support can also assist with the movement of customer payment instruments if the process in How to export customer credit card data from Business Manager in B2C Commerce is not sufficient for your purposes.
  • For any other data, the standard procedures for importing data that you want to migrate should be used.
Important Note Regarding Customer PII
During a data migration/import, it is important to ensure that imported customer numbers are not higher than the Customer Sequence Number site setting. If they are, then duplicate customer numbers can be created, which can in turn lead to customers seeing another’s PII and order history. Customer Sequence Numbers can be found on Business Manager via Administration > Global Preferences > Sequence Numbers.

3) How long will old split be supported in the event a roll-back is needed?
  • It depends on the reason why the split was decided.
  • We encourage you to delete as soon as possible since both the old realm and the new realm will be live (as opposed to a POD move).
4) Will customers be migrated with their passwords?
  • Yes
5) How much time does a customer migration require?
  • This depends on whether all the actions need to be performed at once and on the amount of data to be transferred during the cut-over window.
  • You should migrate all the static data and as much dynamic data (customers, orders, etc.) as close as possible prior to the actual cut-over. Ideally, only the delta from the previous day should be required to copy during the cut-over to minimize the down time.
6) What about if the user is using Async payment?
  • This depends on how the Async payment functionality is implemented.
7) Where is the realm split order form?
  • The standard realm order form is required, since a new realm is provided to the customer.
  • Standard data migration order form is required in case data is moved from a region to another.
8) How do I start the process?
  • Open a case with Support and provide the forms requested in (7).
9) What else should I know?
  • It is highly recommended that the TDA for the account or a Solutions Partner be engaged for the whole duration of the project.
    Номер статьи базы знаний

    000391622

     
    Загрузка
    Salesforce Help | Article