> For the complete documentation index, see [llms.txt](https://docs.range-mate.co.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.range-mate.co.uk/for-club-admins/public-calendars.md).

# Public Calendars

A calendar is a filtered, always-up-to-date view of your events that you can share outside the members area. You can publish the same calendar three ways, and each one refreshes on its own as you add or change events:

1. **Subscribe** to it in a calendar app (Google Calendar, Apple Calendar, Outlook).
2. **View** it as a web page in any browser.
3. **Embed** it on your own website inside a small frame.

You can create as many calendars as you like, each filtered differently. For example, publish a guest day calendar on your public website while keeping a member-only calendar for everyone signed in.

## Creating a calendar

Go to your **Events** page and tap the calendar icon in the top corner to open **Calendars**, then choose **New Calendar**.

You can set:

* **Name** — shown to viewers, with your club's short name alongside it.
* **How far back and forward** the calendar reaches (for example, the past 7 days and the next 60).
* **Locations** — optional. Limit the calendar to events at particular locations.
* **Guest events** and **event audience** — optional filters, so a calendar can show only guest days, or only junior sessions, and so on.
* **Default view** — whether the calendar opens on the **agenda** (a list grouped by date) or the **month** grid. Viewers can switch between the two while they look.
* **Private** — see [Who can see a calendar](#who-can-see-a-calendar) below.

## The three ways to share

On the calendars list, each calendar has its own buttons.

### Subscribe (calendar apps)

**Subscribe** hands the calendar to a calendar app so it appears alongside someone's own events and keeps itself updated. **Copy** copies the same feed link, which is handy for pasting into an app that asks for a URL. This is the classic feed and it works exactly as before.

### View (a web page)

**View** opens the calendar as its own web page. It shows your club name and logo, an agenda list and a month grid (viewers can switch between them), and a **Subscribe** button. It works on a phone as well as a computer. Tapping an event opens a panel with its date, time, location and description, and an **Open event page** button that takes the viewer to your booking page in a new tab.

### Embed (on your website)

**Embed on your website** reveals a short snippet of HTML. Paste it into your website builder (WordPress, Wix, Squarespace, or a plain HTML page) where you want the calendar to appear, and your events show up in a frame that updates itself.

{% hint style="info" %}
The embedded calendar opens in a light theme by default, to sit nicely on most websites. To match a dark website, add `?theme=dark` to the end of the address in the snippet.
{% endhint %}

## Who can see a calendar

A calendar is reached by a unique link, and **anyone who has that link can open it**, whether or not they are a member. That is what makes it shareable and embeddable.

The **Private** setting only controls whether the calendar shows in the members area list. A private calendar is still reachable by its link, so use private calendars for links you share deliberately rather than for anything sensitive.

{% hint style="warning" %}
A calendar only ever shows public event information: the name, date and time, location, and description. It never shows who is booked, how many spaces are left, or any member details. Don't treat the **Private** toggle as a lock.
{% endhint %}