Eventually Ticketing
Calendar Widget

Installing the calendar widget

The calendar widget displays your upcoming events on any page of your Squarespace site. It adapts to your site's design and offers three views: month, list, and card. This guide covers how to add the widget to your pages.

Choosing a view

Before you embed the widget, decide which view works best for your page:

  • Month view — A traditional calendar grid. Best for sites with events spread across different dates.

  • List view — A chronological list of upcoming events. Best for mobile displays or simple event schedules.

  • Card view — Visual event cards with images and key details. Best for highlighting featured events.

You can embed multiple widgets on different pages using different views.

For highlighting a single event—a featured workshop, class, or registration-focused landing page—use the single-event embed instead. This displays one specific event with layout options for image placement. The selected event is saved to the widget configuration, so you can change it in the builder later without re-pasting the embed code. See Set up your calendar widget for details on single-event layout options.

After first publish

When you publish your first event, Eventually opens brand and embed setup with a live preview, brand sync or skip, and Copy embed code. First-run single publish keeps that flow in the dashboard setup drawer; bulk publish, CSV first publish, demo mode, and already-finished onboarding open the standalone Set up your widget page. Either surface is part of first-time setup, not the full widget builder. You can still copy embed code later from widget settings as described below. The share step can also show an Or send the link: public URL row. In first-run setup, copying embed code or the public event link can check off the share step, but that copied state is not the same as a live widget on your site. Eventually still upgrades the step to live when it detects the widget on your published page. Owner draft previews inside the setup drawer do not count as live embeds.

For the full first-publish path, see Finish setup on your dashboard.

Copying the embed code

  1. From your Eventually dashboard, navigate to Settings → Widget.

  2. Select your preferred view (month, list, or card).

  3. Configure any display options, such as category filters or accent colors.

  4. Click Copy embed code.

Adding the widget to Squarespace

  1. Open your Squarespace site editor.

  2. Navigate to the page where you want the calendar to appear.

  3. Add a Code Block or Embed Block to the page.

  4. Paste the embed code from Eventually into the block.

  5. Save and publish your changes.

The widget updates automatically when you create, edit, or cancel events—no need to republish your Squarespace page.

Customizing the widget appearance

The calendar widget uses Shadow DOM isolation, which means it matches your site's fonts and colors without conflicting with your existing styles. You can customize accent colors in your Eventually settings.

How we know your widget is live

Once the widget is embedded and your page is published, Eventually detects when it actually renders on your live site. This happens automatically in the background.

Previewing the widget inside Eventually does not count as a live placement. Only visitors loading your published page trigger detection.

Eventually records the first time the widget is seen on a live site and the host domain where it appeared. We store only distinct host domains, capped at 20, and ignore duplicates. This helps confirm your embed is working and track where the widget is running.

Detection depends on the visitor's browser and may be blocked by privacy settings or ad blockers. A missing detection does not mean the widget is broken — if it is visible on your page, the embed is working.

Was this helpful?