How to Use Notion AI: Complete Guide
Notion AI transforms the productivity platform into an active workspace assistant that writes, searches, autofills databases, and runs autonomous workflows. This guide walks through every major capability, from enabling the add-on to building Custom Agents, with the specific steps, shortcuts, and configuration details you need to put each feature to work immediately.
- ✓Enable Notion AI
- ✓AI Writing and Editing
- ✓Workspace Q&A
- ✓Database Autofill
- ✓Custom Agents
- ✓Credits Management
Step 1: Enable Notion AI
The AI add-on costs $10 per member per month and works across every Notion plan tier. Annual billing brings that down by 20%. The Free plan includes a handful of complimentary AI prompts so you can test the basics before committing.
Activation Steps
- Open your workspace Settings (gear icon in the left sidebar).
- Navigate to Upgrade Plan or Explore Plans.
- Find the Notion AI section and click Add to plan.
Once activated, AI features appear across every page and database in your workspace. No additional configuration is required for the reactive AI tools covered in the next three sections.
Where to Find the AI Interface
After activation, you can reach the AI assistant from multiple entry points:
- Sidebar chat: The Notion AI tab in your left sidebar opens a persistent conversation.
- Page icon: The circular AI icon in the bottom-right corner of any page.
- Inline: Press Space on a new empty block, type / and search for AI blocks, or highlight text and select Ask AI.
- Keyboard shortcut: Shift + Cmd/Ctrl + J (customizable in Settings > Preferences).
Step 2: AI Writing and Editing
Notion AI handles writing tasks directly inside your documents. The system drafts new content, expands short outlines into full paragraphs, rewrites for tone, fixes grammar, and translates between languages. Built on large language models, you do not need to copy text into a separate tool and paste the result back.
Drafting New Content
Press Space on any empty block. A prompt field appears where you describe what you need: a project brief, an email reply, a meeting agenda, or a brainstorming list. The AI generates the content inline, directly on the page.
Editing Existing Text
Highlight a passage and select Ask AI from the floating toolbar. The AI receives the selected text as context and can rewrite it for a different audience, simplify technical language, adjust the tone from casual to professional, or condense a lengthy section into a summary. You can also click the ⋮⋮ block handle and choose Ask AI to run operations on an entire block.
Edit safety toggle: You can disable the AI's ability to directly modify page content. Toggle off edits in the AI console to restrict the assistant to read-only mode where it only produces text suggestions without altering your document.
Summarization
Ask the AI to condense long documents, meeting transcripts, or database entries into a brief overview. Summaries appear as new blocks on the page, preserving the original content. AI Meeting Notes extend this further by auto-transcribing calls and producing action items with clickable citations that link back to the exact moment in the transcript.
Step 3: Workspace Q&A and Research Mode
The Q&A feature turns Notion into an enterprise semantic search engine. Instead of scrolling through dozens of pages to find a policy detail or project update, you ask a natural-language question and the AI synthesizes an answer from your workspace data.
How Q&A Works
Open the AI sidebar or press Shift + Cmd/Ctrl + J and type your question. The assistant searches across all pages and databases you have access to, pulls relevant paragraphs, and composes an answer with inline citations linking back to the source pages. It reads not just current page content but also version history and margin comments, so it can answer questions like "Who changed the shipping policy last month?" or "What feedback did the team leave on the product spec?"
Research Mode
Research Mode goes a step further by synthesizing information from Notion pages, connected tools (Google Drive, Box, Jira, Slack), and the open web into structured research briefs. The output includes organized sections with citations, making it useful for preparing customer call briefings, competitive analyses, or product launch summaries.
Connected Tools
AI Connectors let the Q&A system reach beyond Notion. After connecting services like Google Drive, Slack, or Box, the AI can surface files and conversations stored in those platforms when answering questions. The Slack integration indexes both public and private channels (with appropriate permissions), so internal discussions become searchable alongside your Notion documentation.
Step 4: Database Autofill and Database Agents
Notion AI can automatically populate database properties without manual data entry. The original autofill feature let you generate summaries, translations, and action items as database column values. The newer Database Agents take this further by acting as automated librarians that keep your tables current.
Setting Up Autofill
- Open any database and add a new property.
- Set the property type to an AI-compatible option (text, summary, or AI-generated).
- The AI processes each row and populates the field based on the page content linked to that record.
For basic autofill, this works on any plan with the AI add-on. The AI reads the page body attached to each database entry and extracts the relevant data.
Database Agents (Business/Enterprise)
Database Agents operate on triggers like "On page creation" or "On page update." When a new entry appears in your project tracker, the agent can automatically categorize it, extract action items from linked meeting notes, generate a summary, or cross-reference information from the web and other workspace pages to fill missing metadata.
Setup path: Open a database, look for the Agents menu, define a fill-in property, set your trigger, and select data sources. Sources include "Anything on the web" and "Other workspace pages."
This turns passive databases into self-updating systems. A content calendar can automatically tag topics and generate draft summaries as soon as a new page is created. A CRM can enrich new contacts with company data pulled from the web the moment they are added.
Step 5: Custom Agents (Business and Enterprise)
Custom Agents are autonomous AI agents that run 24/7 without human prompting. Unlike the reactive personal agent that only responds when you ask a question, Custom Agents fire on triggers and execute multi-step workflows in the background.
Trigger Types
| Trigger | What It Does | Use Case |
|---|---|---|
| Schedule | Runs at set intervals (daily, weekly) | Morning briefing, weekly report |
| Database change | Fires when a property updates or a page is added | CRM enrichment, ticket triage |
| Slack message | Triggers on messages in public channels | Support escalation, request intake |
| Combined | Multiple triggers on one agent | Multi-channel monitoring |
Building an Agent
- Open the Custom Agents section in your workspace sidebar.
- Describe the agent's purpose in natural language. For tips on writing effective instructions, see our prompt engineering guide.
- Configure triggers (schedule, database change, Slack message).
- Select an AI model: Auto (Notion picks the best model), Claude Opus, Claude Sonnet 4.5, GPT-5.2, Gemini 3 Pro, or specialized models like Kimi K2.6.
- Scope the agent's permissions to specific databases and pages.
- Activate and monitor runs in the agent dashboard.
The one-agent-one-job principle consistently produces better results. Instead of building a single agent that handles marketing requests, sprint planning, and ticket triage, create separate agents for each task. There is no cap on the number of agents you can create, and leaner agents with fewer steps also consume fewer Notion Credits. Teams deploying agents at scale should also establish an AI governance framework to define which workflows are appropriate for autonomous execution.
Step 6: Notion Credits Management
Starting May 4, 2026, Custom Agents require Notion Credits to run. This is a consumption-based currency separate from the standard AI add-on subscription.
| Detail | What You Need to Know |
|---|---|
| Cost | $10 per 1,000 credits |
| Who can buy | Workspace admins on Business and Enterprise plans |
| Billing | Monthly; credits reset each month and do not roll over |
| Scope | Shared across the entire workspace |
| If you run out | All Custom Agents pause until the next monthly reset or more credits are added |
| Scheduled runs | Skipped during credit outage; they do not run retroactively |
Monitoring Usage
Navigate to Settings > Notion AI > Notion Credits to access the credits dashboard. The dashboard provides real-time tracking of consumption, automatic alerts at 80% and 100% usage thresholds, and agent-level insights showing which agents consume the most credits. Use these breakdowns to identify expensive agents and optimize their instructions or switch them to cheaper open-weight models like MiniMax M2.5 for routine tasks.
Cost Optimization Tips
- Use Auto model selection: Notion picks the most cost-effective model for each task, routing simple operations to cheaper models.
- Follow one-agent-one-job: Lean agents with focused instructions consume fewer credits per run than complex, multi-role agents.
- Route routine tasks to open-weight models: MiniMax M2.5 handles basic database updates and content generation at a fraction of the cost of proprietary models like GPT-5.5 or Claude Opus.
- Monitor the dashboard weekly: Catch runaway agents before they drain your monthly allocation.
Troubleshooting Common Issues
Most Notion AI issues trace back to permissions, network configuration, or plan limitations. Here are the problems you are most likely to encounter and how to resolve them.
What to Know Before You Start
The reactive AI features (writing, Q&A, autofill) and the proactive features (Custom Agents) operate on different pricing and plan requirements. Understanding this split saves time and avoids surprises.
| Feature Layer | Plan Required | Cost |
|---|---|---|
| AI Writing, Q&A, Autofill | Any (Free through Enterprise) | $10/member/month add-on |
| Custom Agents | Business or Enterprise | $10/1,000 Notion Credits (separate) |
| Model selection (Auto, Opus, GPT-5.2) | Business or Enterprise | Included in agent credits |
| AI Connectors (Slack, Drive, Box) | Varies by connector | Included with AI add-on |
For most individual users and small teams, the $10/month AI add-on on a Plus plan covers everything: writing assistance, summarization, workspace search, and database autofill. Explore our free AI templates and tools for workspace setup examples. Custom Agents become relevant when your team is large enough that repetitive workflows (ticket triage, report generation, CRM updates) justify the Business plan upgrade and credit costs.
For a deeper look at pricing structures and plan comparisons, see our Notion AI Pricing breakdown. For context on how Notion AI compares to standalone AI assistants, see Notion AI vs ChatGPT.
Video Resources
Go Deeper
Resources from across Tech Jacks Solutions