Creating a web activity from within a Commerce Composer widget

In certain Commerce Composer widgets, you can create a web activity directly from the widget properties view. By running a web activity in the widget, you can take advantage of web activity capabilities for managing the widget content. These capabilities include personalization, scheduling, and prioritization.

Before you begin

  1. Ensure that you understand the types of web activity actions that your widget supports. For example, for a Content Recommendation widget, the web activity action must display content, not categories or catalog entries. Review the topic for your widget in the previous links.
  2. Ensure that a site administrator configures your site to support Management Center marketing features. See Configuring marketing for Management Center.

About this task

This procedure assumes that you have already started a layout and you are in the process of setting the widget content properties for a widget that supports web activities.


  1. In the Widget Content section, select the option to use web activities as the method to populate the widget.
    Here is an example:
    Option to use a web activity in a widget
  2. Above the Web activities table, click Create New Web ActivityCreate New Web Activity.

    The activity build opens in the Commerce Composer tool.

  3. In the General Properties tab, set the properties for the activity.
    Tip: You do not have to change any of the following properties unless the default values are not suitable for your web activity.
    Name The web activity name is automatically generated using the layout name and slot position. You can type a different name if you want.
    Description Type a description of the web activity.
    Priority If you are scheduling more than one web activity in this widget, assign the activity a priority number between zero and 1000. The higher the number, the higher the priority. The web activities are evaluated in priority sequence.
    Start date Optionally, specify a start date and time for the activity. If you want the web activity to run the entire time that the layout is scheduled to run, do not specify a start date.
    End date Optionally, specify an end date and time for the activity. If you want the web activity to run the entire time that the layout is scheduled to run, do not specify an end date.
    Repeatable Specify whether the activity is repeatable. This means that a customer who views the widget multiple times can see the content each time. This behavior is generally desirable for web activities.
    Campaign If you want to organize this activity under a campaign, specify the campaign.
  4. Decide whether to keep the existing action in the activity flow, or replace it with a different action.
    For example, for the Content Recommendation widget, the default activity contains the Recommend Content action. You can delete the Recommend Content action from the flow and drag in a different action from the palette, such as the Recommend Promotion action.
    Important: You must use an action that displays the type of data (content, catalog entries, or categories) that your widget supports. Refer to the widget topic links at the beginning of this topic to see a list of supported actions for each widget.
  5. Click the action in the activity flow, and then set its properties.
  6. Optional: Add target elements to your activity.
    Targets define what more criteria a customer must meet to see the information you specified for this e-Marketing Spot.
    1. From the Targets section in the palette, drag a target element onto a flow connector in the work area to the left of the action element that you want to target.
    2. Click the target element to display its properties in the properties view.
    3. Complete the properties for the target element.
  7. Optional: Add branch elements to your activity.
    A branch element splits a single path in the activity into two or more paths. You can then use different target and action elements on each path within the same activity.
    1. From the Branches section in the palette, drag the Branch element onto a flow connector at the point where you want to split a single path into multiple paths.
    2. If you want more than two paths, right-click the Branch element in the work area; then click Add Path.
    3. Click the Branch element in the work area to display its properties in the properties view.
    4. Complete the properties for the Branch element.
    5. Make your changes to the elements on the paths that extend from the Branch element. These changes can involve adding or changing targets and actions on each path until you get the result you want.
  8. Click Save and then click Close.
    In the widget properties, the web activity is listed in the Web activities table. Notice that its status is Inactive.
  9. Right-click the web activity, and then click Activate.


The activity is set to run in the widget. You can view the results by previewing the layout in store preview.