Work with promotions

This widget allows an agent to see which promotions have been applied to the order, as well as to apply a specific promotion.

For detailed information on working with promotions in the agent console, see Create new orders.

Note that a version of this widget exists within the Storefront framework, as well.

Migrate widgets

If you have recently migrated and this widget may be visible in your widget list. However, the widget is using the default template file, which may not be available to the page layout. Additionally, this widget's style format must be updated so that it appears in the layout after a migration.

To do this, you must migrate the following widget.template and .less files:
  • /layouts/promotionAgentLayout/widget.template
  • /less/widget-promotionAgentInst_latest_version_number.less

To perform these upgrades, refer to the instructions in Work with widgets.

Widget Name: promotions

Display Name: Promotion Widget - Agent

Supported Page Types:

  • agentCheckoutPageType
  • agentMultiShipCheckoutPageType

Layouts:

  • B2B Checkout Layout - Agent
  • B2B Edit Layout - Agent
  • Checkout Edit Layout - Agent
  • Checkout Edit Layout For Multi Ship - Agent
  • Checkout Layout - Agent
  • Checkout Layout For Multi Ship - Agent

Elements: This widget uses the promotions-summary global element. To understand how this element is used, refer to the widget’s code view.