<script custom-tag="" type="application/ld+json">{"@context":"https://schema.org","@type":"TechArticle","headline":"Configure widget and column macros","image":"http://support.servicenow.com/29f1d2661baf6010cafa53d8624bcb43.iix","author":{"name":"ServiceNow Support","url":"http://support.servicenow.com/now"},"keywords":"ServiceNow, NowSupport public Knowledge Base articles, Product Documentation: Washington DC,KB1617696,","wordcount":"3899","publisher":"ServiceNow","url":"https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1617696","datePublished":"2025-08-02","dateCreated":"2024-02-01","dateModified":"2025-08-02","description":"<h2>Configure widget and column macros</h2><br/><div style=\"overflow-x:auto\">\n\n<html xmlns=\"http://www.w3.org/1999/xhtml\" xml:lang=\"en\" lang=\"en\"><head><meta content=\"text/html; charset=UTF-8\" /><","articleBody":"<h2>Configure widget and column macros</h2><br/><div style=\"overflow-x:auto\">\n\n<html xmlns=\"http://www.w3.org/1999/xhtml\" xml:lang=\"en\" lang=\"en\"><head><meta content=\"text/html; charset=UTF-8\" /><meta name=\"copyright\" content=\"(C) Copyright 2025\" /><meta name=\"DC.rights.owner\" content=\"(C) Copyright 2025\" /><meta name=\"generator\" content=\"DITA-OT\" /><meta name=\"DC.type\" content=\"task\" /><meta name=\"DC.title\" content=\"Configure the cart layout\" /><meta name=\"abstract\" content=\"Configure cart layout records to define functionality for widgets or screens in the shopping cart.\" /><meta name=\"description\" content=\"Configure cart layout records to define functionality for widgets or screens in the shopping cart.\" /><meta name=\"DC.subject\" content=\"catalog items, configure cart layout\" /><meta name=\"keywords\" content=\"catalog items, configure cart layout\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../product/service-catalog-management/concept/c_ConfigureCartLayout.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../administer/general/concept/capabilities-bundle-landingpage.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../administer/general/concept/manage-services.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../product/service-catalog-management/concept/service-catalog.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../product/service-catalog-management/concept/exploring-service-catalog.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../product/service-catalog-management/reference/r_ExtendedCatalogItemFunctions.html\" /><meta name=\"DC.relation\" scheme=\"URI\" content=\"../../../product/service-catalog-management/topic/p_ServiceCatalogCustomization.html\" /><meta name=\"DC.creator\" content=\"ServiceNow\" /><meta name=\"DC.date.created\" content=\"2023-08-03\" /><meta name=\"DC.date.modified\" content=\"2024-02-01\" /><meta name=\"DC.format\" content=\"XHTML\" /><meta name=\"DC.identifier\" content=\"t_ConfigureCartLayout\" /><link rel=\"stylesheet\" type=\"text/css\" href=\"../../../CSS/commonltr.css\" /><title>Configure the cart layout</title></head><body>\n<div class=\"nested0\" id=\"t_ConfigureCartLayout\">\n <h1 class=\"title topictitle1\" id=\"ariaid-title1\">Configure the cart layout</h1>\n\n \n \n <div class=\"body taskbody\"><p class=\"shortdesc\">Configure cart layout records to define functionality for widgets or screens in the\n shopping cart.</p>\n\n <div class=\"section prereq p\" id=\"t_ConfigureCartLayout__prereq_ins_mys_nsb\">\n <p class=\"p\">Role required: admin</p>\n\n </div>\n\n <ol class=\"ol steps\"><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Navigate to <span class=\"ph menucascade\"><span class=\"ph uicontrol\">All</span> > <span class=\"ph uicontrol\">Service Catalog</span> > <span class=\"ph uicontrol\">Catalog Definitions</span> > <span class=\"ph uicontrol\">Maintain Cart Layouts</span></span>.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Select a widget or screen.</span>\n <div class=\"itemgroup info\">\n <ul class=\"ul\" id=\"t_ConfigureCartLayout__ul_lys_vjp_zq\"><li class=\"li\"><a class=\"xref\" href=\"service-catalog-cart-widgets.html\" title=\"You can configure widgets for the shopping cart, catalog items, and order guides.\">Cart widgets</a>: Item\n Ordering Widget, Shopping Cart Widget, or Item Ordering Widget (Order\n Guide)</li><li class=\"li\"><a class=\"xref\" href=\"service-catalog-screens.html\" title=\"You can configure shopping cart preview screens for the one-step and two-step carts, for the wish list, and for the Classic Mobile app.\">Preview screens</a>: Cart\n Preview Screen, Cart Preview Screen (Two Step), Cart Preview Screen\n (Wish List), or Cart Preview Screen (Classic Mobile)</li><li class=\"li\"><a class=\"xref\" href=\"service-catalog-status-screens.html\" title=\"You can configure shopping cart status screens for desktop and Classic Mobile orders.\">Order status\n screens</a>: Order Status Screen or Order, Status Screen (Classic\n Mobile)</li></ul>\n\n </div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Update the <span class=\"ph uicontrol\">Title</span> field to change the title that appears\n on the widget.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Leave the default <span class=\"ph uicontrol\">Target</span> value.</span>\n <div class=\"itemgroup info\">Do not change this value because it identifies the cart element being defined.</div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Update the other sections of the cart layout record, as required.</span>\n <div class=\"itemgroup info\">The availability of these sections varies for each widget and screen record.<div class=\"p\"><ul class=\"ul\" id=\"t_ConfigureCartLayout__ul_kkx_clp_zq\"><li class=\"li\">In the <span class=\"ph uicontrol\">Components</span> section, select the components to display, such as delivery times, item descriptions, and prices.</li><li class=\"li\">In the <span class=\"ph uicontrol\">Columns</span> section, select which columns to display, such as the item description column, delivery time column, or price column.</li><li class=\"li\">In the <span class=\"ph uicontrol\">Buttons</span> section, select the buttons to display, such as <span class=\"ph uicontrol\">Add to Cart</span>, <span class=\"ph uicontrol\">Edit Cart</span>, and <span class=\"ph uicontrol\">Delete Item</span>.</li><li class=\"li\">In the <span class=\"ph uicontrol\">Button Labels</span> section, enter new labels to replace the default button labels.<p class=\"p\">A new label is used on all screens that the button appears on. For example, the <span class=\"ph uicontrol\">Continue\n Shopping</span> button is used on several screens, so changing its label affects all those screens.</p>\n</li></ul>\n</div>\n</div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">If required, configure the widget and column macros.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Save the record, and then test the results of your configuration by ordering\n items from your service catalog.</span>\n <div class=\"itemgroup info\">\n <p class=\"p\">Some settings and properties in your instance can override or affect your\n cart layout.</p>\n\n </div>\n </li></ol>\n\n </div>\n\n<div class=\"related-links\">\n<div class=\"familylinks\">\n<div class=\"parentlink\"><strong>Parent Topic:</strong> <a class=\"link\" href=\"../../../product/service-catalog-management/concept/c_ConfigureCartLayout.html\" title=\"Service catalog enables catalog administrators to configure the layout and functionality of the service catalog cart used in your organization to place requests for catalog items.\">Cart layout</a></div>\n</div>\n</div><div class=\"topic concept nested1\" id=\"c_CartLayoSetmpctOnProps\">\n <h2 class=\"title topictitle2\" id=\"ariaid-title2\">Cart layout considerations</h2>\n\n \n \n <div class=\"body conbody\" id=\"table_cvh_2rd_cr\"><p class=\"shortdesc\">When you enable cart layouts, service catalog properties are impacted. Consider the\n possible outcomes and alter the settings or properties to achieve the cart layout and\n functionality you require.</p>\n\n <p class=\"p\">Some of these properties are impacted when you use cart layouts. For example, with the order\n status screen, the <span class=\"ph uicontrol\">When to show prices and sub-totals on the Service Catalog\n Cart</span> (glide.sc.price.display) property overrides cart layout settings for\n displaying prices.</p>\n\n <div class=\"p\">\n<div class=\"tablenoborder\"><table cellpadding=\"4\" cellspacing=\"0\" summary=\"\" id=\"c_CartLayoSetmpctOnProps__table_fvh_2rd_cr\" class=\"table\" frame=\"border\" border=\"1\" rules=\"all\"><caption><span class=\"tablecap\"><span class=\"table--title-label\">Table 1. </span>Table title</span></caption><colgroup><col /><col /></colgroup><thead class=\"thead\" style=\"text-align:left;\"><tr class=\"row\"><th class=\"entry cellrowborder\" style=\"vertical-align:top;\" id=\"d1235771e333\">Property</th><th class=\"entry cellrowborder\" style=\"vertical-align:top;\" id=\"d1235771e336\">Impact</th></tr></thead><tbody class=\"tbody\"><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">Allow ESS users the option to cancel their requests from the checkout\n screen.<p class=\"p\">[glide.sc.checkout.cancel]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Overridden when the <span class=\"ph uicontrol\">Cancel Request</span> check box in cart\n layout settings is selected. If this check box is selected, the\n <span class=\"ph uicontrol\">Cancel</span> button is displayed even if the property is set to\n <span class=\"ph uicontrol\">No</span>.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">Enable cloning requests during\n checkout.<p class=\"p\">[glide.sc.allow.checkout.clone]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Not used (deprecated) if cart layouts are enabled. Replaced by the\n <span class=\"ph uicontrol\">Clone Checkout</span>check box in cart layout settings.<p class=\"p\">The\n <span class=\"ph uicontrol\">Clone Checkout</span> check box is cleared by default for new\n instances. For upgraded instances, the check box is set to the existing value of\n the glide.sc.allow.checkout.clone property.</p>\n</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">List of roles (comma-separated) that can use the quantity selector in the\n shopping cart<p class=\"p\">[glide.sc.allow.quantity]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Overrides any relevant cart layout settings.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">Show the request item number for each line item on the checkout screen (default\n false).<p class=\"p\">[glide.sc.checkout.request.number]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Not used (deprecated) if cart layouts are enabled. Replaced by the\n <span class=\"ph uicontrol\">Request Item Number column</span> check box in cart layout\n settings.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">Show the 'Back to Catalog' button on the two-step checkout\n screen.<p class=\"p\">[glide.sc.checkout.twostep.back]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Not used (deprecated) if cart layouts are enabled. Replaced by the\n <span class=\"ph uicontrol\">Back to Catalog</span> check box in cart layout settings.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e333 \">When to show prices and subtotals on the Service Catalog\n Cart.<p class=\"p\">[glide.sc.price.display]</p>\n</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e336 \">Overrides any relevant cart layout settings.</td></tr></tbody></table>\n</div>\n</div>\n\n </div>\n\n</div>\n<div class=\"topic task nested1\" id=\"t_ConfigureWidgetAndColumnMacros\">\n <h2 class=\"title topictitle2\" id=\"ariaid-title3\">Configure widget and column macros</h2>\n\n \n \n <div class=\"body taskbody\"><p class=\"shortdesc\">Configure macros that define functionality for elements within each widget or\n screen.</p>\n\n <div class=\"section prereq p\" id=\"t_ConfigureWidgetAndColumnMacros__prereq_hwr_nys_nsb\">\n <p class=\"p\">Role required: admin</p>\n\n </div>\n\n <div class=\"section context\">\n <p class=\"p\">Some widgets or screens also have column macros that define the horizontal layout and\n configuration of shopping cart contents.</p>\n\n <p class=\"p\">You can configure these macros to alter the display order of elements, or hide\n elements, within the widget or screen. You can also create new macros to implement\n any extra requirements.</p>\n\n </div>\n\n <ol class=\"ol steps\"><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Navigate to <span class=\"ph menucascade\"><span class=\"ph uicontrol\">All</span> > <span class=\"ph uicontrol\">Widget Macros</span> > <span class=\"ph uicontrol\">Column Macros</span></span> related list.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Click the order number entry of a macro to edit its display order, or to\n activate or deactivate it.</span>\n <div class=\"itemgroup info\">\n <div class=\"fig fignone\" id=\"t_ConfigureWidgetAndColumnMacros__fig_wlz_n5m_br\">\n <img class=\"image\" id=\"t_ConfigureWidgetAndColumnMacros__image_l15_p5m_br\" src=\"../image/Service_Catalog_Cart_Layout_Widget_Macro-Editable-Details.png\" alt=\"Configure widgets and column macros.\" />\n </div>\n\n </div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Click <span class=\"ph uicontrol\">Update</span>.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Click the <span class=\"ph uicontrol\">Widget / View Macro</span> entry of a macro to view its functionality settings.</span>\n <div class=\"itemgroup info\">You cannot edit functionality settings for default macros, but these settings can be a useful reference for creating your own widget macros.</div>\n </li></ol>\n\n </div>\n\n</div>\n<div class=\"topic task nested1\" id=\"t_CreateMacrosForCartLayout\">\n <h2 class=\"title topictitle2\" id=\"ariaid-title4\">Create macros for cart layout</h2>\n\n \n \n <div class=\"body taskbody\"><p class=\"shortdesc\">Create macros for cart layout records using Jelly scripts to define customized\n behavior and display within a widget or screen.</p>\n\n <div class=\"section prereq p\" id=\"t_CreateMacrosForCartLayout__prereq_kyf_4ys_nsb\">\n <p class=\"p\">Role required: admin</p>\n\n </div>\n\n <div class=\"section context\">\n <p class=\"p\">Macros that you create do not affect upgrades because customized widget functionality\n is isolated from general cart behavior.</p>\n\n </div>\n\n <ol class=\"ol steps\"><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Open the relevant cart layout record.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Navigate to <span class=\"ph uicontrol\">Widget Macros</span> or <span class=\"ph uicontrol\">Column\n Macro</span>related list.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Click <span class=\"ph uicontrol\">New</span>.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Enter details for the macro.</span>\n <div class=\"itemgroup info\">\n \n<div class=\"tablenoborder\"><table cellpadding=\"4\" cellspacing=\"0\" summary=\"\" id=\"t_CreateMacrosForCartLayout__table_tdj_mhd_cr\" class=\"table\" frame=\"border\" border=\"1\" rules=\"all\"><caption><span class=\"tablecap\"><span class=\"table--title-label\">Table 2. </span>Macro form</span></caption><colgroup><col /><col /></colgroup><thead class=\"thead\" style=\"text-align:left;\"><tr class=\"row\"><th class=\"entry cellrowborder\" style=\"vertical-align:top;\" id=\"d1235771e640\">Field</th><th class=\"entry cellrowborder\" style=\"vertical-align:top;\" id=\"d1235771e643\">Description</th></tr></thead><tbody class=\"tbody\"><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e640 \">Name</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e643 \">The name for the new macro.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e640 \">Active</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e643 \">A check box to indicate whether the macro is displayed or\n not.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e640 \">Description</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e643 \">A summary of how the macro is used.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e640 \">Active</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e643 \">A check box to indicate whether the macro is displayed or\n not.</td></tr><tr class=\"row\"><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e640 \">XML</td><td class=\"entry cellrowborder\" style=\"vertical-align:top;\" headers=\"d1235771e643 \">The Jelly script to apply for your macro.</td></tr></tbody></table>\n</div>\n\n </div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Save the macro record.</span>\n </li></ol>\n\n <div class=\"example\">This example demonstrates the script to add a <span class=\"ph uicontrol\">Requested for\n reference</span> field as a widget macro to a cart layout\n record.<pre class=\"pre codeblock\"><code><?xml version="1.0" encoding="utf-8" ?>\n<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">\n <j:set var="ref" value="sc_cart" />\n <j:set var="jvar_ref" value="${jvar_cart.getRequestedFor()}" />\n <j:set var="jvar_ref_display" value="${jvar_cart.getRequestedForDisplayName()}" />\n <tr>\n <td colspan="3">\n ${gs.getMessage('Requested for')}:\n </td>\n </tr>\n <tr>\n <td colspan="3" style="padding: 4px;">\n <g:catalog_requested_for />\n </td>\n </tr>\n</j:jelly></code></pre>\n </div>\n\n </div>\n\n</div>\n<div class=\"topic task nested1\" id=\"t_ConfigCartLaytforSpecifItem\">\n <h2 class=\"title topictitle2\" id=\"ariaid-title5\">Configure cart layout for specific items</h2>\n\n \n \n <div class=\"body taskbody\"><p class=\"shortdesc\">Set fields in the Catalog Item form to configure the cart layout for specific\n items.</p>\n\n <div class=\"section prereq p\" id=\"t_ConfigCartLaytforSpecifItem__prereq_k5q_4ys_nsb\">\n <p class=\"p\">Role required: admin</p>\n\n </div>\n\n <div class=\"section context\">\n <p class=\"p\">Overrides any general <a class=\"xref\" href=\"t_ConfigureCartLayout.html\" title=\"Configure cart layout records to define functionality for widgets or screens in the shopping cart.\">cart layout settings</a>. For example, you can hide the price of an item by\n setting the <span class=\"ph uicontrol\">Omit price in cart</span> field to\n <span class=\"ph uicontrol\">true</span> for that item.</p>\n\n </div>\n\n <ol class=\"ol steps\"><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Navigate to <span class=\"ph menucascade\"><span class=\"ph uicontrol\">All</span> > <span class=\"ph uicontrol\">Service Catalog</span> > <span class=\"ph uicontrol\">Catalog Definition</span> > <span class=\"ph uicontrol\">Maintain Items</span></span>.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Select the catalog item.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Configure the form to add both <span class=\"ph uicontrol\">Use cart layout</span> and any\n of the following item configuration fields you require:</span>\n <div class=\"itemgroup info\">\n <ul class=\"ul\" id=\"t_ConfigCartLaytforSpecifItem__ul_mc2_v2j_zq\"><li class=\"li\">Omit price in cart</li><li class=\"li\">No cart</li><li class=\"li\">No order</li><li class=\"li\">No order now</li><li class=\"li\">No proceed checkout</li><li class=\"li\">No quantity</li></ul>\n\n </div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Clear the <span class=\"ph uicontrol\">Use cart layout</span> check box to display the\n configuration fields for that item.</span>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Set the item configuration field values as required.</span>\n <div class=\"itemgroup info\">\n <div class=\"p\"><div class=\"fig fignone\" id=\"t_ConfigCartLaytforSpecifItem__fig_kyn_hdj_zq\">\n <img class=\"image\" id=\"t_ConfigCartLaytforSpecifItem__image_qcy_1m5_pv\" src=\"../image/SC_ConfigCartLayoutSpec.png\" alt=\"\" />\n </div>\n</div>\n\n </div>\n </li><li class=\"li step stepexpand\">\n <span class=\"ph cmd\">Click <span class=\"ph uicontrol\">Update</span>.</span>\n </li></ol>\n\n </div>\n\n</div>\n<div class=\"topic concept nested1\" id=\"c_OverrideCartLayoutsForItems\">\n <h2 class=\"title topictitle2\" id=\"ariaid-title6\">Override cart layouts for items</h2>\n\n \n \n <div class=\"body conbody\" id=\"table_wbj_bqd_cr\"><p class=\"shortdesc\">Service catalog enables you to use additional methods to configure cart behavior or\n layouts, which override cart layout record settings.</p>\n\n <p class=\"p\">For example, your cart layout record settings can hide item prices, but you might decide to\n display the price of the <span class=\"ph uicontrol\">Sales Laptop</span>. In that case, you would set the\n relevant configuration values on that catalog item. Be aware of the impact of these additional\n methods, to ensure that your cart behaves in the way you want.</p>\n\n <div class=\"p\"><div class=\"note\"><span class=\"notetitle\">Note:</span> <p class=\"p\">If you are <a class=\"xref\" href=\"../concept/c_MigrateCartLayouts.html\" title=\"Service catalog enables you to configure cart layouts to add, remove, or change elements of the service catalog shopping cart. Before you migrate your system to use cart layouts, familiarize yourself with existing configurations for catalog content and decide whether to discard or retain these configurations.\">migrating to cart layouts</a>, you can have\n defined additional settings and properties that impact your cart layout settings.</p>\n</div>\n</div>\n\n </div>\n\n</div>\n</div>\n</body></html></div>"}</script>