Documentation
How Weekwright works.
23 articles covering the whole product — building and publishing schedules, the AI agent, compliance rules, your team, billing and the API. Written to be read, not skimmed for keywords.
Getting started
The mental model, the first week, and bringing your data across.
- managersowners
What Weekwright is, and the six words it uses
The mental model behind the product: organizations, locations, positions, schedules, weeks, and shifts. Read this once and every other page makes sense.
Read - managersowners
Quickstart: your first published week
From signing up to a schedule your team can see, in about fifteen minutes. Five steps, in the order the product expects them.
Read - managersowners
Roles and permissions
Four roles — Owner, Admin, Manager, Employee — what each one can reach, and how the permission check actually works underneath.
Read - managersowners
Importing your roster and your existing schedule
Paste a CSV export from your current tool or a spreadsheet. Columns are detected for you, every row is previewed before anything is written, and nothing is imported until you confirm.
Read
Scheduling
Building weeks, publishing them, and everything that moves a shift.
- managers
Building a week
The five views of the week grid, how to add and move shifts, the bulk actions that save the most time, and what happens when two managers edit at once.
Read - managers
Publishing a schedule
What publishing actually does, the compliance pre-flight that runs first, how people confirm they have seen it, and what happens when you need to change a published week.
Read - managers
Schedule templates and recurring weeks
Save a week you like and reuse its layout on any future week — by hand, or automatically every Sunday. Including the guard rails that stop a recurrence from touching real work.
Read - managersemployees
Open shifts
Post coverage you cannot fill and let eligible staff claim it. Who is eligible, how the approval gate works, and why a claim can still be refused.
Read - managersemployees
Shift swaps
Let staff trade shifts between themselves, with or without your approval. How candidates are suggested, what each status means, and where reciprocity shows up.
Read
AI and insights
The scheduling agent, what runs on its own, and the analytics on top.
- managersemployeesCore and up
The AI scheduling agent
What the assistant can actually do, how a week gets drafted, why nothing is written without your say-so, and how to talk to it so it gets the week right first time.
Read - managersowners
Automatic drafts and the Sunday briefing
Three scheduled jobs run on Sunday so Monday is not a blank page: template recurrence, a seeded draft of next week, and a manager digest that reaches you in Slack or Teams.
Read - managersownersPro and up
Insights and analytics
The analytical layer on top of the agent: why a person got a shift, how the load falls across weeks, who is drifting, where coverage is thin, and whether breaks are being taken.
Read
Your team
People, availability, time off, and the qualifications that gate a shift.
- managersowners
Inviting and managing your team
How invites work, what a member record actually holds, the four employment statuses and why you should use them instead of deleting people.
Read - managersemployees
Availability and time off
The difference between a recurring availability pattern and a dated time-off request, how each one affects scheduling, and the seven request types.
Read - managers
Skills and qualifications
Define what a position requires, record who holds what, set an expiry on the certifications that have one, and let the schedule enforce it instead of your memory.
Read
Compliance
Encoding the rules you operate under so the schedule enforces them.
For employees
Written for team members rather than managers.
- employees
Guide for employees
Everything you can do as a team member: see your week, set your availability, book time off, swap a shift, pick up extra hours, and get your shifts into your own calendar.
Read - employeesmanagers
The time clock, breaks and geofencing
Clocking in and out, recording breaks, and how the optional location fence works — including what it does and does not do with your staff's location.
Read
Admin
Billing, notifications, security and the audit trail.
- owners
Plans and billing
Why the bill is per location rather than per employee, what each plan unlocks, how the trial works, and what happens when a payment fails.
Read - managersemployees
Notifications
What gets sent, to whom, through which channel, and how to mute the parts you do not want without losing the parts you do.
Read - ownersmanagers
Security and the audit log
How tenants are isolated, what the audit log records, and the recovery paths that exist when somebody deletes the wrong thing.
Read
Developers
The API, webhooks, and getting your data out.
- developers
API and webhooks
One RPC endpoint exposes every operation in the product, authenticated by a scoped org key. Outbound webhooks are signed and retried. Reference for both.
Read - managersowners
Payroll and exports
Export a pay period as CSV in the shape Gusto, QuickBooks or ADP expects, dump a week's shifts, or subscribe a personal calendar feed.
Read
Not finding it?
A question these pages cannot answer is a page we still owe you — tell us and we will write it. For deeper reading, the blog covers the thinking behind particular decisions, the changelog records what shipped and when, and scheduling laws tracks what US state predictive-scheduling rules currently require.
Ask a questionTry Weekwright free for up to 20 employees.
No credit card required.