---
schema_version: "1"
id: 504aa0eb567c235f33dd3dc5377bfd6c9e163226012bc3e2f221eb671a2cdc44
title: Prepare Your Org (Vlocity Industries Managed Packages and Custom Data Model)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_migrate_phase1_step1.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_phase1_step1.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 93f70b17b63cdf4d72a7cb9d691475c81b6633c26fbed618338fcaefa0d3bcd9
description: "Before starting the migration process, prepare your org by completing these steps:"
products:
  - Omnistudio
release: "264"
---
# Prepare Your Org (Vlocity Industries Managed Packages and Custom Data Model)

Before starting the migration process, prepare your org by completing these steps:

![phase1\_step1\_prepare](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/os_oma_migrate_phase1_step1_prepare.png)

1. Create dedicated development and testing sandboxes: Set up a development org and a testing sandbox from your production org. Perform the migration in the development org, then push the changes to the testing sandbox. See [Sandboxes for Omnistudio Migration](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_prepare_sandbox_orgs.htm&language=en_US&type=5) and [Sandbox Licenses and Storage Limits by Type](https://help.salesforce.com/s/articleView?id=platform.data_sandbox_environments.htm&language=en_US&type=5).
    
    ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_important.png)
    
    Important We recommend creating the development and testing sandboxes at the same time so that there is no difference in the metadata in both sandboxes. This avoids any deployment issues.
2. Upgrade your sandboxes: For a smooth migration and to avoid any version related issues, upgrade your development and testing sandboxes to the latest Vlocity Industries managed package (CME, INS, PS) version Winter ‘26 or later.
    
    See Omnistudio managed package versions:
    
    - [Omnistudio Installation and Upgrade](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_release_summary_for_installation_and_upgrade.htm&language=en_US&type=5)
    - [Omnistudio Managed Package Releases](https://help.salesforce.com/s/articleView?id=xcloud.000394906&language=en_US&type=5)
    
    See Salesforce Industries Cloud versions:
    
    - [Industries Communications, Media and Energy Major Release Summary](https://help.salesforce.com/s/articleView?id=ind.comms_industries_communications__media_and_energy_release_summary.htm&language=en_US&type=5)
    - [Insurance Release Summary](https://help.salesforce.com/s/articleView?id=ind.insurance_release_summary.htm&language=en_US&type=5)
    - [Omnistudio for Public Sector Solutions](https://help.salesforce.com/s/articleView?id=ind.psc_admin_concept_setupandmaintain_psc.htm&language=en_US&type=5)
3. Provision the Omnistudio license and assign permission set licenses: In both sandboxes, provision the Omnistudio license to make the Omnistudio standard objects available in the org. Then, assign Omnistudio permission set licenses to grant users access to the objects. See [Omnistudio Permission Sets](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_permission_sets_licenses.htm&language=en_US&type=5).
4. Enable Metadata API: In both sandboxes, enable the Omnistudio Metadata API setting. See [Enable Omnistudio Metadata API Support](https://help.salesforce.com/s/articleView?id=xcloud.os_enable_omnistudio_metadata_api_support.htm&language=en_US&type=5) and [Troubleshooting Errors After Enabling Omnistudio Metadata](https://help.salesforce.com/s/articleView?id=xcloud.os_metadata_setting_troubleshooting.htm&language=en_US&type=5).
5. In the development sandbox, convert or rebuild Angular components:
    
    - Vlocity and Lightning web component (LWC) cards: To make the components compatible with the Omnistudio standard runtime, rebuild all existing Vlocity and LWC cards as Flexcards on standard objects.
    - Angular Omniscripts: To make the components compatible with the Omnistudio standard runtime, convert all Angular Omniscripts to LWC Omniscripts or rebuild them on standard objects.
    - If you already converted Angular Omniscripts to LWC Omniscripts, review them for elements that are not supported in Omnistudio standard runtime.
    
    See [Convert an Angular Omniscript to an LWC Omniscript](https://help.salesforce.com/s/articleView?id=xcloud.os_convert_an_angular_omniscript_to_an_lwc_omniscript.htm&language=en_US&type=5), [Angular Features Not Supported in Omniscripts](https://help.salesforce.com/s/articleView?id=xcloud.os_lwc_omniscript_considerations.htm&language=en_US&type=5), and [Omnistudio Standard and Omnistudio for Vlocity Products and Features Support](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_and_omnistudio_for_vlocity_products_and_features_support.htm&language=en_US&type=5).
6. In the development sandbox, migrate your calculation logic to Business Rules Engine (BRE):
    
    - Migrate calculation procedures to expression sets in BRE.
    - Migrate calculation matrices to decision matrices in BRE.
    - After this transition, update your Omnistudio components to use the new BRE-based logic.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_note.png)
    
    Note Expression sets and decision matrices are part of BRE, not Omnistudio. BRE has its own setup and configuration requirements.
    
    See [Calculation Matrix and Procedure Migration to Business Rules Engine](https://help.salesforce.com/s/articleView?id=ind.migrating_calc_matrix_calc_procd.htm&language=en_US&type=5).
7. Omniscript containing Action Blocks: If your Omniscript contains Action Blocks, create and activate a new version of the Omniscript to make sure that the migration process completes successfully and all dependencies are correctly mapped.
8. Identify deprecated components: Check your implementations to understand what [features are supported on Omnistudio](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_and_omnistudio_for_vlocity_products_and_features_support.htm&type=5&language=en_US). If your implementations contain deprecated components such as Intelligence Actions and OmniForm Actions, reconfigure your setup.
9. Baseline validation: Run a baseline validation by executing end-to-end integration flows, and then save the results for comparison and future validation.

- **[Sandboxes for Omnistudio Migration](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_prepare_sandbox_orgs.htm&release=264.0.0&type=5)**  
    Create two dedicated sandboxes: a migration development sandbox for converting your Omnistudio components to work with the standard runtime, and a migration testing sandbox for thoroughly testing migrated Omnistudio components before you deploy to production.