The Phrase Notion Plugin is a browser-based integration for submitting Notion pages to Phrase TMS for translation. No connector setup or admin configuration is required. When translation is complete, translated pages are imported back to the Notion workspace as cloned pages in the same database hierarchy.
Pre-requisites
Before getting started, ensure the following:
-
An active Phrase TMS account.
-
A Phrase TMS API token (generate in your Phrase account settings).
-
Admin or Member access to the Notion workspace selected for translation.
-
Notion pages organized in a database. Standalone pages are not supported.
Usage
Connect the Plugin
-
Open the plugin at the URL for the relevant data center.
-
EU: notion.eu.phrase.com
-
US: notion.us.phrase.com
-
-
Enter the Phrase TMS API token. The token is stored securely and does not need to be re-entered unless the browser cache is cleared.
-
Click Connect to Notion and complete the OAuth flow. Select the pages or databases to grant the plugin access to.
Note
Pages in private Notion spaces cannot be accessed via OAuth. This is a Notion API limitation. Only standalone pages outside a private container are selectable. For pages in public spaces, expand the page tree on the right side of the Notion authorization screen to make them selectable.
Submit Pages for Translation
-
In the Submission panel, select the Notion pages to translate. Pages must be part of a Notion database.
-
Select a project template from your Phrase TMS account.
-
Add the target languages.
-
Click Submit. A new Phrase TMS project is created automatically.
One submission creates one Phrase TMS project. Multiple pages can be submitted within a single project.
Monitor Translation Status
-
Open the Monitoring panel to see the status of submitted projects.
-
Click Refresh to retrieve the latest status from Phrase TMS.
Status updates are not automatic. To check progress, refresh manually.
Retrieve Translated Pages
-
In the Monitoring panel, find a completed project and click Import.
-
The plugin retrieves the translated content from Phrase TMS and creates cloned pages in the Notion workspace
-
Cloned pages appear in the same hierarchy as the source page.
Importing always creates a new cloned page in Notion. The original source page is not modified.
Supported Content Types
The plugin extracts and translates the following Notion block types:
-
Paragraph
-
Heading 1, Heading 2, Heading 3
-
Bulleted list
-
Numbered list
-
Toggle
-
Quote
-
Callout
Known Limitations
The following content types are not supported in the current release:
|
Not suported |
Note |
|---|---|
|
Database properties |
Text content of database pages is translated; database property values (e.g. tags, select fields) are not extracted. |
|
Tables |
Table blocks on pages are not extracted. |
|
Images |
Notion API does not support writing images to translated pages |
|
To-do items (checkboxes) |
Not extracted. |
|
Code blocks |
Not extracted. |
|
Multi-column layouts |
Not supported; columns are not preserved on import. |
|
Bookmarks and embeds |
Not extracted. |
|
Equations |
Not extracted. |
|
Synced blocks |
Not extracted. |
|
Child pages |
Sub-pages are not followed or submitted automatically. |
Rich text formatting (text colors, background colors) is preserved in most cases. If you notice formatting loss, report it via your customer success manager or our support form.
Frequently Asked Questions
Can I translate pages from a private Notion space?
No. Notion's OAuth flow does not support page-level access for pages in private spaces. Move the page to a public space before submitting.
Can I retranslate a page if the source content changes?
Yes. Submit the updated source page again. A new Phrase TMS project will be created. When the project is complete, click Import to create a new cloned page in Notion. Previous translated versions are not overwritten.
What happens to images in my Notion pages?
Images are not extracted or imported back by the plugin. This is a Notion API limitation: the API does not support writing images to translated pages. Images in the source page will not appear in the translated clone.
Can I use my own MT or translation memory settings?
Yes. The plugin creates a standard Phrase TMS project using the template selected at submission. All Phrase TMS features (translation memory, MT engines, AutoAdapt, terminology, and workflows) apply as configured in your account.
Does the plugin work with Phrase Strings?
No. The plugin connects to Phrase TMS only.
The plugin is not showing my pages. What should I do?
Check that you granted the plugin access to the relevant pages during the Notion OAuth flow. In Notion, go to Connections > Manage connections, select Phrase TMS, then select Select pages to manage access. Also confirm that the pages are part of a Notion database as standalone pages are not selectable.
My pages are in a database but they are not appearing. What should I do?
Confirm that you selected the database (not individual pages) when granting access during the OAuth flow. If the database is in a public space, expand the tree to find and select it explicitly.