Skip to main content

Events Feed Setup Guide

The Events Feed section displays upcoming events from a Google Calendar directly on your Shopify store. This guide walks through setting up your calendar and configuring the section.

1. Create a Google Calendar

If you don't already have a Google Calendar for your events:

  1. Go to Google Calendar
  2. Sign in with your Google account
  3. On the left sidebar, click the + next to "Other calendars"
  4. Select Create new calendar
  5. Enter a name (e.g., "Store Events") and click Create calendar

2. Make Your Calendar Public

Your calendar must be public for the Events Feed to access it:

  1. In Google Calendar, find your calendar in the left sidebar
  2. Click the three dots next to your calendar name
  3. Select Settings and sharing
  4. Scroll to Access permissions for events
  5. Check the box for Make available to public
  6. Choose See all event details from the dropdown

3. Get Your Calendar's ICS URL

This is the link the Events Feed uses to pull your events:

  1. While still in your calendar's settings, scroll down to Integrate calendar
  2. Find Public address in iCal format
  3. Copy the URL (it will look like https://calendar.google.com/calendar/ical/...)

4. Add the Events Feed Section

  1. Open your Shopify admin and go to Online Store → Themes
  2. Click Customize on your theme
  3. Navigate to the page where you want to display events
  4. Click Add section and select Events Feed
  5. Paste your ICS Calendar URL into the ICS Calendar URL field

5. Configure Display Settings

Display Mode

Choose how events appear on your page:

  • Event List: Shows multiple upcoming events in a vertical list format. Each event displays as a card with the date badge, title, time, and location. Best for pages dedicated to events or when you have several upcoming events to showcase.

  • Next Event Only: Highlights just your next upcoming event in a larger, featured card format. The event appears with a "Next Event" badge and centered layout. Best for homepage sections or when you want to draw attention to a single event.

Events Settings

  • Maximum Events to Show: How many events to display (1-50). Only applies to Event List mode.
  • Days Ahead to Look: How far into the future to search for events (7-364 days).

Content Settings

  • Heading: The title above your events (e.g., "Upcoming Events")
  • Description: Optional text below the heading
  • No Events Message: What to show when there are no upcoming events

6. Styling Options

The Events Feed section includes extensive customization options:

  • Section Appearance: Color scheme, width, background media
  • Container Appearance: Borders, shadows, border radius
  • Card Appearance: Card colors, spacing, typography
  • Shadow & Effects: Drop shadows and hover effects
  • Button: Optional "See All Events" link button

Important Notes

Proxy Worker URL

⚠️ Do not change the Proxy Worker URL setting unless you are an advanced user who has set up your own proxy server. The default proxy handles caching and cross-origin requests automatically.

Event Details

When customers click on an event card, a modal appears with:

  • Full event title and description
  • Date and time details
  • Location (with "Get Directions" link if provided)
  • "Add to Calendar" button
  • "Learn More" link (if you added a URL to the event in Google Calendar)

Adding Events

To add events that appear on your store:

  1. Go to Google Calendar
  2. Click on the date/time for your event
  3. Fill in the event details:
    • Title: The event name
    • Date/Time: When the event occurs
    • Location: Address or venue name (enables "Get Directions")
    • Description: Additional details about the event
    • Add URL: Link to a page with more information (enables "Learn More")
  4. Save the event

Events will automatically appear on your store within a few minutes.

Troubleshooting

Events Not Showing

  1. Verify your calendar is set to public in Google Calendar settings
  2. Confirm you copied the correct iCal format URL (not the regular calendar link)
  3. Check that your events are scheduled within the "Days Ahead" range
  4. Events must be in the future - past events won't display

Wrong Dates/Times

  1. Check your Google Calendar timezone settings
  2. Verify event times are correct in Google Calendar
  3. The Events Feed displays times in your visitor's local timezone

Events Loading Slowly

This is normal on first load. The system caches events for 10 minutes, so subsequent page loads will be faster.