Events

Theme section

Update This section was added in v1.4.0 on Oct 6, 2022. See our Changelog and theme update guide to learn more.

The Events section displays a calendar of upcoming events. Create custom event blocks in the theme editor or integrate your Eventbrite) account to sync and display your latest events.

Watch tutorial

Watch the step-by-step tutorial for the Events section, which includes an advanced tutorial for creating a product page for events.

Set up section

Add this section to your template and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or insert dynamic content with metafields

STEPS

In your theme editor (Customize):

1. Select a Template to edit from the dropdown menu in the top bar.

   Learn how to use templates in our Templates guide.

2. Under Template, click (+) Add section and select Events.

3. Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.

Add custom event blocks

Add blocks with the date, venue, summary of your event. Choose to add an Image, Link, and display a Date badge.

See the next section if you want to sync and display your Eventbrite events instead.

STEPS

In your theme editor (Customize):

1. Click (+) Add Event to add a new block and/or click on an Event block to open the settings.

   

   Click Remove block or the eye icon to delete or hide a block.

2. Enter text for the Name or title of your event.

   We recommend a short title of a few words for your event.

3. Enter text for the Date of your event to display below the event name.

   You can also use the date field to list an event as "TBA (To be announced)".

4. Enter text for the name of Venue.

5. (Optional.) Enter text for a Summary of your event.

   We recommend a short event description of a few sentences.

6. Select a Link to make the event block a clickable link and redirect customers to the event page.

7. (Optional.) Click Select image to upload an event image to display above the event headings.

   The Event badge will appear overlayed the image in the top-right corner.

8. (Optional) Set the Day and Month of your event for the Date badge. You can uncheck the Enable date badge option to hide it.

   To edit the month abbreviations, click the more icon [...] and Edit default theme content next to your theme in the Shopify admin. Search 'abbreviations' and edit the fields, then click Save.

9. Repeat steps 1 - 5 to create all your event blocks.

10. (Optional.) Click and hold the drag handles ⋮⋮ to rearrange the blocks:

    

    Click Remove block in the block settings to delete a block.

    Click the Eye icon to hide or unhide a block.

11. Click Save.

Integrate Eventbrite events

Note Eventbrite is an event planning and ticket sales website. To use this feature, you must have an Eventbrite account with at least one published upcoming event.

If you have an Eventbrite account, you can add your Access token to sync and display your upcoming events. The event info entered in Eventbrite, including the Image and Summary, will automatically appear in the event block.

Note: When Eventbrite events are enabled, custom event blocks will not appear.

STEPS

In your theme editor (Customize):

1. Click on Events to open the section settings.

   
2. Paste your Access token in the field provided.

   To find your Private token, go to your API keys page on Eventbrite. Click the copy icon of the Your private token field to paste it in your theme editor.

   
3. Choose the Number of events to display using the slider.

   You can add a section Link in the settings above if you want to link to all events on your Eventbrite page.

4. Click Save.

Section headings and link

Add section headings and an optional link to direct customers to a page on your store or your Eventbrite page.

STEPS

In your theme editor (Customize):

1. Click on the Events section to open the section settings.

2. Enter Heading text for the title of your section. The default heading is "Events".

   Delete the text in this field to remove the heading.

3. Enter Subheading text to display one or a few sentences below the Heading. The default subheading is "Our upcoming events".

   Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide ↗.

4. Choose a Link and enter Link text to display a clickable link to another page beneath the headings.

5. Select an Alignment for the headings and link at the top of the section. Either: Left, Center, or Right.

6. Click Save.

Section style

Adjust the section Layout by choosing the number of columns and the image shape (aspect ratio) of the event blocks.

Customize the section Style with options for section Animation, Top divider, and Padding.

STEPS

In your theme editor (Customize):

1. Click on the Events section to open the section settings.

   
2. Select the Number of columns on desktop (2 - 4) and on mobile (1 -2).

3. Select the Image aspect ratio to crop your image to Square, Landscape, or Portrait.

   The Natural setting displays the original shape of your image.

   
4. Choose to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.

   Learn more about Section animations in Stiletto.

5. Choose to display a Top divider that separates sections with a Solid line.

   The Top divider uses the color of Lines and borders set in the Theme settings.

6. Select a Padding option to change the spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.

7. Click Save.

Settings reference

Click an Events block to find the following settings.

Setting	Description
Name	Enter the name of the event.
Date	Enter the date and time of the event.
Venue	Enter the name of the location for the event.
Summary	Enter multiple lines of text to describe the event.
Link	Select or paste a link to show a "Learn more" text button below the event.
Image	Select or upload an image to display above the event details. The date badge, if enabled, will appear overlayed the image.
Enable date badge	Show a badge with the day and month of the event. Select the Day and Month using the dropdowns.

Click the Events section to find the following settings.

Eventbrite

Instead of adding event blocks, integrate your Eventbrite account to automatically display events.

Setting	Description
Access token	Log into your Eventbrite account to get your Access token here.
Number	Select the maximum number of events to show from your Eventbrite account: between 3 and 12 events.

Color

Setting	Description
Background	Select the color for the section background and date badge.
Text	Select the color of all section text.
Invert date badge	Swap the text and background colors to use for the date badge.

Section layout

Setting	Description
Number of columns on desktop	Select the number of event blocks to show per row for desktop screens. Either 2, 3, or 4.
Number of columns on mobile	Select the number of event blocks to show per row for mobile screens. Either 1 or 4.
Image aspect ratio	Crop the shape of images for the event blocks to Square (1:1), Landscape (3:2), or Portrait (2:3). Choose Natural to display the original image shapes.

Section content

Setting	Description
Heading	Enter text to show a heading.
Subheading	Enter text to display below the heading.
Link	Select or paste a Link to make the event block a clickable link and redirect customers to the event page.
Link text	Change the text for the link label.
Alignment	Position the headings and link at the top of the section. Either: Left, Center, or Right.

Section style

Setting	Description
Enable animation	Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See the Animation guide to learn more.
Top divider	Show a solid border above the section to visually separate it from other sections. The Top divider uses the Lines and borders color selected in the theme color settings.
Padding	Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.

\

---

Related links

Multi-column section Eventbrite