After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Catalog Events Carousel

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.
Magento Commerce only. Learn more.

The Catalog Events Carousel widget displays a slider of upcoming events with a countdown ticker for each event. You can choose the page(s) and area of the page layout where you want the carousel to appear, and control the width and number of events that appear at one time. The result you get depends on your theme, where it is positioned to appear on the page, and the options that you choose.

Event carousel in the left sidebar

Before you begin, follow the instructions to configure the Catalog Event widget so that it is enabled for the storefront.

Catalog event configuration

Step 2: Create the widget

  1. On the Admin sidebar, go to Content > Elements > Widgets.

  2. In the upper-right corner, click Add Widget.

  3. In the Settings section, do the following:

    • Set Type to Catalog Events Carousel.

    • Choose the Design Theme that is used by the store.

  4. Click Continue.

    Widget settings for an event carousel

  5. In the Storefront Properties section, do the following:

    • For Widget Title, enter a descriptive title for the widget.

      This title is visible only from the Admin.

    • For Assign to Store Views, select the store views where the widget will be visible.

      You can select a specific store view, or All Store Views. To select multiple views, hold down the Ctrl key (PC) or the Command key (Mac) and click each option.

    • (Optional) For Sort Order, enter a number to determine the order this item appears with others in the same part of the page. (0 = first, 1 = second, 3 = third, and so on.)

    Widget storefront properties

Step 3: Choose the location

  1. In the Layout Updates section, click Add Layout Update.

  2. Set Display On to Specified Page.

  3. Set Page to CMS Home Page.

  4. Set Container one fo the following:

    • Main Content Area
    • Sidebar Additional
    • Sidebar Main

    The results vary according to theme and page layout. The Catalog Events Carousel Default Template must also be specified in the category configuration.

  5. If you want the events carousel to appear in an additional location in the storefront, click Add Layout Update and repeat the these steps for another location.

    Layout updates

  6. Click Save and Continue Edit.

    For now, you can ignore the message to refresh the cache.

Step 4: Configure the options

  1. In the left panel, choose Widget Options.

  2. For Frame Size, enter the number of events that you want to list in the slider at the same time.

    To view only one event at a time, enter 1.

  3. For Scroll, enter the number of event listings that you want to scroll per click.

    To scroll to the next event, enter 1.

  4. For a custom width, enter the number of pixels for Block Custom Width.

    The custom width for the example on this page is set to 250 pixels.

    Custom width widget options

  5. When complete, click Save.

  6. When prompted to refresh the cache, click the link in the message at the top of the page and follow the instructions.