📄Docs

Introduction

Docs in Motion aren’t just places to write, they’re where ideas turn into action. With AI built into Docs, you can draft from scratch, refine sections inline, pull in references, and even get critiques; all without leaving your doc. Instead of switching between writing and planning tools, Motion keeps everything connected: your tasks, projects, and documents live side by side.

At a Glance

• Start from a blank doc or ask AI to draft for you.

• Add references like brand guides, docs, or project links for context-rich drafts.

• Tweak sections inline with AI-powered skills like Summarize or Rewrite.

• Get critiques from role-based perspectives to sharpen your doc.

• Use version history to roll back changes anytime.

What You’ll Learn

By the end of this guide, you’ll know how to:

1. Start a draft from a blank doc and let AI handle the first pass.

2. Add references so your doc matches your brand, tone, or context.

3. Edit inline with AI tools that rewrite, summarize, or refine sections.

4. Request critiques and apply actionable feedback.

5. Roll back AI changes with version snapshots for peace of mind.

---

Start a blank doc

Start a Draft from a Blank Doc

Every great doc starts with… well, a blank page. But in Motion, that page comes with AI on standby, ready to draft for you.

1. Open a new doc

   1. From the sidebar, click + New → New Doc.

   2. Or open an existing folder/workspace and hit + → New Doc.

2. Choose how to start

   1. On the blank page, start typing your content.

   2. Or use Docs AI, describe what you want to draft.

3. Tell Motion what you need

   1. Type a prompt like: “Write a marketing launch plan for the summer. I am an retail e-commerce store."

   2. If prompted, answer 2–3 clarifying questions (e.g., audience, timeline, goals).

4. Sit back and watch

   1. Motion begins streaming a draft directly into your doc.

   2. The doc locks while AI writes, so everything stays tidy.

   3. A version snapshot is created automatically in case you want to roll back.

Adding references

Add References for Smarter Drafts

Motion AI gets even better when you give it context. By adding references, you help Motion mirror the tone, style, or details from your existing work. Think of it as handing your AI co-writer a stack of notes before they start typing.

1. Open the AI chat

   1. At the bottom of your doc, click into the chat bar.

2. Attach references

   1. Use @mention to link existing docs, tasks, or projects.

3. Guide Motion on how to use them

   1. Example: “Follow tone in the brand guide and pull deadlines from the Q4 project plan.”

4. Confirm and run

   1. Your references will appear in the chat and stay tied to this doc for future prompts.

💡 Pro tip: Think of references as your “AI guardrails.” The clearer the sources, the closer your draft will land to what you’d write yourself.

Tweak sections inline

Tweak Any Section Inline

Sometimes a draft is close, but not quite there. Instead of rewriting everything, you can refine any part of your doc directly — no messy copy-paste.

1. Highlight the section you want to update.

2. On the block toolbar, click AI tools.

3. Choose a skill like Summarize, Rewrite or edit text, create a task, or create multiple tasks.

4. Review the changes inline. Approve them or keep iterating with AI in the chat.

💡 Pro tip: Use small, specific prompts (e.g., “Rewrite to be more persuasive”). Targeted asks = sharper results.

Get a quick critique

Get a Quick Critique

Think of this as having an editor on standby. Motion can review your doc and give you actionable, role-based feedback in seconds.

1. Open the AI chat in your doc.

2. Type Provide feedback on this document as the prompt.

3. Review the notes (e.g., “B2B marketer feedback” or “General clarity improvements”).

4. If you agree, click Apply suggested changes to implement them instantly.

💡 Pro tip: Try feedback from different roles (like “marketer” vs “project manager”) to see your doc through multiple lenses.

Accessing version history

Roll Back Any AI Change

Made an edit you’re not happy with? No problem, Motion automatically saves version snapshots every time you or AI makes a change. You can roll back in seconds.

1. Go to the top right corner of your doc and click the version history icon (the clock with an arrow).

2. In the panel, browse through your saved snapshots. Each one is timestamped with who made the change.

3. Click Restore on the version you’d like to return to.

💡 Pro tip: Use version history not just as an undo button, but as a way to track how your draft evolved over time.