Skip to main content

Components

Calendar

Month, week, day and agenda views with event chips, a mini date picker and category filters. Radios switch views, container queries handle every width.

How it works

The calendar is a set of layout components. Your server renders the dates and events; the CSS lays them out and handles the interaction. Nothing calculates dates in the browser.

  • Views are radio inputs. A checked .calendar-view-check[value="week"] hides every element whose data-calendar-view does not list week. This uses :has(), so view switching works anywhere tabs work.
  • Event placement uses inline custom properties. Month and all-day events take a column and a span. Timed events take a start and end hour. CSS grid and calc() do the rest.
  • Responsive behaviour uses container queries, not media queries. Each view adapts to the width of its own box, so it behaves the same in a sidebar or a full page. Month chips turn into colour bars, the week grid scrolls and snaps one day at a time, and the agenda stacks.
  • Event details are native popovers. Any chip can be a <button popovertarget>, and one popover can serve the same event in every view.
  • Filters are checkboxes. Unchecking .calendar-filter-check[value="danger"] hides every .calendar-event-danger in the calendar.
  • Baseline: CSS grid, custom properties, :has() and size container queries (Chrome 105, Safari 16, Firefox 121).
  • Enhancement: anchor positioning puts event popovers next to their chip. Without it they open centred, like every popover in this theme.
  • Fallback: without :has() every view is shown, stacked. Without container queries the views keep their wide layouts and the week grid scrolls sideways.
Previous, Today and Next are plain links. Each one loads the next period from your server, as a server-rendered calendar should. Clicking them on this page does nothing.

Example

A full calendar: toolbar, view switcher, mini month, category filters, and all four views. Today is Thursday 29 October 2026. Click any event for its details. Uncheck a calendar to hide its events. Resize the window, or open the page on a phone, to see each view adapt.

October 2026

Oct 26 – Nov 1, 2026

Thursday, October 29

Oct 29 – Nov 4, 2026

CDT
Mon26
Tue27
Wed28
Thu29
Fri30
Sat31
Sun1
All day
CDT
Thu29
All day

29ThursdayOctober 2026 · Today

30FridayOctober 2026

31SaturdayOctober 2026

1SundayNovember 2026

2MondayNovember 2026

No bookings. Rest day.

3TuesdayNovember 2026

4WednesdayNovember 2026

Ring camp

When
Mon 5 Oct – Wed 7 Oct
Where
Performance Center
Type
Training

Scouting trip

When
Sat 24 Oct – Tue 27 Oct
Where
Indie shows, Ohio
Type
Travel

Halloween Havoc weekend

When
Fri 30 Oct – Sun 1 Nov
Where
Detroit, MI
Type
Shows

Merch inventory

When
All day
Where
Warehouse
Type
Admin

Fly to Chicago

When
All day
Where
ORD
Type
Travel

Thursday Night Throwdown

When
Thu 1 Oct, 7:00 PM – 10:00 PM
Where
The Armory
Type
Shows

Media day

When
Fri 2 Oct, 10:00 AM – 1:00 PM
Where
Studio B
Type
Media

Physio check

When
Tue 6 Oct, 9:00 AM – 10:00 AM
Where
Clinic
Type
Medical

Windy City Rumble

When
Sat 10 Oct, 7:00 PM – 11:00 PM
Where
Chicago, IL
Type
Shows

Booking meeting

When
Mon 12 Oct, 11:00 AM – 12:00 PM
Where
Office
Type
Admin

Tag team practice

When
Wed 14 Oct, 6:00 PM – 8:00 PM
Where
Gym
Type
Training

Friday Night RopeBreak.net

When
Fri 16 Oct, 8:00 PM – 11:00 PM
Where
The Armory
Type
Shows

Podcast guest spot

When
Mon 19 Oct, 3:00 PM – 4:00 PM
Where
Remote
Type
Media

Physio check

When
Tue 20 Oct, 9:00 AM – 10:00 AM
Where
Clinic
Type
Medical

Sparring

When
Thu 22 Oct, 10:00 AM – 12:00 PM
Where
Gym
Type
Training

Friday Night RopeBreak.net

When
Fri 23 Oct, 8:00 PM – 11:00 PM
Where
The Armory
Type
Shows

Ring drills

When
Mon 26 Oct, 9:00 AM – 11:00 AM
Where
Performance Center
Type
Training

Booking meeting

When
Mon 26 Oct, 11:30 AM – 12:30 PM
Where
Office
Type
Admin

Physio check

When
Tue 27 Oct, 8:00 AM – 9:00 AM
Where
Clinic
Type
Medical

Tag team practice

When
Tue 27 Oct, 10:00 AM – 12:00 PM
Where
Gym
Type
Training

Podcast taping

When
Tue 27 Oct, 6:00 PM – 7:00 PM
Where
Studio B
Type
Media

Cardio block

When
Wed 28 Oct, 9:00 AM – 10:30 AM
Where
Gym
Type
Training

Booking call

When
Wed 28 Oct, 9:30 AM – 11:00 AM
Where
Phone
Type
Admin · tentative

Merch design review

When
Wed 28 Oct, 2:00 PM – 3:00 PM
Where
Office
Type
Admin

Ring drills

When
Thu 29 Oct, 9:00 AM – 11:00 AM
Where
Performance Center
Type
Training

Promo taping

When
Thu 29 Oct, 1:00 PM – 2:00 PM
Where
Studio B
Type
Media

Radio interview

When
Thu 29 Oct, 1:30 PM – 2:15 PM
Where
WRBK 101.5
Type
Media

Physio check

When
Thu 29 Oct, 3:00 PM – 3:30 PM
Where
Clinic
Type
Medical

Thursday Night Throwdown

When
Thu 29 Oct, 7:00 PM – 10:00 PM
Where
The Armory
Type
Shows

Flight to Detroit

When
Fri 30 Oct, 7:00 AM – 9:00 AM
Where
DTW · Gate B12
Type
Travel

Venue walkthrough

When
Fri 30 Oct, 12:00 PM – 1:00 PM
Where
Little Caesars Arena
Type
Admin

Press scrum

When
Fri 30 Oct, 5:00 PM – 5:45 PM
Where
Media room
Type
Media · cancelled

Light workout

When
Sat 31 Oct, 10:00 AM – 11:00 AM
Where
Hotel gym
Type
Training

Meet & greet

When
Sat 31 Oct, 4:00 PM – 5:00 PM
Where
Concourse
Type
Media

Halloween Havoc

When
Sat 31 Oct, 7:00 PM – 11:00 PM
Where
Little Caesars Arena
Type
Shows

Flight home

When
Sun 1 Nov, 11:00 AM – 1:00 PM
Where
DTW → ORD
Type
Travel

Recovery session

When
Tue 3 Nov, 10:00 AM – 11:00 AM
Where
Clinic
Type
Medical

Booking meeting

When
Wed 4 Nov, 11:00 AM – 12:00 PM
Where
Office
Type
Admin · tentative

Thursday 29 October

Anatomy

.calendar is the shell and the container that the toolbar and layout query. Inside it, .calendar-layout places an optional .calendar-sidebar beside .calendar-main once the calendar is at least 52rem wide. Below that the sidebar moves under the views. Each view is a standalone component. You can use .calendar-month, .calendar-timegrid or .calendar-agenda without the shell.

<div class="calendar" role="region" aria-label="Talent schedule">
  <div class="calendar-toolbar">
    <div class="calendar-toolbar-group"><!-- prev / today / next links --></div>

    <!-- One title per view; data-calendar-view shows the right one -->
    <h3 class="calendar-title" data-calendar-view="month">October 2026</h3>
    <h3 class="calendar-title" data-calendar-view="week">Oct 26 – Nov 1, 2026</h3>

    <div class="btn-group" role="group" aria-label="Calendar view">
      <input type="radio" class="btn-check calendar-view-check" name="cal-view" id="cal-month" value="month" checked>
      <label class="btn btn-outline-primary" for="cal-month">Month</label>
      <input type="radio" class="btn-check calendar-view-check" name="cal-view" id="cal-week" value="week">
      <label class="btn btn-outline-primary" for="cal-week">Week</label>
      <!-- day, agenda … -->
    </div>
  </div>

  <div class="calendar-layout">
    <aside class="calendar-sidebar"><!-- .calendar-mini, .calendar-legend --></aside>
    <div class="calendar-main">
      <div class="calendar-view" data-calendar-view="month"><!-- .calendar-month --></div>
      <div class="calendar-view" data-calendar-view="week"><!-- .calendar-timegrid --></div>
      <div class="calendar-view" data-calendar-view="day"><!-- .calendar-timegrid, 1 day --></div>
      <div class="calendar-view" data-calendar-view="agenda"><!-- .calendar-agenda --></div>
    </div>
  </div>
</div>

data-calendar-view takes a space-separated list. data-calendar-view="week day" shows an element in both time-grid views. Elements without the attribute are always shown. The built-in views are day, week, month and agenda. Add more names to $calendar-views.

Month view

.calendar-month stacks .calendar-week rows under a .calendar-weekdays header. Each week has two layers. .calendar-days holds the seven cells and their date links. .calendar-events is a seven-column grid laid over them. Events go in the second layer, and dense auto-placement packs them into rows under the date numbers. A busy week grows taller; it never overlaps.

HTML
<div class="calendar-month">
  <div class="calendar-weekdays" aria-hidden="true">
    <div class="calendar-weekday">Mon</div>
    <div class="calendar-weekday">Tue</div>
    <div class="calendar-weekday">Wed</div>
    <div class="calendar-weekday">Thu</div>
    <div class="calendar-weekday">Fri</div>
    <div class="calendar-weekday">Sat</div>
    <div class="calendar-weekday">Sun</div>
  </div>
  <div class="calendar-week">
    <div class="calendar-days">
      <div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Monday 28 September">28</a></div>
      <div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Tuesday 29 September">29</a></div>
      <div class="calendar-day is-outside"><a class="calendar-date" href="#!" aria-label="Wednesday 30 September">30</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 1 October">1</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 2 October">2</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 3 October">3</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 4 October">4</a></div>
    </div>
    <div class="calendar-events">
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 1 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 2 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Media day</span></a>
    </div>
  </div>
  <div class="calendar-week">
    <div class="calendar-days">
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 5 October">5</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 6 October">6</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 7 October">7</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 8 October">8</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 9 October">9</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 10 October">10</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 11 October">11</a></div>
    </div>
    <div class="calendar-events">
      <a href="#!" class="calendar-event calendar-event-navy" style="--bs-calendar-col: 1; --bs-calendar-span: 3;"><span class="visually-hidden">Mon 5 Oct – Wed 7 Oct: </span><span class="calendar-event-title">Ring camp</span></a>
      <a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-col: 5;"><span class="visually-hidden">All day, Fri 9 Oct: </span><span class="calendar-event-title">Fly to Chicago</span></a>
      <a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 6 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 10 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Windy City Rumble</span></a>
    </div>
  </div>
  <div class="calendar-week">
    <div class="calendar-days">
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 12 October">12</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 13 October">13</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 14 October">14</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 15 October">15</a></div>
      <div class="calendar-day is-selected"><a class="calendar-date" href="#!" aria-label="Friday 16 October">16</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 17 October">17</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 18 October">18</a></div>
    </div>
    <div class="calendar-events">
      <a href="#!" class="calendar-event calendar-event-secondary" style="--bs-calendar-col: 2;"><span class="visually-hidden">All day, Tue 13 Oct: </span><span class="calendar-event-title">Merch inventory</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 12 Oct, </span><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking meeting</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 14 Oct, </span><span class="calendar-event-time">6p</span><span class="calendar-event-title">Tag team practice</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 16 Oct, </span><span class="calendar-event-time">8p</span><span class="calendar-event-title">Friday Night RopeBreak.net</span></a>
    </div>
  </div>
  <div class="calendar-week">
    <div class="calendar-days">
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 19 October">19</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 20 October">20</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 21 October">21</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Thursday 22 October">22</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 23 October">23</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 24 October">24</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 25 October">25</a></div>
    </div>
    <div class="calendar-events">
      <a href="#!" class="calendar-event calendar-event-info is-continued-after" style="--bs-calendar-col: 6; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 19 Oct, </span><span class="calendar-event-time">3p</span><span class="calendar-event-title">Podcast guest spot</span></a>
      <a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 20 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 22 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Sparring</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid is-past" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 23 Oct, </span><span class="calendar-event-time">8p</span><span class="calendar-event-title">Friday Night RopeBreak.net</span></a>
    </div>
  </div>
  <div class="calendar-week">
    <div class="calendar-days">
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Monday 26 October">26</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Tuesday 27 October">27</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Wednesday 28 October">28</a></div>
      <div class="calendar-day is-today"><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
      <div class="calendar-day"><a class="calendar-date" href="#!" aria-label="Friday 30 October">30</a></div>
      <div class="calendar-day is-weekend"><a class="calendar-date" href="#!" aria-label="Saturday 31 October">31</a></div>
      <div class="calendar-day is-outside is-weekend"><a class="calendar-date" href="#!" aria-label="Sunday 1 November">1</a></div>
    </div>
    <div class="calendar-events">
      <a href="#!" class="calendar-event calendar-event-info is-continued-before" style="--bs-calendar-col: 1; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 5; --bs-calendar-span: 3;"><span class="visually-hidden">Fri 30 Oct – Sun 1 Nov: </span><span class="calendar-event-title">Halloween Havoc weekend</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 26 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 1;"><span class="visually-hidden">Mon 26 Oct, </span><span class="calendar-event-time">11:30a</span><span class="calendar-event-title">Booking meeting</span></a>
      <a href="#!" class="calendar-event calendar-event-danger calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">8a</span><span class="calendar-event-title">Physio check</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Tag team practice</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 2;"><span class="visually-hidden">Tue 27 Oct, </span><span class="calendar-event-time">6p</span><span class="calendar-event-title">Podcast taping</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Cardio block</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-tentative is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">9:30a</span><span class="calendar-event-title">Booking call</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot is-past" style="--bs-calendar-col: 3;"><span class="visually-hidden">Wed 28 Oct, </span><span class="calendar-event-time">2p</span><span class="calendar-event-title">Merch design review</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 29 Oct, </span><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-past" style="--bs-calendar-col: 4;"><span class="visually-hidden">Thu 29 Oct, </span><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
      <button type="button" class="calendar-more" style="--bs-calendar-col: 4;" popovertarget="calendar-month-more-2026-10-29">+3<span class="calendar-more-label"> more</span><span class="visually-hidden"> on Thursday 29 October</span></button>
      <a href="#!" class="calendar-event calendar-event-info calendar-event-dot" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary calendar-event-dot" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">12p</span><span class="calendar-event-title">Venue walkthrough</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot is-cancelled" style="--bs-calendar-col: 5;"><span class="visually-hidden">Fri 30 Oct, </span><span class="calendar-event-time">5p</span><span class="calendar-event-title">Press scrum</span></a>
      <a href="#!" class="calendar-event calendar-event-navy calendar-event-dot" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">10a</span><span class="calendar-event-title">Light workout</span></a>
      <a href="#!" class="calendar-event calendar-event-success calendar-event-dot" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">4p</span><span class="calendar-event-title">Meet & greet</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 6;"><span class="visually-hidden">Sat 31 Oct, </span><span class="calendar-event-time">7p</span><span class="calendar-event-title">Halloween Havoc</span></a>
      <a href="#!" class="calendar-event calendar-event-info calendar-event-dot" style="--bs-calendar-col: 7;"><span class="visually-hidden">Sun 1 Nov, </span><span class="calendar-event-time">11a</span><span class="calendar-event-title">Flight home</span></a>
    </div>
  </div>
</div>
<div class="popover calendar-popover fade" popover id="calendar-month-more-2026-10-29" data-bs-placement="bottom">
  <div class="popover-arrow"></div>
  <h4 class="popover-header">Thursday 29 October</h4>
  <div class="popover-body d-grid gap-1">
    <a href="#!" class="calendar-event calendar-event-navy is-past"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
    <a href="#!" class="calendar-event calendar-event-success is-past"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
    <a href="#!" class="calendar-event calendar-event-success is-past"><span class="calendar-event-time">1:30p</span><span class="calendar-event-title">Radio interview</span></a>
    <a href="#!" class="calendar-event calendar-event-danger"><span class="calendar-event-time">3p</span><span class="calendar-event-title">Physio check</span></a>
    <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span></a>
  </div>
</div>

Placing events

Set --bs-calendar-col to the weekday column (1–7) and, for multi-day events, --bs-calendar-span to the number of days. Put spanning events first in the source so they get the top rows. An event that crosses a week boundary is two elements, one per week, marked .is-continued-after and .is-continued-before to square off the joined ends.

<div class="calendar-week">
  <div class="calendar-days">
    <div class="calendar-day is-outside"><a class="calendar-date" href="…" aria-label="Monday 28 September">28</a></div>
    <div class="calendar-day is-today"><a class="calendar-date" href="…" aria-current="date">29</a></div>
    <div class="calendar-day is-weekend">…</div>
    <!-- 7 cells -->
  </div>
  <div class="calendar-events">
    <a class="calendar-event calendar-event-navy" href="…" style="--bs-calendar-col: 1; --bs-calendar-span: 3;">
      <span class="calendar-event-title">Ring camp</span>
    </a>
    <a class="calendar-event calendar-event-info is-continued-after" href="…" style="--bs-calendar-col: 6; --bs-calendar-span: 2;">…</a>
    <a class="calendar-event calendar-event-danger calendar-event-dot" href="…" style="--bs-calendar-col: 2;">
      <span class="calendar-event-time">9a</span><span class="calendar-event-title">Physio check</span>
    </a>
    <button type="button" class="calendar-more" style="--bs-calendar-col: 4;" popovertarget="more-29">
      +2<span class="calendar-more-label"> more</span>
    </button>
  </div>
</div>

Day states

ClassOnEffect
.is-today.calendar-day, .calendar-column-header, .calendar-mini-dayGold date badge. Also add aria-current="date" to the date link.
.is-outsideDay cell, mini dayA day from the previous or next month. Shaded, with a muted number.
.is-weekendDay cell, time-grid columnLight shading.
.is-selectedDay cell, mini dayGold ring (month) or navy fill (mini).
.is-disabledDay cell, mini dayHatched, struck through, not clickable.

"More" overflow

The calendar does not count events for you. When a day has more than fits, render the first few and a .calendar-more button. Give it the same --bs-calendar-col and point it at a popover that lists the whole day. In narrow months the label shrinks to "+2". Thursday 29 above has one.

Week view

.calendar-timegrid is a scroll box with a sticky head (column headers and an all-day row) and a body of hour columns. Set --bs-calendar-days, --bs-calendar-day-start and --bs-calendar-day-end on it. The grid draws hour and half-hour lines, and sizes every column from --bs-calendar-hour-height.

HTML
<div class="calendar-timegrid" style="--bs-calendar-days: 7; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23;" tabindex="0" role="region" aria-label="Week of October 26">
  <div class="calendar-timegrid-head">
    <div class="calendar-timegrid-row">
      <div class="calendar-timegrid-corner">CDT</div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Mon</span><a class="calendar-date" href="#!" aria-label="Monday 26 October">26</a></div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Tue</span><a class="calendar-date" href="#!" aria-label="Tuesday 27 October">27</a></div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Wed</span><a class="calendar-date" href="#!" aria-label="Wednesday 28 October">28</a></div>
      <div class="calendar-column-header is-today"><span class="calendar-column-weekday">Thu</span><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Fri</span><a class="calendar-date" href="#!" aria-label="Friday 30 October">30</a></div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Sat</span><a class="calendar-date" href="#!" aria-label="Saturday 31 October">31</a></div>
      <div class="calendar-column-header"><span class="calendar-column-weekday">Sun</span><a class="calendar-date" href="#!" aria-label="Sunday 1 November">1</a></div>
    </div>
    <div class="calendar-allday">
      <div class="calendar-allday-label">All day</div>
      <div class="calendar-allday-events">
        <a href="#!" class="calendar-event calendar-event-info is-continued-before" style="--bs-calendar-col: 1; --bs-calendar-span: 2;"><span class="visually-hidden">Sat 24 Oct – Tue 27 Oct: </span><span class="calendar-event-title">Scouting trip</span></a>
        <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-col: 5; --bs-calendar-span: 3;"><span class="visually-hidden">Fri 30 Oct – Sun 1 Nov: </span><span class="calendar-event-title">Halloween Havoc weekend</span></a>
      </div>
    </div>
  </div>
  <div class="calendar-timegrid-body">
    <div class="calendar-times" aria-hidden="true">
      <div class="calendar-time">7 AM</div>
      <div class="calendar-time">8 AM</div>
      <div class="calendar-time">9 AM</div>
      <div class="calendar-time">10 AM</div>
      <div class="calendar-time">11 AM</div>
      <div class="calendar-time">12 PM</div>
      <div class="calendar-time">1 PM</div>
      <div class="calendar-time">2 PM</div>
      <div class="calendar-time">3 PM</div>
      <div class="calendar-time">4 PM</div>
      <div class="calendar-time">5 PM</div>
      <div class="calendar-time">6 PM</div>
      <div class="calendar-time">7 PM</div>
      <div class="calendar-time">8 PM</div>
      <div class="calendar-time">9 PM</div>
      <div class="calendar-time">10 PM</div>
    </div>
    <div class="calendar-column" role="group" aria-label="Monday 26 October">
      <a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-26T09:00">9:00 AM</time> – <time datetime="2026-10-26T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary is-past" style="--bs-calendar-start: 11.5; --bs-calendar-end: 12.5;"><span class="calendar-event-title">Booking meeting</span><span class="calendar-event-time"><time datetime="2026-10-26T11:30">11:30 AM</time> – <time datetime="2026-10-26T12:30">12:30 PM</time></span><span class="calendar-event-meta">Office</span></a>
    </div>
    <div class="calendar-column" role="group" aria-label="Tuesday 27 October">
      <a href="#!" class="calendar-event calendar-event-danger is-past" style="--bs-calendar-start: 8; --bs-calendar-end: 9;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-27T08:00">8:00 AM</time> – <time datetime="2026-10-27T09:00">9:00 AM</time></span><span class="calendar-event-meta">Clinic</span></a>
      <a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 10; --bs-calendar-end: 12;"><span class="calendar-event-title">Tag team practice</span><span class="calendar-event-time"><time datetime="2026-10-27T10:00">10:00 AM</time> – <time datetime="2026-10-27T12:00">12:00 PM</time></span><span class="calendar-event-meta">Gym</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 18; --bs-calendar-end: 19;"><span class="calendar-event-title">Podcast taping</span><span class="calendar-event-time"><time datetime="2026-10-27T18:00">6:00 PM</time> – <time datetime="2026-10-27T19:00">7:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
    </div>
    <div class="calendar-column" role="group" aria-label="Wednesday 28 October">
      <a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 10.5; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Cardio block</span><span class="calendar-event-time"><time datetime="2026-10-28T09:00">9:00 AM</time> – <time datetime="2026-10-28T10:30">10:30 AM</time></span><span class="calendar-event-meta">Gym</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary is-tentative is-past" style="--bs-calendar-start: 9.5; --bs-calendar-end: 11; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Booking call</span><span class="calendar-event-time"><time datetime="2026-10-28T09:30">9:30 AM</time> – <time datetime="2026-10-28T11:00">11:00 AM</time></span><span class="calendar-event-meta">Phone</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary is-past" style="--bs-calendar-start: 14; --bs-calendar-end: 15;"><span class="calendar-event-title">Merch design review</span><span class="calendar-event-time"><time datetime="2026-10-28T14:00">2:00 PM</time> – <time datetime="2026-10-28T15:00">3:00 PM</time></span><span class="calendar-event-meta">Office</span></a>
    </div>
    <div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
      <a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-29T09:00">9:00 AM</time> – <time datetime="2026-10-29T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Promo taping</span><span class="calendar-event-time"><time datetime="2026-10-29T13:00">1:00 PM</time> – <time datetime="2026-10-29T14:00">2:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13.5; --bs-calendar-end: 14.25; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Radio interview</span><span class="calendar-event-time"><time datetime="2026-10-29T13:30">1:30 PM</time> – <time datetime="2026-10-29T14:15">2:15 PM</time></span><span class="calendar-event-meta">WRBK 101.5</span></a>
      <a href="#!" class="calendar-event calendar-event-danger" style="--bs-calendar-start: 15; --bs-calendar-end: 15.5;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-29T15:00">3:00 PM</time> – <time datetime="2026-10-29T15:30">3:30 PM</time></span><span class="calendar-event-meta">Clinic</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 22;"><span class="calendar-event-title">Thursday Night Throwdown</span><span class="calendar-event-time"><time datetime="2026-10-29T19:00">7:00 PM</time> – <time datetime="2026-10-29T22:00">10:00 PM</time></span><span class="calendar-event-meta">The Armory</span></a>
      <div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation" title="Now, 2:30 PM"></div>
    </div>
    <div class="calendar-column" role="group" aria-label="Friday 30 October">
      <a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-start: 7; --bs-calendar-end: 9;"><span class="calendar-event-title">Flight to Detroit</span><span class="calendar-event-time"><time datetime="2026-10-30T07:00">7:00 AM</time> – <time datetime="2026-10-30T09:00">9:00 AM</time></span><span class="calendar-event-meta">DTW · Gate B12</span></a>
      <a href="#!" class="calendar-event calendar-event-secondary" style="--bs-calendar-start: 12; --bs-calendar-end: 13;"><span class="calendar-event-title">Venue walkthrough</span><span class="calendar-event-time"><time datetime="2026-10-30T12:00">12:00 PM</time> – <time datetime="2026-10-30T13:00">1:00 PM</time></span><span class="calendar-event-meta">Little Caesars Arena</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-cancelled" style="--bs-calendar-start: 17; --bs-calendar-end: 17.75;"><span class="calendar-event-title">Press scrum</span><span class="calendar-event-time"><time datetime="2026-10-30T17:00">5:00 PM</time> – <time datetime="2026-10-30T17:45">5:45 PM</time></span><span class="calendar-event-meta">Media room</span></a>
    </div>
    <div class="calendar-column is-weekend" role="group" aria-label="Saturday 31 October">
      <a href="#!" class="calendar-event calendar-event-navy" style="--bs-calendar-start: 10; --bs-calendar-end: 11;"><span class="calendar-event-title">Light workout</span><span class="calendar-event-time"><time datetime="2026-10-31T10:00">10:00 AM</time> – <time datetime="2026-10-31T11:00">11:00 AM</time></span><span class="calendar-event-meta">Hotel gym</span></a>
      <a href="#!" class="calendar-event calendar-event-success" style="--bs-calendar-start: 16; --bs-calendar-end: 17;"><span class="calendar-event-title">Meet & greet</span><span class="calendar-event-time"><time datetime="2026-10-31T16:00">4:00 PM</time> – <time datetime="2026-10-31T17:00">5:00 PM</time></span><span class="calendar-event-meta">Concourse</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 23;"><span class="calendar-event-title">Halloween Havoc</span><span class="calendar-event-time"><time datetime="2026-10-31T19:00">7:00 PM</time> – <time datetime="2026-10-31T23:00">11:00 PM</time></span><span class="calendar-event-meta">Little Caesars Arena</span></a>
    </div>
    <div class="calendar-column is-weekend" role="group" aria-label="Sunday 1 November">
      <a href="#!" class="calendar-event calendar-event-info" style="--bs-calendar-start: 11; --bs-calendar-end: 13;"><span class="calendar-event-title">Flight home</span><span class="calendar-event-time"><time datetime="2026-11-01T11:00">11:00 AM</time> – <time datetime="2026-11-01T13:00">1:00 PM</time></span><span class="calendar-event-meta">DTW → ORD</span></a>
    </div>
  </div>
</div>

Timed events

A timed event is a .calendar-event inside a .calendar-column. --bs-calendar-start and --bs-calendar-end take decimal hours: 13.5 is 1:30 PM. Events can show a title, a .calendar-event-time and a .calendar-event-meta line. Each event is a size container, so short events drop the meta line and very short ones drop the time too.

<div class="calendar-timegrid" style="--bs-calendar-days: 7; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23;"
     tabindex="0" role="region" aria-label="Week of October 26">
  <div class="calendar-timegrid-head">
    <div class="calendar-timegrid-row">
      <div class="calendar-timegrid-corner">CDT</div>
      <div class="calendar-column-header is-today">
        <span class="calendar-column-weekday">Thu</span>
        <a class="calendar-date" href="…" aria-current="date">29</a>
      </div>
      <!-- one header per day -->
    </div>
    <div class="calendar-allday">
      <div class="calendar-allday-label">All day</div>
      <div class="calendar-allday-events">
        <a class="calendar-event calendar-event-primary calendar-event-solid" href="…"
           style="--bs-calendar-col: 5; --bs-calendar-span: 3;">…</a>
      </div>
    </div>
  </div>
  <div class="calendar-timegrid-body">
    <div class="calendar-times" aria-hidden="true">
      <div class="calendar-time">7 AM</div>
      <!-- one label per hour -->
    </div>
    <div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
      <a class="calendar-event calendar-event-success" href="…"
         style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;">
        <span class="calendar-event-title">Promo taping</span>
        <span class="calendar-event-time">1:00 PM – 2:00 PM</span>
        <span class="calendar-event-meta">Studio B</span>
      </a>
      <div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation"></div>
    </div>
    <!-- one column per day -->
  </div>
</div>

Overlapping events

Events that overlap share the column in lanes. Give each one --bs-calendar-lanes (how many share the slot) and --bs-calendar-lane (its position, from 0). Your server already knows which events collide, so it can assign lanes. Wednesday and Thursday above both have a two-lane overlap.

Now indicator

.calendar-now draws the red current-time line at --bs-calendar-start. It shows the time when the page was rendered and does not move. Put it in today's column only.

Day view

The day view is the same time grid with --bs-calendar-days: 1. With more room per event, a taller --bs-calendar-hour-height lets each one show its location.

HTML
<div class="calendar-timegrid" style="--bs-calendar-days: 1; --bs-calendar-day-start: 7; --bs-calendar-day-end: 23; --bs-calendar-hour-height: 3.5rem;" tabindex="0" role="region" aria-label="Thursday 29 October">
  <div class="calendar-timegrid-head">
    <div class="calendar-timegrid-row">
      <div class="calendar-timegrid-corner">CDT</div>
      <div class="calendar-column-header is-today"><span class="calendar-column-weekday">Thu</span><a class="calendar-date" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a></div>
    </div>
    <div class="calendar-allday">
      <div class="calendar-allday-label">All day</div>
      <div class="calendar-allday-events">
      </div>
    </div>
  </div>
  <div class="calendar-timegrid-body">
    <div class="calendar-times" aria-hidden="true">
      <div class="calendar-time">7 AM</div>
      <div class="calendar-time">8 AM</div>
      <div class="calendar-time">9 AM</div>
      <div class="calendar-time">10 AM</div>
      <div class="calendar-time">11 AM</div>
      <div class="calendar-time">12 PM</div>
      <div class="calendar-time">1 PM</div>
      <div class="calendar-time">2 PM</div>
      <div class="calendar-time">3 PM</div>
      <div class="calendar-time">4 PM</div>
      <div class="calendar-time">5 PM</div>
      <div class="calendar-time">6 PM</div>
      <div class="calendar-time">7 PM</div>
      <div class="calendar-time">8 PM</div>
      <div class="calendar-time">9 PM</div>
      <div class="calendar-time">10 PM</div>
    </div>
    <div class="calendar-column is-today" role="group" aria-label="Thursday 29 October">
      <a href="#!" class="calendar-event calendar-event-navy is-past" style="--bs-calendar-start: 9; --bs-calendar-end: 11;"><span class="calendar-event-title">Ring drills</span><span class="calendar-event-time"><time datetime="2026-10-29T09:00">9:00 AM</time> – <time datetime="2026-10-29T11:00">11:00 AM</time></span><span class="calendar-event-meta">Performance Center</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13; --bs-calendar-end: 14; --bs-calendar-lane: 0; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Promo taping</span><span class="calendar-event-time"><time datetime="2026-10-29T13:00">1:00 PM</time> – <time datetime="2026-10-29T14:00">2:00 PM</time></span><span class="calendar-event-meta">Studio B</span></a>
      <a href="#!" class="calendar-event calendar-event-success is-past" style="--bs-calendar-start: 13.5; --bs-calendar-end: 14.25; --bs-calendar-lane: 1; --bs-calendar-lanes: 2;"><span class="calendar-event-title">Radio interview</span><span class="calendar-event-time"><time datetime="2026-10-29T13:30">1:30 PM</time> – <time datetime="2026-10-29T14:15">2:15 PM</time></span><span class="calendar-event-meta">WRBK 101.5</span></a>
      <a href="#!" class="calendar-event calendar-event-danger" style="--bs-calendar-start: 15; --bs-calendar-end: 15.5;"><span class="calendar-event-title">Physio check</span><span class="calendar-event-time"><time datetime="2026-10-29T15:00">3:00 PM</time> – <time datetime="2026-10-29T15:30">3:30 PM</time></span><span class="calendar-event-meta">Clinic</span></a>
      <a href="#!" class="calendar-event calendar-event-primary calendar-event-solid" style="--bs-calendar-start: 19; --bs-calendar-end: 22;"><span class="calendar-event-title">Thursday Night Throwdown</span><span class="calendar-event-time"><time datetime="2026-10-29T19:00">7:00 PM</time> – <time datetime="2026-10-29T22:00">10:00 PM</time></span><span class="calendar-event-meta">The Armory</span></a>
      <div class="calendar-now" style="--bs-calendar-start: 14.5;" role="presentation" title="Now, 2:30 PM"></div>
    </div>
  </div>
</div>

Agenda view

.calendar-agenda is a list of days. Each .calendar-agenda-day has a sticky date heading beside its events. Below 36rem the heading becomes a bar across the top. Each .calendar-agenda-item is a link or button with a time column, a title and meta line, and an optional badge at the end. Empty days take a .calendar-agenda-empty line. The agenda is the most screen-reader-friendly view, so consider making it the default on small screens.

HTML
<div class="calendar-agenda">
  <section class="calendar-agenda-day is-today" aria-labelledby="calendar-agenda-day-2026-10-29">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-29"><span class="calendar-date" aria-current="date">29</span><span class="calendar-agenda-dayname">Thursday<small>October 2026 · Today</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-navy"><span class="calendar-agenda-time"><time datetime="2026-10-29T09:00">9:00 AM</time><span>– <time datetime="2026-10-29T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Ring drills</span><span class="calendar-agenda-meta">Performance Center</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-29T13:00">1:00 PM</time><span>– <time datetime="2026-10-29T14:00">2:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Promo taping</span><span class="calendar-agenda-meta">Studio B</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-29T13:30">1:30 PM</time><span>– <time datetime="2026-10-29T14:15">2:15 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Radio interview</span><span class="calendar-agenda-meta">WRBK 101.5</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-danger"><span class="calendar-agenda-time"><time datetime="2026-10-29T15:00">3:00 PM</time><span>– <time datetime="2026-10-29T15:30">3:30 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Physio check</span><span class="calendar-agenda-meta">Clinic</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><time datetime="2026-10-29T19:00">7:00 PM</time><span>– <time datetime="2026-10-29T22:00">10:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Thursday Night Throwdown</span><span class="calendar-agenda-meta">The Armory</span></span><span class="badge text-bg-primary">Live</span></a></li>
    </ul>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-10-30">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-30"><span class="calendar-date">30</span><span class="calendar-agenda-dayname">Friday<small>October 2026</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 1 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-info"><span class="calendar-agenda-time"><time datetime="2026-10-30T07:00">7:00 AM</time><span>– <time datetime="2026-10-30T09:00">9:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Flight to Detroit</span><span class="calendar-agenda-meta">DTW · Gate B12</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-secondary"><span class="calendar-agenda-time"><time datetime="2026-10-30T12:00">12:00 PM</time><span>– <time datetime="2026-10-30T13:00">1:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Venue walkthrough</span><span class="calendar-agenda-meta">Little Caesars Arena</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-success is-cancelled"><span class="calendar-agenda-time"><time datetime="2026-10-30T17:00">5:00 PM</time><span>– <time datetime="2026-10-30T17:45">5:45 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Press scrum</span><span class="calendar-agenda-meta">Media room</span></span><span class="badge text-bg-danger">Cancelled</span></a></li>
    </ul>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-10-31">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-10-31"><span class="calendar-date">31</span><span class="calendar-agenda-dayname">Saturday<small>October 2026</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 2 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-navy"><span class="calendar-agenda-time"><time datetime="2026-10-31T10:00">10:00 AM</time><span>– <time datetime="2026-10-31T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Light workout</span><span class="calendar-agenda-meta">Hotel gym</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-success"><span class="calendar-agenda-time"><time datetime="2026-10-31T16:00">4:00 PM</time><span>– <time datetime="2026-10-31T17:00">5:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Meet & greet</span><span class="calendar-agenda-meta">Concourse</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><time datetime="2026-10-31T19:00">7:00 PM</time><span>– <time datetime="2026-10-31T23:00">11:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc</span><span class="calendar-agenda-meta">Little Caesars Arena</span></span><span class="badge text-bg-primary">Live</span></a></li>
    </ul>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-01">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-01"><span class="calendar-date">1</span><span class="calendar-agenda-dayname">Sunday<small>November 2026</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-primary"><span class="calendar-agenda-time"><span>All day</span><span>Day 3 of 3</span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Halloween Havoc weekend</span><span class="calendar-agenda-meta">Detroit, MI</span></span></a></li>
      <li><a href="#!" class="calendar-agenda-item calendar-event-info"><span class="calendar-agenda-time"><time datetime="2026-11-01T11:00">11:00 AM</time><span>– <time datetime="2026-11-01T13:00">1:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Flight home</span><span class="calendar-agenda-meta">DTW → ORD</span></span></a></li>
    </ul>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-02">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-02"><span class="calendar-date">2</span><span class="calendar-agenda-dayname">Monday<small>November 2026</small></span></h4>
    <p class="calendar-agenda-empty">No bookings. Rest day.</p>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-03">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-03"><span class="calendar-date">3</span><span class="calendar-agenda-dayname">Tuesday<small>November 2026</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-danger"><span class="calendar-agenda-time"><time datetime="2026-11-03T10:00">10:00 AM</time><span>– <time datetime="2026-11-03T11:00">11:00 AM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Recovery session</span><span class="calendar-agenda-meta">Clinic</span></span></a></li>
    </ul>
  </section>
  <section class="calendar-agenda-day" aria-labelledby="calendar-agenda-day-2026-11-04">
    <h4 class="calendar-agenda-date" id="calendar-agenda-day-2026-11-04"><span class="calendar-date">4</span><span class="calendar-agenda-dayname">Wednesday<small>November 2026</small></span></h4>
    <ul class="calendar-agenda-list">
      <li><a href="#!" class="calendar-agenda-item calendar-event-secondary is-tentative"><span class="calendar-agenda-time"><time datetime="2026-11-04T11:00">11:00 AM</time><span>– <time datetime="2026-11-04T12:00">12:00 PM</time></span></span><span class="calendar-agenda-body"><span class="calendar-agenda-title">Booking meeting</span><span class="calendar-agenda-meta">Office</span></span><span class="badge text-bg-secondary">Tentative</span></a></li>
    </ul>
  </section>
</div>
<div class="calendar-agenda">
  <section class="calendar-agenda-day is-today" aria-labelledby="agenda-2026-10-29">
    <h4 class="calendar-agenda-date" id="agenda-2026-10-29">
      <span class="calendar-date" aria-current="date">29</span>
      <span class="calendar-agenda-dayname">Thursday<small>October 2026 · Today</small></span>
    </h4>
    <ul class="calendar-agenda-list">
      <li>
        <a class="calendar-agenda-item calendar-event-primary" href="…">
          <span class="calendar-agenda-time"><time datetime="2026-10-29T19:00">7:00 PM</time><span>– 10:00 PM</span></span>
          <span class="calendar-agenda-body">
            <span class="calendar-agenda-title">Thursday Night Throwdown</span>
            <span class="calendar-agenda-meta">The Armory</span>
          </span>
          <span class="badge text-bg-primary">Live</span>
        </a>
      </li>
    </ul>
  </section>
</div>

Set --bs-calendar-agenda-sticky-top when the page has a sticky header, so date headings stop below it.

Events

.calendar-event is the chip used in every view. It is a link, a button or plain text. Add a .calendar-event-{color} class for any theme colour, including gold, navy and cream.

Colours

Subtle (default)
HTML
<a class="calendar-event calendar-event-primary" href="#!"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Main event</span></a>
<a class="calendar-event calendar-event-navy" href="#!"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>
<a class="calendar-event calendar-event-gold" href="#!"><span class="calendar-event-time">4p</span><span class="calendar-event-title">Title presentation</span></a>
<a class="calendar-event calendar-event-success" href="#!"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<a class="calendar-event calendar-event-info" href="#!"><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>
<a class="calendar-event calendar-event-warning" href="#!"><span class="calendar-event-time">2p</span><span class="calendar-event-title">Contract review</span></a>
<a class="calendar-event calendar-event-danger" href="#!"><span class="calendar-event-time">3p</span><span class="calendar-event-title">Physio check</span></a>
<a class="calendar-event calendar-event-secondary" href="#!"><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking meeting</span></a>
<a class="calendar-event" href="#!"><span class="calendar-event-time">6p</span><span class="calendar-event-title">No colour class</span></a>

Styles

.calendar-event-solid fills the chip with the accent colour, which suits headline events. .calendar-event-dot drops the fill for a leading dot, which keeps busy month cells readable. The month view above uses solid chips for shows and dots for other timed events.

HTML
<a class="calendar-event calendar-event-primary calendar-event-solid" href="#!"><span class="calendar-event-time">7p</span><span class="calendar-event-title">Halloween Havoc</span></a>
<a class="calendar-event calendar-event-navy calendar-event-solid" href="#!"><span class="calendar-event-title">Ring camp</span></a>
<a class="calendar-event calendar-event-danger calendar-event-solid" href="#!"><span class="calendar-event-title">Injury report due</span></a>
<a class="calendar-event calendar-event-success calendar-event-dot" href="#!"><span class="calendar-event-time">1p</span><span class="calendar-event-title">Promo taping</span></a>
<a class="calendar-event calendar-event-info calendar-event-dot" href="#!"><span class="calendar-event-time">7a</span><span class="calendar-event-title">Flight to Detroit</span></a>

States

ClassEffect
.is-tentativeHatched fill and a dashed accent edge.
.is-cancelledStruck-through title, faded.
.is-pastFaded. The month and week examples above mark everything before 2:30 PM today.
.is-continued-before / .is-continued-afterSquare ends for multi-day events cut by a week edge.
HTML
<a class="calendar-event calendar-event-secondary is-tentative" href="#!"><span class="calendar-event-time">11a</span><span class="calendar-event-title">Booking call (maybe)</span></a>
<a class="calendar-event calendar-event-success is-cancelled" href="#!"><span class="calendar-event-time">5p</span><span class="calendar-event-title">Press scrum</span></a>
<a class="calendar-event calendar-event-navy is-past" href="#!"><span class="calendar-event-time">9a</span><span class="calendar-event-title">Ring drills</span></a>

Event details

Make the chip a <button popovertarget> and give the popover .calendar-popover plus the event's colour class. The header takes the colour as an accent edge, and .calendar-event-details lays out a <dl>. Several chips can open the same popover. In the full example above, the month, week, day and agenda entries for an event all share one.

Thursday Night Throwdown

When
Thu 29 Oct, 7:00 PM – 10:00 PM
Where
The Armory
Card
Six matches, title on the line
Open event
HTML
<button type="button" class="calendar-event calendar-event-primary calendar-event-solid" popovertarget="calendar-details-demo" style="max-width: 16rem;">
  <span class="calendar-event-time">7p</span><span class="calendar-event-title">Thursday Night Throwdown</span>
</button>
<div class="popover calendar-popover calendar-event-primary fade" popover id="calendar-details-demo" data-bs-placement="bottom">
  <div class="popover-arrow"></div>
  <h4 class="popover-header">Thursday Night Throwdown</h4>
  <div class="popover-body">
    <dl class="calendar-event-details">
      <dt>When</dt><dd>Thu 29 Oct, 7:00 PM – 10:00 PM</dd>
      <dt>Where</dt><dd>The Armory</dd>
      <dt>Card</dt><dd>Six matches, title on the line</dd>
    </dl>
    <div class="d-flex gap-2 mt-3">
      <a class="btn btn-sm btn-primary" href="#!">Open event</a>
      <button type="button" class="btn btn-sm btn-outline-secondary" popovertarget="calendar-details-demo" popovertargetaction="hide">Close</button>
    </div>
  </div>
</div>

Mini calendar

.calendar-mini is a compact month for sidebars and forms. With links it navigates. Add .has-events for a dot under busy days.

‹

October 2026

›
28 29 30 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 1
‹

October 2026

›
28 29 30 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 1
HTML
<div class="calendar-mini">
  <div class="calendar-mini-header">
    <a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
    <h4 class="calendar-mini-title">October 2026</h4>
    <a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
  </div>
  <div class="calendar-mini-grid">
    <span class="calendar-mini-weekday" aria-hidden="true">M</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">W</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">F</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Monday 28 September">28</a>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Tuesday 29 September">29</a>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Wednesday 30 September">30</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 1 October">1</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 2 October">2</a>
    <a class="calendar-mini-day" href="#!" aria-label="Saturday 3 October">3</a>
    <a class="calendar-mini-day" href="#!" aria-label="Sunday 4 October">4</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 5 October">5</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 6 October">6</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 7 October">7</a>
    <a class="calendar-mini-day" href="#!" aria-label="Thursday 8 October">8</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 9 October">9</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 10 October">10</a>
    <a class="calendar-mini-day" href="#!" aria-label="Sunday 11 October">11</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 12 October">12</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 13 October">13</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 14 October">14</a>
    <a class="calendar-mini-day" href="#!" aria-label="Thursday 15 October">15</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 16 October">16</a>
    <a class="calendar-mini-day" href="#!" aria-label="Saturday 17 October">17</a>
    <a class="calendar-mini-day" href="#!" aria-label="Sunday 18 October">18</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 19 October">19</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 20 October">20</a>
    <a class="calendar-mini-day" href="#!" aria-label="Wednesday 21 October">21</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 22 October">22</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 23 October">23</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 24 October">24</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Sunday 25 October">25</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 26 October">26</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 27 October">27</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 28 October">28</a>
    <a class="calendar-mini-day is-today is-selected has-events" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 30 October">30</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 31 October">31</a>
    <a class="calendar-mini-day is-outside has-events" href="#!" aria-label="Sunday 1 November">1</a>
  </div>
</div>
<div class="calendar-mini">
  <div class="calendar-mini-header">
    <a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
    <h4 class="calendar-mini-title">October 2026</h4>
    <a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
  </div>
  <div class="calendar-mini-grid">
    <span class="calendar-mini-weekday" aria-hidden="true">M</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">W</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">F</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Monday 28 September">28</a>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Tuesday 29 September">29</a>
    <a class="calendar-mini-day is-outside" href="#!" aria-label="Wednesday 30 September">30</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 1 October">1</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 2 October">2</a>
    <a class="calendar-mini-day" href="#!" aria-label="Saturday 3 October">3</a>
    <a class="calendar-mini-day" href="#!" aria-label="Sunday 4 October">4</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 5 October">5</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 6 October">6</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 7 October">7</a>
    <a class="calendar-mini-day" href="#!" aria-label="Thursday 8 October">8</a>
    <a class="calendar-mini-day is-selected has-events" href="#!" aria-label="Friday 9 October">9</a>
    <a class="calendar-mini-day is-in-range has-events" href="#!" aria-label="Saturday 10 October">10</a>
    <a class="calendar-mini-day is-in-range" href="#!" aria-label="Sunday 11 October">11</a>
    <a class="calendar-mini-day is-in-range has-events" href="#!" aria-label="Monday 12 October">12</a>
    <a class="calendar-mini-day is-selected has-events" href="#!" aria-label="Tuesday 13 October">13</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 14 October">14</a>
    <a class="calendar-mini-day" href="#!" aria-label="Thursday 15 October">15</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 16 October">16</a>
    <a class="calendar-mini-day" href="#!" aria-label="Saturday 17 October">17</a>
    <a class="calendar-mini-day" href="#!" aria-label="Sunday 18 October">18</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 19 October">19</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 20 October">20</a>
    <a class="calendar-mini-day" href="#!" aria-label="Wednesday 21 October">21</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Thursday 22 October">22</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 23 October">23</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 24 October">24</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Sunday 25 October">25</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Monday 26 October">26</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Tuesday 27 October">27</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Wednesday 28 October">28</a>
    <a class="calendar-mini-day is-today has-events" href="#!" aria-label="Thursday 29 October" aria-current="date">29</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Friday 30 October">30</a>
    <a class="calendar-mini-day has-events" href="#!" aria-label="Saturday 31 October">31</a>
    <a class="calendar-mini-day is-outside has-events" href="#!" aria-label="Sunday 1 November">1</a>
  </div>
</div>

Date picker

Wrap a radio in each <label class="calendar-mini-day"> and the mini calendar becomes a form control. The checked date gets the navy fill, arrow keys move between dates, and the form submits the value. Disabled radios grey their day out; here every day before today is disabled.

‹

October 2026

›
Pick a date
HTML
<form class="d-inline-flex flex-column gap-3" action="#!">
<div class="calendar-mini">
  <div class="calendar-mini-header">
    <a class="calendar-mini-nav" href="#!" aria-label="Previous month">‹</a>
    <h4 class="calendar-mini-title">October 2026</h4>
    <a class="calendar-mini-nav" href="#!" aria-label="Next month">›</a>
  </div>
  <fieldset class="calendar-mini-grid">
    <legend class="visually-hidden">Pick a date</legend>
    <span class="calendar-mini-weekday" aria-hidden="true">M</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">W</span>
    <span class="calendar-mini-weekday" aria-hidden="true">T</span>
    <span class="calendar-mini-weekday" aria-hidden="true">F</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <span class="calendar-mini-weekday" aria-hidden="true">S</span>
    <label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-28" aria-label="Monday 28 September" disabled>28</label>
    <label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-29" aria-label="Tuesday 29 September" disabled>29</label>
    <label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-09-30" aria-label="Wednesday 30 September" disabled>30</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-01" aria-label="Thursday 1 October" disabled>1</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-02" aria-label="Friday 2 October" disabled>2</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-03" aria-label="Saturday 3 October" disabled>3</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-04" aria-label="Sunday 4 October" disabled>4</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-05" aria-label="Monday 5 October" disabled>5</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-06" aria-label="Tuesday 6 October" disabled>6</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-07" aria-label="Wednesday 7 October" disabled>7</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-08" aria-label="Thursday 8 October" disabled>8</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-09" aria-label="Friday 9 October" disabled>9</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-10" aria-label="Saturday 10 October" disabled>10</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-11" aria-label="Sunday 11 October" disabled>11</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-12" aria-label="Monday 12 October" disabled>12</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-13" aria-label="Tuesday 13 October" disabled>13</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-14" aria-label="Wednesday 14 October" disabled>14</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-15" aria-label="Thursday 15 October" disabled>15</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-16" aria-label="Friday 16 October" disabled>16</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-17" aria-label="Saturday 17 October" disabled>17</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-18" aria-label="Sunday 18 October" disabled>18</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-19" aria-label="Monday 19 October" disabled>19</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-20" aria-label="Tuesday 20 October" disabled>20</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-21" aria-label="Wednesday 21 October" disabled>21</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-22" aria-label="Thursday 22 October" disabled>22</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-23" aria-label="Friday 23 October" disabled>23</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-24" aria-label="Saturday 24 October" disabled>24</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-25" aria-label="Sunday 25 October" disabled>25</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-26" aria-label="Monday 26 October" disabled>26</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-27" aria-label="Tuesday 27 October" disabled>27</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-28" aria-label="Wednesday 28 October" disabled>28</label>
    <label class="calendar-mini-day is-today"><input type="radio" name="calendar-pick" value="2026-10-29" aria-label="Thursday 29 October">29</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-30" aria-label="Friday 30 October">30</label>
    <label class="calendar-mini-day"><input type="radio" name="calendar-pick" value="2026-10-31" aria-label="Saturday 31 October" checked>31</label>
    <label class="calendar-mini-day is-outside"><input type="radio" name="calendar-pick" value="2026-11-01" aria-label="Sunday 1 November">1</label>
  </fieldset>
</div>
  <button type="submit" class="btn btn-primary btn-sm align-self-start">Book this date</button>
</form>
<fieldset class="calendar-mini-grid">
  <legend class="visually-hidden">Pick a date</legend>
  <span class="calendar-mini-weekday" aria-hidden="true">M</span>
  <!-- … -->
  <label class="calendar-mini-day"><input type="radio" name="date" value="2026-10-28" disabled>28</label>
  <label class="calendar-mini-day is-today"><input type="radio" name="date" value="2026-10-29">29</label>
  <label class="calendar-mini-day"><input type="radio" name="date" value="2026-10-31" checked>31</label>
</fieldset>

Filters and legend

A .calendar-legend fieldset holds one checkbox per colour. Give each .calendar-filter-check a value that names a theme colour. The checkbox takes that colour, and unchecking it hides every matching event in the enclosing .calendar. It also hides agenda list items. The checkboxes must be inside the .calendar. Try them in the full example. Use .calendar-legend-inline to lay them out in a row.

Calendars
HTML
<fieldset class="calendar-legend">
  <legend>Calendars</legend>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="primary" id="calendar-filters-filter-primary" checked>
    <label class="form-check-label" for="calendar-filters-filter-primary">Shows</label>
  </div>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="navy" id="calendar-filters-filter-navy" checked>
    <label class="form-check-label" for="calendar-filters-filter-navy">Training</label>
  </div>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="success" id="calendar-filters-filter-success" checked>
    <label class="form-check-label" for="calendar-filters-filter-success">Media</label>
  </div>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="info" id="calendar-filters-filter-info" checked>
    <label class="form-check-label" for="calendar-filters-filter-info">Travel</label>
  </div>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="danger" id="calendar-filters-filter-danger" checked>
    <label class="form-check-label" for="calendar-filters-filter-danger">Medical</label>
  </div>
  <div class="form-check">
    <input class="form-check-input calendar-filter-check" type="checkbox" value="secondary" id="calendar-filters-filter-secondary" checked>
    <label class="form-check-label" for="calendar-filters-filter-secondary">Admin</label>
  </div>
</fieldset>

For a legend with no filtering, use .calendar-swatch with a colour class:

  • Shows
  • Training
  • Media
  • Travel
HTML
<ul class="calendar-legend calendar-legend-inline">
  <li><span class="calendar-swatch calendar-event-primary"></span>Shows</li>
  <li><span class="calendar-swatch calendar-event-navy"></span>Training</li>
  <li><span class="calendar-swatch calendar-event-success"></span>Media</li>
  <li><span class="calendar-swatch calendar-event-info"></span>Travel</li>
</ul>

Responsive behaviour

Every view is a size container, so it responds to its own width. The breakpoints are $calendar-narrow (36rem) and $calendar-wide (52rem).

ComponentUnder 36rem52rem and over
.calendarTitle gets its own row; toolbar buttons shrink.Sidebar moves beside the views.
.calendar-monthChips become colour bars (text kept for screen readers); "+2 more" becomes "+2"; dates centre.—
.calendar-timegridColumns stay at least 7.5rem wide. The grid scrolls sideways, snaps one day at a time, and keeps the time gutter pinned.—
.calendar-agendaDate heading becomes a full-width sticky bar; time moves above the title.—

The same month and week at phone width (22rem), whatever your screen size:

Accessibility

  • Give the shell role="region" and an aria-label. Label the view switcher group.
  • Date links need a full date as their aria-label ("Thursday 29 October"). Today's date link also needs aria-current="date".
  • In the month view, the weekday header is aria-hidden, and events are read after the dates. Start each chip with visually hidden text that names its day, so it makes sense out of context. The time-grid columns are labelled groups, so this is not needed there.
  • The time grid scrolls, so give it tabindex="0", role="region" and a label. Keyboard users can then scroll it.
  • The view switcher, the filters and the date picker are native radios and checkboxes. They are keyboard operable and announce their state.
  • Colour is never the only signal. Tentative events are hatched, cancelled ones are struck through, and the agenda adds badges.
  • The agenda view is a list of headed sections. It is the easiest view to use with a screen reader, so offer it.

Event custom properties

PropertySet onMeaning
--bs-calendar-colMonth and all-day events, .calendar-moreStarting column, 1–7 (or 1–--bs-calendar-days).
--bs-calendar-spanMonth and all-day eventsNumber of days. Default 1.
--bs-calendar-startTimed events, .calendar-nowStart hour, decimal (9.25 = 9:15).
--bs-calendar-endTimed eventsEnd hour, decimal. Default start + 1.
--bs-calendar-lane / --bs-calendar-lanesTimed eventsPosition and count for side-by-side overlaps. Default 0 / 1.
--bs-calendar-days.calendar-timegridNumber of day columns. Default 7.
--bs-calendar-day-start / --bs-calendar-day-end.calendar-timegridFirst and last hour shown. Default 0 / 24.

CSS variables

Each part reads its own variables, scoped to its root class. Override them there, the Bootstrap way.

.calendar-event {
  --bs-calendar-event-bg: var(--bs-secondary-bg);
  --bs-calendar-event-color: var(--bs-emphasis-color);
  --bs-calendar-event-accent: var(--bs-secondary-color);
  --bs-calendar-event-contrast: var(--bs-body-bg);       // text on .calendar-event-solid
  --bs-calendar-event-font-size: 0.765625rem;
  --bs-calendar-event-padding-x: 0.375rem;
  --bs-calendar-event-padding-y: 0.125rem;
  --bs-calendar-event-border-width: 3px;
  --bs-calendar-event-border-radius: var(--bs-border-radius-sm);
}

.calendar-month {
  --bs-calendar-month-week-min-height: 7rem;
  --bs-calendar-month-date-height: 2.125rem;            // space reserved above event rows
  --bs-calendar-month-event-gap: 2px;
  --bs-calendar-month-border-color: var(--bs-border-color);
  --bs-calendar-month-header-bg: var(--bs-tertiary-bg);
  --bs-calendar-month-outside-bg: color-mix(in srgb, var(--bs-secondary-bg) 70%, transparent);
  --bs-calendar-month-weekend-bg: color-mix(in srgb, var(--bs-secondary-bg) 35%, transparent);
  --bs-calendar-month-selected-color: var(--bs-primary);
  --bs-calendar-today-bg: var(--bs-primary);
  --bs-calendar-today-color: var(--color-accent-fg);
}

.calendar-timegrid {
  --bs-calendar-hour-height: 3rem;
  --bs-calendar-gutter-width: 4.25rem;
  --bs-calendar-gutter-width-narrow: 3.25rem;
  --bs-calendar-col-min: 5.5rem;                         // minimum day width when wide
  --bs-calendar-col-min-narrow: 7.5rem;                  // … and under 36rem
  --bs-calendar-timegrid-max-height: 36rem;
  --bs-calendar-timegrid-line: var(--bs-border-color-translucent);
  --bs-calendar-now-color: var(--bs-danger);
}

.calendar-agenda {
  --bs-calendar-agenda-date-width: 9rem;
  --bs-calendar-agenda-time-width: 10.5rem;
  --bs-calendar-agenda-sticky-top: 0;
}

.calendar-mini {
  --bs-calendar-mini-cell-size: 2.25rem;
  --bs-calendar-mini-selected-bg: var(--bs-navy);        // cream-100 in dark mode
  --bs-calendar-mini-range-bg: var(--bs-primary-bg-subtle);
  --bs-calendar-mini-dot-color: var(--bs-primary);
}

Sass

$calendar-views: day, week, month, agenda !default;   // names accepted by data-calendar-view
$calendar-narrow: 36rem !default;                     // chips → bars, grid scrolls, agenda stacks
$calendar-wide: 52rem !default;                       // sidebar beside the views