Skip to main content

How to write, translate and edit a text in Free-Flow

Free-Flow is the wxrks document editor for running text: you write or paste a text, translate it with AI, and polish it with Sous-Chef, the wxrks AI assistant that follows your audience, tone and instructions. This article shows how to open Free-Flow, translate a text, review the AI's changes, and keep several versions of the same text.

Table of Contents

Before you start

Free-Flow is part of the wxrks Translation Portal, so the portal must be turned on for your account.

  • Account Admins turn the portal on in Settings > Portal & Routing > Portal (Portal on) and, on its Access tab, choose the Organizational Unit for portal requests and the roles that land on the portal after sign-in. An Organizational Unit is a division of your account with its own settings, such as translation memories, glossaries and the Sous-Chef agent. Account Admins open Free-Flow from Tools > Free-Flow or from the portal.

  • Project Managers open Free-Flow from Tools > Free-Flow or from the portal. They use it the same way as Account Admins; they do not need to change any setting.

  • Clients open Free-Flow from the portal, which may be the first page they see after sign-in, or from Tools > Free-Flow.

Free-Flow uses the AI settings of your account and of the Organizational Unit you choose.

Open Free-Flow

You can open Free-Flow from three places:

  • Tools > Free-Flow > New text: starts an empty text. To subtitle a video instead, click Subtitle a video and see How to subtitle a video in Free-Flow.

  • Free-Flow in the Translation Portal sidebar: also starts an empty text.

  • The Open in Free-Flow icon under a message in a Translation Portal session: opens that text in a new tab and saves it as a Free-Flow document for you.

    • On your own message, Free-Flow opens the original text, ready to translate.

    • On the translation, Free-Flow opens the translation as the Default variant and keeps your original text as the document's original.

Tools > Free-Flow page with a red box around the New text button at the top right, next to Subtitle a video.

Translation Portal session showing an English sentence and its Portuguese translation, with a red box around the Open in Free-Flow icon under the translation.

To open a Free-Flow document you saved earlier, go to Drive in the Translation Portal and click Open in Free-Flow on the document.

Add your text and save it

  1. Type or paste your text in the page, or click Import a text file in the top bar. Free-Flow imports plain-text formats such as TXT, Markdown, HTML, JSON, YAML, XML and CSV, up to 5 MB. Word and PDF files are not imported; open them in the Translation Portal instead.

  2. Enter a name in Document name. When you import a file, Free-Flow uses the file name.

  3. Click Save.

    • If Free-Flow cannot tell the languages yet, Select languages opens: choose the Source language and the Target language and click Save.

    • The first save creates the document and its first variant, Default.

Free-Flow top bar with an imported text: badge 1 on the Import a text file icon, badge 2 on the document name, and badge 3 on the Save button.

⚠️ Warning: A new text is not saved until you click Save the first time. If you leave before that, the text is lost. After the first save, Free-Flow saves your changes on its own 10 seconds after you stop typing. The top bar shows Unsaved changes, Saving… or Saved.

Choose the profile Sous-Chef follows

The Sous-Chef tab of the side panel holds the profile that every AI action in this text follows.

  1. Profile shows whose settings apply: Account default or an Organizational Unit. If you belong to more than one Organizational Unit, choose the one to use here. The unit decides which Sous-Chef agent, translation memories and glossaries Free-Flow uses. If you opened the text from the Translation Portal, Free-Flow starts from the unit chosen there.

  2. In Target language, choose the language to translate into.

  3. Open Profile values to adjust Domain, Formality, Tone, Audience, Instructions and Creativity level for this text.

Your changes to the profile are saved with the text and do not change the Organizational Unit's settings. Once you change a value, Reset to org unit appears to bring back the unit's values.

Sous-Chef tab of the side panel with badge 1 on Profile, badge 2 on the Target language field, and badge 3 on Profile values.

ℹ️ Note: If your account sets a priority order between glossaries, the AI receives only the translation from the highest-priority glossary. See How to set a priority order between glossaries.

Translate the whole text

In the Sous-Chef tab, under Whole text, click Context Sensitive translate. Context Sensitive is the wxrks AI translation: it uses your translation memories, glossaries and the profile above.

The first translation replaces the text on the page, even in Suggesting mode. To go back, use Undo in the History tab before you edit the translated text.

Text translated into Portuguese on the page, with a red box around Context Sensitive translate in the Whole text section of the Sous-Chef tab.

ℹ️ Note: If you click Context Sensitive translate again on a text that is already translated, Free-Flow translates the original again with the current profile and shows the result as suggestions. This is how you try a new tone or new instructions on the same text.

Proofread, rewrite or give an instruction

Under Whole text, Sous-Chef offers three more actions:

Action

What it does

Proofread

Fixes grammar, spelling and terminology; keeps the wording.

Rewrite

Rephrases to the audience, tone and instructions; keeps the meaning.

Custom instruction

Applies what you type, for example "Make it more formal" or "Shorten to one line".

Review suggestions

AI changes in the toolbar decides how Sous-Chef's changes reach the text:

  • Suggesting (default): each change appears in the text as a suggestion, with the removed words struck through and the new words highlighted. The text changes only when you accept.

  • Editing: changes go straight into the text. You can still undo them in the History tab.

In Suggesting mode:

  1. Find each suggestion in the margin to the right of the text.

  2. Click Accept or Reject. With more than one suggestion, Accept all and Reject all appear at the top of the margin.

The status bar shows how many suggestions are still waiting. If you run a new action on words that still have suggestions, the new suggestions replace the old ones.

A Rewrite suggestion in the text, with the replaced word struck through, and a red box around its card in the margin with the Accept and Reject buttons.

Work on part of the text

Select a passage to work on it alone:

  • A bubble appears over the selection with Ask Sous-Chef, Context Sensitive translate, Proofread, Rewrite and Shorter. Ask Sous-Chef lets you type an instruction for the selection; Shorter shortens it.

  • Right-click the selection (or press the context menu key) to open Text actions. It has the same Sous-Chef actions, Clear formatting, and Cut, Copy, Paste, Paste without formatting and Select all.

A selected paragraph with a red box around the bubble above it: Ask Sous-Chef, Context Sensitive translate, Proofread, Rewrite and Shorter.

ℹ️ Note: If the selection is already in the target language, Context Sensitive translate has nothing to do and Free-Flow says so. Use Proofread or Rewrite to change its style.

Keep several versions with variants

A variant is another version of the same text, for example a more formal translation or a translation into another language. Every document starts with the Default variant.

  1. Click Add variant (+) in the top bar.

  2. Enter a Variant name and choose its Target language.

  3. Turn on Start from the original content to start from the untouched original; leave it off to start from a copy of the variant on screen.

  4. Click Create.

To switch between variants, use the variant selector in the top bar. To see the original text next to the variant on screen, click Compare with original in the status bar.

New variant dialog: badges 2 on Variant name and Target language, badge 3 on Start from the original content, and badge 4 on Create.

Change the languages of the text

The source language belongs to the document's original and is the same for every variant; the target language belongs to each variant.

  1. Click the language pair in the top bar.

  2. In Languages of this text, change the Source language or the Target language. Click Detect in the original to let Free-Flow read the language from the original text.

  3. Click Apply.

If the original does not look like the stored source language, Free-Flow points it out next to the pair.

Glossary, History and Voice tabs

  • Glossary: lists the glossary terms for this text and language pair and highlights them in the text, including forbidden terms. Click Show in the text to find a term.

  • History: lists what Sous-Chef did in this session (translations, proofreads, rewrites and instructions) and how many suggestions are still waiting. Changes that went straight into the text have Undo; suggestions are undone by rejecting them. The history is kept for this session only and is cleared when you reload or close the page; the text and the profile stay saved.

  • Voice: reads the text aloud. Choose the Language and the Voice, click Generate audio, then Download audio. Save the document first.

History tab with a red box around the This session only notice and a Rewrite on the whole text with 1 reviewed suggestion.

Export, Zen mode and settings

  • Export as PDF (toolbar): opens your browser's print dialog with the variant on screen and its formatting. Choose Save as PDF as the printer to get the file; the document name becomes the file name.

  • Zen mode (top bar): hides the side panel so you can focus on the text. The formatting toolbar and the suggestions stay.

  • Settings (top bar): choose the theme and the interface language of Free-Flow and the Translation Portal.

Quick reference

Item

Value

Import formats

Plain-text files: TXT, Markdown, HTML, JSON, YAML, XML, XLIFF, CSV, TSV, PO, properties and similar

Import size limit

5 MB

Autosave

10 seconds after you stop typing, once the document has been saved the first time

Save shortcut

Ctrl+S (⌘+S on macOS)

History

This session only

Did this answer your question?