Tridion Docs (TMS)

Content is machine translated from English by Phrase Language AI.

Available for

Enterprise plan (not available for LSP plans)

Get in touch with Sales for licensing questions.

Tridion Docs is a component content management system (CCMS) used to author, manage, and publish structured DITA XML content. The connector enables streamlined localization by integrating Phrase TMS with a Tridion Docs instance via secure OIDC API access and FTP file exchange. A background job scheduler and enhanced retry logic improve reliability.

Content editors can use the Phrase TMS to:

Submit entries in bulk.
Specify individual target languages while bulk submitting.
Have an overview of active translation jobs.

Restrictions:

Only supports DITA topics and general XML content.
Custom Tridion metadata (e.g., versions, workflow status) is not synchronized unless configured.
Direct in-context preview and live editing are not supported by Tridion API

Use Cases

There are a number of use cases for the connector:

Project managers can add files directly to projects from an online repository. Content is searchable by GUID in the exported file.
Set up the submitter portal so Submitters can add files to requests directly from the online repository. Content is searchable by GUID in the exported file.
Use automated project creation (APC) to have new projects automatically created when a new ZIP file is detected in the monitored folder.
- Tridion Docs translation jobs are imported only if their source locale matches the source locale configured in the TMS project or APC.
Import DITA XML topics directly from a Tridion Docs repository into Phrase TMS through secure FTP.

Authentication

The connector uses a hybrid authentication model:

FTP credentials for file transfer (import of DITA XML files).
OIDC (OAuth 2.0) for secure access to Tridion Docs APIs.

Phrase TMS Settings

From the Settings page, scroll down to the Integrations section.
Click on Connectors.

The Connectors page opens.
Click New connector.

The Create connector page opens.
Change the Type to Tridion Docs and provide a name for the connector.

Fill in the required fields:

Field	Description
FTP Host	Tridion Docs FTP server hostname
FTP Port	Port number (21 or 22)
FTP Username	FTP user account
FTP Password	FTP account password
Tirdion Docs export folder path	Path to the folder in the FTP where Tridion Docs sends files that require translation.
FTP archive folder	Path to the folder in the FTP where the ZIP folder with the source files should be moved once picked up for translation by Phrase TMS.
Post-translation status	Status to be assigned to localized content after returning from Phrase TMS into Tridion Docs.
OIDC Client ID	Provided by the Tridion Docs administrator,
OIDC Client Secret	Corresponding secret for the Client ID
Access Token Endpoint	Hostname of the Tridion Docs REST API, i.e. subdomain.yourdomain.com

Optionally, configure languages mapping in case using custom locales in Tridion docs.

Click Connect to Tridion Docs.

A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Hover over the icon to see additional details.
Click Save.

The connector is added to the list on the Connectors page.

If connecting fails:

Confirm your FTP firewall allows traffic from Phrase IP ranges.
Recheck OIDC credentials and token endpoint.
Use a private browser session to test domain-based authentication.

For help configuring the connector or implementing advanced workflows, contact Phrase Support or your Customer Success Manager.