docs: event tags blog post + tags documentation for 2026.07.15

one-kash · one-kash · commit 73b5f660b8ca · 2026-07-16T00:43:34.000Z
Add the release blog post for event tags, a dedicated Tags doc page, and
cross-link it from the event form, Quick Add, and calendar views pages.
diff --git a/blog/2026-07-15-kashcal-event-tags.md b/blog/2026-07-15-kashcal-event-tags.md
@@ -0,0 +1,55 @@
+---
+slug: kashcal-event-tags
+title: "Tags: label your events, not just file them"
+authors: [kashcal]
+tags: [releases, announcements]
+keywords:
+  - kashcal release notes
+  - kashcal changelog
+  - android calendar tags
+  - calendar event tags android
+  - tag events quick add android
+  - caldav calendar tags
+description: "KashCal 2026.07.15 adds event tags: colored #chips you set in the form or type into Quick Add, shown across the day, week, and agenda views. Plus fixes for zero-length events, synced emoji, and duration edge cases. Here's what changed."
+image: /img/social/home.png
+---
+
+Since the beginning of KashCal, your events have been sorted the way a coat check sorts coats: by which calendar you flung them into, and not one thought more. This release lets you label them yourself. Meet tags.
+
+{/* truncate */}
+
+## Type a #tag, get a chip
+
+Add a tag in the [event form](/docs/events/event-form), or fling a `#dentist` straight into [Quick Add](/docs/events/quick-add) and watch it land as a colored chip. That chip then follows the event around the [day, week, and agenda views](/docs/calendar/views) like it owns the place. Tap the event open and the tags are right there in quick view, quietly confirming that yes, this is a `#focus` block, and no, it is not the third `#standup` of the day you had every right to skip.
+
+Start typing and KashCal hands back the tags you already use, ranked by how often you reach for them. It is the only known cure for "Errands" quietly fracturing into "errands," "ERRANDS," and one deeply confident "Errnads" by Thursday.
+
+And if you decide tags belong above your notes rather than below, the row's little ⋮ menu will move it, and we will pretend that was our idea all along.
+
+## The honest fine print
+
+Tags currently work on the events KashCal syncs itself: your iCloud and other CalDAV calendars. The device's own calendars, the Google, Samsung, and Exchange ones Android politely shoves through the door, are still tag-free for a release or two while we teach them manners. Rather than let your tags quietly vanish into the void, we simply hide the tag row on those events for now.
+
+This is version one of roughly several. More tags, more places, more tricks are queued up.
+
+## While we had the tweezers out
+
+A few papercuts, gone:
+
+- Events with no length, the ones you pin to a single moment, used to disappear entirely in the day and week views. They now show up as the small blocks they always meant to be, and no longer draw on top of each other when they overlap.
+- Emoji in a synced description arrive as the emoji you sent, instead of a puzzled little box.
+- A garbled duration from some other app can no longer bend an event's end time back to before it started.
+
+## Everything in this release
+
+- Event tags: colored chips on events, shown in the day, week, and agenda views and in the event quick view, on iCloud and CalDAV events for now
+- Create tags from the event form with usage-ranked suggestions and inline `#` autocomplete in the title
+- Add tags from Quick Add by typing `#tag`, persisting across create and all edit scopes
+- Reorder the form tag row above or below notes from its ⋮ menu
+- Tidied the event-form layout, and moved the location field up under the title
+- Fixed zero-length and very short events vanishing or overlapping in the day, 3-day, and week views
+- Fixed emoji and other extended characters in synced descriptions rendering as a stray box or wrong character
+- Fixed a malformed event duration producing an end time before the start
+- Fixed self-hosted CalDAV/ICS sync hanging on "Preparing to sync" over LAN or VPN networks
+
+Small labels, better plumbing, fewer papercuts. Tag it and move on.
diff --git a/docs/calendar/views.md b/docs/calendar/views.md
@@ -39,6 +39,12 @@ under your thumb:
 In **Month** and **Year** views, swipe left and right to move between months or
 years, and tap a day or month to drill in.
 
+## Tag chips
+
+Events you've labeled with [tags](../events/tags.md) show their colored chips in
+the Day, Week, and Agenda views, so you can pick out a `#focus` block or a
+`#travel` day at a glance without opening the event.
+
 ## Moving around
 
 - **Today.** Tap the Today button to jump back to the current date in any view.
@@ -57,3 +63,4 @@ starting the form over.
 
 - [Widgets](../features/widgets.md): put your calendar on the home screen
 - [Search](../features/search.md): find any event fast
+- [Tags](../events/tags.md): label events with colored chips
diff --git a/docs/events/event-form.md b/docs/events/event-form.md
@@ -23,6 +23,7 @@ edit it. Everything lives on one screen, no digging through menus.
 - **Time zone.** Events use your device time zone by default, but you can set a specific one.
 - **Repeat.** Make the event recurring. See [Recurring events](./recurring.md).
 - **Color.** Give the event its own color. See [Event colors](./colors.md).
+- **Tags.** Label the event with colored chips like `#focus` or `#dentist`, with suggestions from tags you've used before. See [Tags](./tags.md).
 - **Alerts.** Add reminders. See [Reminders](./reminders.md).
 - **Availability.** Mark the event as **Busy** or **Free**, which controls whether it blocks your time for others.
 - **Attendees.** Invite people. See [Scheduling & invitations](./attendees.md).
@@ -51,3 +52,4 @@ See [Recurring events](./recurring.md) for the details.
 - [Quick Add](./quick-add.md): the faster way to create events
 - [Recurring events](./recurring.md): make an event repeat
 - [Reminders](./reminders.md): get alerted before it starts
+- [Tags](./tags.md): label events with colored chips
diff --git a/docs/events/quick-add.md b/docs/events/quick-add.md
@@ -58,6 +58,12 @@ sentence.
 - Anything after **at** becomes the location: `Lunch at Olive Garden`,
   `Meeting at Conference Room B`
 
+### Tags
+
+- Put `#` in front of a word to add it as a tag: `Lunch with Sam #social`,
+  `Deep work #focus`. You can add several, and KashCal keeps the rest of the
+  phrase as the event. See [Tags](./tags.md).
+
 ## Examples
 
 | You type | KashCal creates |
@@ -67,6 +73,7 @@ sentence.
 | `Lunch with Sam Friday 12:30 for 1 hour` | "Lunch with Sam", this Friday 12:30-1:30 PM |
 | `Book club every Tuesday until December` | "Book club", weekly on Tuesday, ending in December |
 | `Dentist in 2 weeks at 10am` | "Dentist", two weeks out at 10:00 AM |
+| `Deep work 2pm #focus` | "Deep work", today at 2:00 PM, tagged #focus |
 
 ## The live preview
 
diff --git a/docs/events/tags.md b/docs/events/tags.md
@@ -0,0 +1,67 @@
+---
+sidebar_position: 6
+title: Tags
+---
+
+import Screenshot from '@site/src/components/Screenshot';
+
+# Tags
+
+Calendars sort your events by which account they live in. Tags let you label them
+by what they *are*: `#focus`, `#dentist`, `#standup`, `#travel`. A tag shows up as
+a small colored chip on the event, so you can spot a kind of event at a glance
+across your week.
+
+## Adding tags
+
+You can add a tag two ways:
+
+- **In the [event form](./event-form.md).** Type a name into the tag field and
+  confirm it, or pick one from the suggestions. Suggestions are ranked by how
+  often and how recently you've used each tag, so the ones you reach for most sit
+  first.
+- **In [Quick Add](./quick-add.md).** Type `#` in front of a word anywhere in your
+  phrase, like `Lunch with Sam #social`, and KashCal peels the `#social` off as a
+  tag while the rest becomes the event. You can add several, and a tags-only entry
+  like `#work` is fine too.
+
+The title field also offers an inline `#` autocomplete: start typing `#` in the
+title and KashCal suggests your existing tags.
+
+## Where tags show up
+
+Once an event has tags, its chips appear in the **day**, **week**, and **agenda**
+views, and in the event's quick view when you tap it open. Open the full event and
+the tags are listed there as well.
+
+If you'd rather the tag row sit above your notes than below, use the row's **⋮**
+menu in the form to move it. KashCal remembers your choice.
+
+## How tags are matched and stored
+
+- **Case-insensitive, first-casing wins.** `Work` and `work` are the same tag.
+  Whichever spelling you used first is the one KashCal keeps and shows, so your
+  tag list doesn't fracture into near-duplicates.
+- **Up to 64 characters,** with no commas (commas are reserved by the calendar
+  format tags are stored in).
+- **Stored as standard calendar categories.** Tags are saved as the event's
+  `CATEGORIES`, part of the iCalendar standard, which is why they travel with the
+  event when it syncs.
+
+## What tags don't do (yet)
+
+Tags currently work on the events KashCal syncs itself: your **iCloud and other
+[CalDAV](../sync/supported-servers.md) calendars**, plus local calendars. Events
+that come from the **device's own calendars** (the Google, Samsung, or Exchange
+accounts Android manages, see [Device calendars](../sync/device-calendars.md)) are
+tag-free for now, so KashCal hides the tag row on those events rather than letting
+a tag you add quietly disappear.
+
+This is the first release of tags. More places and more ways to use them are on
+the way.
+
+## Related
+
+- [Creating & editing events](./event-form.md): the full event form
+- [Quick Add](./quick-add.md): type `#tag` inline
+- [Calendar views](../calendar/views.md): where chips appear
