Documents Permission (what a plugin must ask before touching your writing)
The permission a plugin must ask for before it can touch the documents you wrote in the app. Two levels — read, and create/edit/delete — what each covers, why the retired AI Writer plugin asked you to re-approve it, and what is still not open to third-party plugins.
On this page
What it is
A plugin that wants to reach the documents you wrote in the app must now ask, and the card tells you which of two things it wants.
Where to find it
Where you see it: the permission card when you install or re-approve a plugin. The card lists everything that plugin is asking for, and approving it is what grants the ask.
A plugin you already have, once it begins declaring these permissions, shows the same card as a "Needs your permission" prompt with a Re-approve button the next time you open it.
How it behaves
The two levels
- Read your documents — open and search everything you have written, and publish a document to a Google account you have connected.
- Create, edit and delete your documents — change or permanently remove anything you have written, including restoring an older version over your current one.
Deletion is named in the title of the second one, not buried in the small print, because it is the part you cannot undo. Publishing is named in the first one for the same reason: it sends a document out of the app, which "open and search" alone would not have told you.
There is no separate delete-only level. A plugin that can overwrite a document with nothing has already destroyed it, so a third level would suggest a protection it could not deliver.
Why the AI Writer plugin asked you to re-approve it
The AI Writer plugin could always create, edit and delete your documents. It just never had to say so — its permission card was silent about it.
Once it declared what it used, you saw a "Needs your permission" prompt with a Re-approve button. The prompt was the point: you saw, once, what it could always do. That plugin was retired on 2026-10-15; Writer Studio is built in and needs no such permission.
What this does NOT do yet
No third-party plugin can reach your documents. The AI Writer plugin was the only plugin that was ever allowed near them, and it is retired.
Opening that door to other plugins is a deliberate later step. Splitting it this way kept the honesty first, on its own, without changing who can actually get in.
Related
This is one of the permissions a plugin asks for on the same card as plugin-shared-signin.md, which covers the shared browser session a plugin can request instead. Which plugins can be installed, and what the consent card looks like in general, is plugin-marketplace.md. The documents themselves, and the Writer that owns them, are described in ai-writer.md.
Last verified 2026-09-23