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 six layouts: Combined, Calendar, List, Card, Carousel, and Single event.

The Eventually Squarespace extension is a separate way to show your calendar: it fills one page of your site with your primary calendar, and pasted embeds keep working independently of it. See The Eventually Squarespace extension.

Choosing a view

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

  • Calendar 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. The widget also offers a Carousel layout: a horizontal scrolling image reel of your events, with its own scroll and card-content settings. For the full layout comparison, see Set up your calendar widget.

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, we open 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. We still upgrade the step to live when we detect 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 dashboard, open Customize → Calendars, then select the calendar you want to edit.

  2. Select your preferred view (Calendar, 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, so there is no need to republish your Squarespace page.

Customizing the widget appearance

The widget is isolated in a hosted iframe, and its fonts and colors come from the brand styles you configured or synced in Eventually. 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, we detect 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.

We record the first time the widget is seen on a live site and the host domain where it appeared. We store distinct host domains, capped at 20, and ignore duplicates. Separately, we keep up to 20 embedded page URLs, without query strings or fragments, and when each was last seen. 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?
Was this helpful?