How to Create an On-Call Handoff Document in Notion
On-call handoffs are where institutional knowledge either transfers or gets lost. When the outgoing engineer has no structured way to pass context to the incoming engineer, incidents get re-investigated from scratch and workarounds are forgotten. A good on-call handoff document reduces the time to effectiveness for the incoming engineer from hours to minutes.
This guide covers how to build an on-call handoff system in Notion with a structured handoff template, active incident log, known issue tracker, and the async workflow that makes every shift transition a 10-minute process instead of a 30-minute call.
Step-by-step guide
Create the On-Call workspace in Notion
Create a Notion page called "On-Call" in your engineering workspace. Add three child databases: Handoff Notes (one entry per shift), Known Issues (persistent log of ongoing quirks and workarounds), and Escalation Contacts (who to call for specific systems). Pin this page to the engineering sidebar. Every engineer on the on-call rotation should have it bookmarked and accessible without search.
Build the Handoff Notes database
Create a database called "Handoff Notes" with properties: Shift (title — e.g. "Week of Aug 25"), Engineer (person — the outgoing on-call), Start Date (date), End Date (date), Status (select: Active, Handed Off), Active Incidents (number — count of open incidents), and Escalations Made (number — how many times the on-call escalated during the shift). Each week creates one entry. The incoming engineer reads the most recent Handed Off entry.
Create the handoff entry template
Create a template in the Handoff Notes database. Template sections: Current State callout block (one paragraph describing the current health of production — "All systems nominal" or "Elevated error rate on payments service, monitoring with PagerDuty alert #1234"), Active Incidents section (linked database view of Known Issues filtered to "Active" status — lists ongoing issues the incoming engineer inherits), Actions Taken This Shift (bulleted log — what did the outgoing engineer do during the shift?), Decisions Made (any judgment calls made during the shift and the reasoning), Things to Watch (2-3 specific items the incoming engineer should monitor in the first hour), and Scheduled Events (any planned maintenance, deployments, or changes in the next 24 hours).
Build the Known Issues database
Create a "Known Issues" database with: Issue (title — one sentence), Status (select: Active, Monitoring, Resolved), Severity (select: P0, P1, P2), Affected System (multi-select), Discovered By (person), Date Discovered (date), Workaround (text — if a workaround exists), Runbook Link (URL), and Resolved By (person). This database is the persistent memory of production issues that outlast individual shifts. Link Active issues into every handoff note. Resolved issues remain searchable — they are the institutional knowledge base for "we have seen this before."
Set up the shift transition workflow
Define a standard handoff process: outgoing engineer updates the Handoff Notes entry 30 minutes before shift end (filling in Actions Taken, Decisions Made, and Things to Watch), posts the Notion page link in #on-call Slack channel with @mention of the incoming engineer, incoming engineer reads the handoff note and asks clarifying questions in the thread, and outgoing engineer changes Status to "Handed Off." The entire transition is async — no overlap call required unless there is an active P0 incident.
Common mistakes
Handoff notes written as a stream of consciousness
An on-call engineer writing a handoff in the last 10 minutes of their shift at 11pm produces rambling notes that the incoming engineer has to decipher. Use the structured template — the sections force clarity. If the "Things to Watch" section is hard to fill in, that is a signal the outgoing engineer has not synthesized their shift well. The template is the quality gate.
Known Issues that never get resolved or closed
Known Issues databases that never get cleaned up become noise — a list of 40 "Active" issues where half are actually resolved. Add a weekly Known Issues review to your engineering sync: go through all Active items, confirm they are still active, and close the ones that are resolved. The Known Issues database is only useful when it reflects reality.
No escalation log
When the outgoing engineer escalated during their shift, the incoming engineer needs to know who was called, what was discussed, and what was agreed. If this is not documented in the handoff note, the incoming engineer may re-escalate unnecessarily or miss a commitment the outgoing engineer made. Every escalation made during a shift gets a one-line log entry in the Actions Taken section.
Tips
Create a Notion formula property on the Handoff Notes database that calculates "Days Since Last Handoff" — if it has been more than 7 days, the formula flags the entry in red, indicating the database is not being maintained
Add a Slack workflow that automatically posts a reminder to #on-call every Sunday evening (or your shift change day) linking to the Notion page and tagging both the outgoing and incoming engineers with a checklist of handoff steps
Store the on-call rotation schedule in the Handoff Notes database by setting the Start Date and End Date properties in advance for the next 3 months and pre-assigning the Engineer property — this gives the whole team visibility into who is on call without a separate rotation tool
How Vantage helps
On-call handoff documents capture operational state. When connected to Vantage as a context source, the Known Issues database informs product decisions: a PM writing a PRD for a service improvement can query "what are the current known issues for the payments service?" and get the live list from Notion — grounding requirements in real operational problems rather than hypothetical scenarios.