Creating Events

PrimeCal uses one shared event modal, so the creation flow stays familiar no matter where you start.

Common Entry Points

• Quick add, the main button in the workspace header, or Q: type the event as a sentence (below). On a phone it is the floating + button
• New event, first in the arrow beside it, or C: the full editor with every field. On a phone it is next to Quick add in the floating button's list
• Clicking a day in Month view
• Clicking or dragging down a day in Week view (the quick-create popover, below)
• Creating from the live Focus timeline

If every calendar you can see is read-only - all of them shared with you for viewing - Quick add and the quick-create card say so ("No calendar to add this to") and offer no Save, instead of an empty list of calendars. Create a calendar of your own from the calendar list and they work again. In a column of the People view, the + is simply not shown for a calendar you cannot write to.

Quick Create In The Week View

The fastest way to add an event with a time is to pick the time on the grid.

1. Click a slot to start a one-hour event there, or press and drag down a day to cover exactly the time you need. Everything snaps to quarter-hours.
2. A small popover opens beside the selection. Type the title; the calendar you used last is already chosen.
3. Press Enter (or Save). A confirmation appears with an Undo button.

Need more than a title? Change the start and end times or the calendar in the popover itself, or choose More options - the full event editor opens with your title, calendar and times already filled in, so nothing you typed is lost. Press Esc, or click elsewhere, to drop the selection without creating anything.

Quick Add: Type It As A Sentence

When you already know what and when, say it in one line. Click Quick add in the header (or press Q), type, and press Enter. It is the first button on purpose: the quick way is the one you reach for most, so it takes one click, and the full editor is the first item in the arrow beside it. On a phone, tap the floating + button and then Quick add, the entry closest to your thumb (when there is nothing else to create it opens at once); the same panel opens as a sheet from the bottom.

Lunch with Sam tomorrow 12:30-14:00 Dentist friday 3pm for 45 min Offsite all day next monday

A line under the field says how the sentence was read - the day and the hours - before anything is saved, so a wrong guess is visible and one edit fixes it. Whatever is not understood stays in the title, so nothing you typed is lost.

You type	It means
today, tomorrow, day after tomorrow	That day
friday, next friday, on fri	The next Friday after today (write today for today)
2026-03-12, March 12, 12 March	That date; with no year, the next one that has not passed
3pm, 15:30, at 3:30 pm	The start time
12:30-14:00, 2-3pm, 2pm to 3pm	The start and the end
for 45 min, 1h30, 2 hours	How long it lasts
all day	An all-day event
@Family, @fam	The calendar to create it in: a calendar's whole name, or the beginning of a name that only one calendar starts with (@Team Calendar also works). A name no calendar has stays in the title
#health, #team-sync	A label for the event; add as many as you like. A number such as #42 is not a label
every monday, mondays, daily, weekly, monthly, yearly	Repeats the event. every monday also picks the first Monday as the day, unless you wrote a day
every weekday, every 2 weeks, every 3 months, every other week	Repeats it on Monday to Friday, or every second, third... week, month, year or day

A repeat never ends: quick add makes the same repeating event the full editor would with "never", and More options hands it over so you can set an end. The line under the sentence says how it was read ("Repeats every Monday · #team") before you save. When the sentence names a calendar, the calendar field below it shows that calendar and stands back; delete the @ word to choose by hand again.

Anything you leave out is filled in: no day means the day selected in the calendar (else today); no time means the next half hour when the day is today, or 09:00 on another day; no length means an hour. The calendar you used last is already chosen, and the field under the sentence changes it.

A few things worth knowing:

• A bare number is not a time. meeting about 3 keeps its 3; write 3pm or 15:00.
• In English, 2:30 with no am/pm is taken as the afternoon, because nobody schedules 2:30 in the morning. Write 2:30am if you do mean the small hours.
• Weekday short forms such as fri count only after on, next or this, so a title like "Sat nav manual" is left alone.
• When the app is in Hungarian, German or French, the words of that language work too (holnap 14:00, morgen um 15 Uhr, demain à 9h); English always works.

In Focus Mode, which has no Create button in its toolbar, quick add is in the floating + button's list (and Q).

Simple mode turns this around, because its promise is a labelled list of questions rather than a sentence for the app to read: its main button is Add appointment, which opens the form, and quick add is the first item in the arrow beside it, called Add by typing.

Need more than a sentence? Choose More options - the full event editor opens with the title, day, hours, calendar, labels and repeat already filled in, so nothing you typed is lost. Esc closes the panel without creating anything.

Find A Time

When you need a gap rather than a guess, open the arrow beside Quick add and choose Find a time. Say how long you need (30 minutes to 2 hours), between which hours of the day you would consider it (09:00 to 17:00 to begin with) and whether the weekend counts, and the panel lists up to six free slots over the next two weeks: the first free quarter-hour of each gap that is long enough, earliest first. Click one and the event editor opens at that time, ready for a title.

• It looks at the calendars you are showing. Hide a calendar and its events stop counting as busy.
• All-day events (a birthday, a public holiday) block nothing; an event with times blocks every day it runs through.
• The answer follows the length and hours at once, with no wait, and the panel remembers them on this device.

The Shared Event Modal

Fields Users Work With Most

Field	Typical use
Title	Short event name that is easy to scan
Calendar	The calendar that owns the event
Start and end	Date and time placement
All-day	Full-day plans, travel, birthdays, holidays
Location	School, meeting place, home, clinic, store
Notes	Agenda, checklist, meeting details
Labels	Reusable tags for filtering and Focus behavior
Color	Optional event-specific emphasis
Recurrence	Routines that repeat on a schedule

Practical Creation Flow

1. Start from the view that gives you the right time context.
2. Confirm the calendar first.
3. Fill the title and schedule.
4. Add location, labels, or notes only when they help.
5. Use recurrence for routines.
6. Save and confirm the result in the view you care about most.

When To Use Labels And Colors

• Use labels for meaning, filtering, and Focus behavior.
• Use calendar colors for broad categories like family, work, or school.
• A new event shows in its calendar's color. Pick Calendar color in the event editor to go back to that after choosing a color of its own.
• Use event colors only when a single event needs to stand out from the rest of its calendar.

After Saving

Check the event in more than one view:

• Month view for overall planning
• Week view for exact time placement
• Focus view for live and next-up behavior

Continue Reading

• Calendar Views
• Focus Mode And Live Focus
• Calendar Workspace

Developer Reference

For request and recurrence details, use the Event API.