Migrate customizations and enable cart layouts

task brazil Updated Sep 10, 2026 1 min read t_MoveCustomizationsToCartLayouts.md

Move customization to cart layout widgets, and then enable cart layouts.

Before you begin

Role required: admin

About this task

When you customize a few UI macros, you should migrate the customizations to cart layout widgets before you enable cart layouts.

Following are the UI macros whose customizations need migration before you enable cart layouts:

sc_catalog_homepage_cart
sc_catalog_requested_for
catalog_item
catalog_cart_default
sc_cart_main

In addition, if you have customized the com.glideapp.servicecatalog_category_view UI page, or the Catalog Cart dynamic content, you must migrate these customizations before you enable cart layouts.

Procedure

Save copies of the customizations for later reference.
Revert the customizations to restore the customized macros or other content to their standard state.
Remove the record for the customization from the Customer Update [sys_update_xml] table.
Run the following script in Background Scripts to set the property and set the correct state for all the items in the catalog:
JavaScript
```
var cm = new CartLayoutMigration();cm.configureLayoutProperty();cm.setLayoutFalse();cm.setEmptyLayout();
```
Reimplement any cart layout customizations that you want to maintain in the upgraded instance by configuring widget macros.
To enable cart layouts, set the service catalog system property glide.sc.use_cart_layouts to Yes.

Parent Topic:Migrating to cart layouts

58 lines · 2.3 KB Wrap lines

---
title: Migrate customizations and enable cart layouts
description: Move customization to cart layout widgets, and then enable cart layouts.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/servicenow-platform/service-catalog/t\_MoveCustomizationsToCartLayouts.html
release: brazil
product: Service Catalog
classification: service-catalog
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Migrating to cart layouts, Cart layout, Service Catalog customization, Types of catalog items, Explore, Service Catalog, Manage service capabilities, Extend ServiceNow AI Platform capabilities]
---

# Migrate customizations and enable cart layouts

Move customization to cart layout widgets, and then enable cart layouts.

## Before you begin

Role required: admin

## About this task

When you customize a few UI macros, you should migrate the customizations to cart layout widgets before you enable cart layouts.

Following are the UI macros whose customizations need migration before you enable cart layouts:

- sc\_catalog\_homepage\_cart
- sc\_catalog\_requested\_for
- catalog\_item
- catalog\_cart\_default
- sc\_cart\_main

In addition, if you have customized the com.glideapp.servicecatalog\_category\_view UI page, or the Catalog Cart dynamic content, you must migrate these customizations before you enable cart layouts.

## Procedure

1. Save copies of the customizations for later reference.

2. Revert the customizations to restore the customized macros or other content to their standard state.

3. Remove the record for the customization from the Customer Update \[sys\_update\_xml\] table.

4. Run the following script in Background Scripts to set the property and set the correct state for all the items in the catalog:

```
var cm = new CartLayoutMigration();cm.configureLayoutProperty();cm.setLayoutFalse();cm.setEmptyLayout();
```

5. Reimplement any cart layout customizations that you want to maintain in the upgraded instance by configuring widget macros.

6. To enable cart layouts, set the service catalog system property **glide.sc.use\_cart\_layouts** to **Yes**.

**Parent Topic:**[Migrating to cart layouts](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/service-catalog/c_MigrateCartLayouts.md)