> ## Documentation Index
> Fetch the complete documentation index at: https://harnesscalendar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotations

> Paint time overlays on your calendar to mark availability or blocked time.

An annotation is a backdrop, not an event: it paints a pattern on your calendar (your teaching hours, "open for new students") so you can see it at a glance. It holds no students, notes, or charge, only you see it, and it doesn't block anything. To control when people can book you, use a [scheduling link](/docs/calendar/scheduling-links).

## Weekly windows vs ad-hoc windows

Every annotation is built from time windows, in one of two shapes.

* **Weekly windows** repeat. Set a day of the week and a time range, and the overlay paints on that day every week.
* **Ad-hoc windows** are one-off. Set a specific date and a time range, and the overlay paints only on that date.

## Steps

<Steps>
  <Step title="Open the Annotations panel">
    On the calendar, click **Annotations** in the header.
  </Step>

  <Step title="Start a new annotation">
    Click **+** at the top of the panel. Harness creates one and opens it for
    editing. Give it a name ("Studio time") and pick its **Calendar color** so
    you can tell its bars apart.
  </Step>

  <Step title="Choose the window type">
    Under **Availability type**, pick **Weekly windows** or **Ad-hoc windows**.
  </Step>

  <Step title="Add your windows">
    For weekly, set a day and a time range; for ad-hoc, set a date and a time range. Add as many
    rows as you need.
  </Step>
</Steps>

Changes save as you make them. Close the panel with the **X** when you're done.

## Edit an annotation

Open it from either side of the calendar:

* In the **Annotations** panel, click any annotation in the list.
* On the grid, click one of its **bars**.

To hide an annotation from the grid without deleting it, click the **eye** icon on its row in the list. Click it again to show it.

## Remove an annotation

In the **Annotations** list, open the row's **⋯** menu and choose **Delete**, or use the trash icon inside the edit form. Confirm in the dialog. Deleting is permanent.

<Warning>
  If a scheduling link uses this annotation as its availability, the edit form
  lists it under **Connected scheduling links**. Deleting the annotation doesn't
  break those links: each one takes its own copy of the windows at that moment
  and keeps working on its own.
</Warning>

## Drive a scheduling link from an annotation

A scheduling link can use an annotation as its availability. While it's connected, the two stay in sync: editing the annotation's windows updates the link live. The connection breaks in two cases, and the link then keeps its own copy of the windows from that moment on:

* You edit the availability windows on the **link** directly.
* You delete the annotation (see the warning above).

Connected links are listed under **Connected scheduling links** in the annotation's edit form, and you can click through to each one.

## FAQ

<AccordionGroup>
  <Accordion title="What's the difference between an annotation and an event?">
    An event is a real thing on your calendar: a lesson, a meeting, a committed
    block of time. An annotation is a backdrop that marks a pattern, like the
    hours you teach.
  </Accordion>
</AccordionGroup>