Study guide · Translations and workspaces
Translating pages and reviewing changes before they go live
On this page you get to know two tools that every larger editorial team needs. With translations you bring pages and content into more languages. With workspaces you prepare changes calmly, have them reviewed and only then publish them. Afterwards you know which translation mode to choose, how to avoid mistakes and how a review process works in the backend.
The example: Weidenau City Library
All examples take place on the website of Weidenau City Library, with pages such as Home, Events, Media, Opening hours and Contact. The default language is German, and English is set up as an additional language.
- Lena is an editor. She maintains the content and translates it.
- Tom is an administrator. He sets up languages, workspaces and permissions.
Two tasks are coming up. The page “Opening hours” should appear in English. At the same time, Lena prepares the annual program, which the management wants to review before it is published.
Languages: who sets them up and how many there are
TYPO3 delivers content, records and the metadata of files in several languages. You do not need an extension for this. The number of languages is not limited.
As an editor, you do not set up the languages of a website. They live in the site configuration, which is edited in the module Setup under Sites. This needs administrator rights. At the library, Tom does this. Lena then translates into the languages that are set up there and for which she has permissions.
Translating a page
You translate pages in the module Layout under Content. The language menu at the top of the module first shows the languages the page is already translated into. Below, under “Create new translation”, you find the remaining languages of the site. One click on a language creates the page translation. Only once the page itself is translated can you translate its content elements.
Since TYPO3 14, a modernized translation wizard guides you through the work. It works step by step: target language, source language, mode and selection of content elements. At the end, it reports that the translation is complete. It skips steps on its own when there is nothing to decide. In the past, it only existed in the Layout module. Since TYPO3 14, it is the standard way to translate in all modules.
- Lena opens the page “Opening hours” in the Layout module.
- In the language menu, she picks English under “Create new translation”.
- The wizard opens. She chooses the mode and the content elements to translate.
- At the end, the wizard reports “Localization completed”. She closes it with “Finish”.
- She switches to the view “Language Comparison” and translates the title and texts.
- Finally, she makes the English content elements visible.
The views in the Layout module. The view “Language Comparison” shows the versions side by side: the default language on the left, the translation on the right. Since TYPO3 14, you can pick several languages at once in the language menu and compare them. This selection also applies in the Records module, because both modules stay in sync. With the view “Layout” you switch back to a single language with its columns.
Translating the page title. In the view “Language Comparison”, the translated page sits above the column of the target language. A click on its pencil opens the page properties of the translation. There you translate the title and adjust the URL segment. You do not rename the German page for this.
New translations are hidden. TYPO3 creates newly translated content elements as hidden. So they only appear in the frontend once you make them visible. The translated page itself usually starts out hidden as well.
Connected or free: the two translation modes
When you translate, the wizard asks for the mode. There are exactly two.
Translate, the connected mode. Every translation stays linked to its original. The languages share the same, parallel structure. This has advantages:
- When someone changes the original, TYPO3 marks the translation as out of date.
- While translating, you see the changes in the source language next to your text.
- Position and moving follow the original, and so do settings such as start and end time.
So the connected mode suits a strict translation process in which all languages should be built the same way.
Copy, the free mode. TYPO3 creates standalone copies in the target language. There is no longer any link to the original. You can arrange, add or leave out elements freely. So the page in the target language may be structured quite differently. The price: when the original changes, you will not find out.
Mixed mode and how to resolve it
If one page has connected and free elements in the same language, TYPO3 calls it Mixed Mode. It is not a mode you choose, but a problem state. It happens, for example, when someone first translates some elements in connected mode and later adds free elements in that language.
The consequences are unpleasant:
- The translation wizard can no longer be used for this page.
- Reordering and further translating become error-prone and confusing.
How you recognize it. The Layout module shows a notice titled “Inconsistent content detected in language” followed by the name of the language. It highlights the affected records in color. So you can see which elements you need to clean up.
How you resolve it. There is no dedicated reset button. You clean up the marked elements: remove them or translate them again until only connected or only free elements are left in that language. After that, the wizard is available again.
How TYPO3 14 prevents it. If a page already has translations in one mode, the wizard only offers that mode. So mixed mode cannot newly arise through the wizard.
All languages, records and images
The language “All languages”. Instead of a specific language, a content element can get the language “All languages”, internally the value minus 1. It then appears in all languages without being translated. There is no Translate button for it. This suits language-neutral content such as a logo or a map section. So you neither copy it nor write the text of every language one below the other.
Translating records. Not only pages, but also records such as news or events can be translated. They usually live in a folder and are maintained in the module Records under Content. There you start the translation with the translation action on the record, and here too the wizard opens. Important: the module only offers the action for languages into which the page or folder is already translated.
The language filter in the Records module. Say you choose French there. The module then shows three groups: the French records, the records of the default language as a fallback, and the records for “All languages”. Your selection is kept when you switch pages.
Images and other embedded elements. A content element can contain embedded elements, such as images. These inline elements are not translated automatically. In the translation you find two buttons for them:
- “Localize all records” creates translations of the embedded elements.
- “Synchronize with original language” brings them in line when something has changed in the original.
Alternative texts of images. The alternative text of an image usually sits in the metadata of the file. If the English page shows the German text, you have two options. You translate the metadata of the file in the module Media with “Translate metadata”. Then the English text applies wherever the image appears in English. Or you override the alternative text directly in the English content element. You neither delete the image nor upload it again.
Keeping track: Status and the page tree
Which pages are translated? The module Status under Content, formerly Info, offers the “Localization Overview”. For a branch of the page tree, it shows in which languages the pages are already translated. So Lena quickly finds all pages that are still missing in Spanish, without opening each page.
Finding pages by their translated title. Since TYPO3 14.1, the page tree filter also searches translated page titles. If Lena enters “Opening hours”, she finds the German page “Öffnungszeiten”. A colored label such as “Found in translation: English” shows that the match comes from the translation. The page tree itself stays in the default language. You can switch this search off for yourself in the menu of the page tree.
Workspaces: drafts next to the live website
A workspace is a working environment for changes before they go live. You work on a preview of the website there. Others can review, approve and publish your changes. So workspaces are not a language tool, but a draft area with approval.
Live and the others. The workspace whose content visitors see is called LIVE. There, every change applies immediately. As soon as you edit something in another workspace, TYPO3 creates a new version. The live website stays unchanged until someone publishes the change.
Who sets up workspaces. Workspaces come from a system extension. An administrator activates and configures them, with members, stages, color and description. At the library, Tom creates the workspace “Annual program”.
Choosing the workspace. If you have access to several workspaces, you choose them in the workspace selector. In TYPO3 14.3 it sits at the top of the left sidebar, above the module menu, and shows the name of the current workspace. It used to sit in the top bar. After switching, TYPO3 reloads the current module, the page tree and the module menu in the new workspace. The backend as a whole does not reload.
How you know where you are. At the very top of the backend, above the top bar, a colored strip shows the name of the active workspace in its color. In all other workspaces it is always visible. In the LIVE workspace it only appears if you have access to several workspaces. There you can switch it off in the user settings on the tab “Personalization” with the option “Enable workspace Live indicator”. In addition, pages with changes in the current workspace are highlighted in the page tree.
Visible in the log. The system log records workspace actions too. In the user column, the name of the workspace appears below the user name.
The Publish module
The module Publish under Content gives you an overview of all changes in a workspace. It used to be called Workspaces. In TYPO3 14 it is called Publish and only appears when you work in a workspace other than Live. It shows the changes of the selected page and, if you wish, of the pages below it.
For every change there are icons for these actions:
- Show changes opens the detail view with the differences and the history.
- Publish publishes the workspace version of this record to live.
- Preview element opens the preview.
- Edit element opens the record for editing.
- Open version of page jumps to the Layout module.
- Discard discards the change.
Discarding. If you discard a change, TYPO3 only removes the workspace version. The live version stays as it was.
Who changed this? Since TYPO3 14, the Publish module also shows who edited the changes. The column with the last change shows the username and picture of the person who last changed the record. So you know whom to ask if you have questions.
Careful with mass actions. At the bottom of the module there is a menu for mass actions, such as “Publish” or “Discard” for the whole workspace. It is only active when no element is selected. The mass action affects the whole workspace. That includes changes you cannot see right now because they are in another branch of the page tree. Changes by other users are included too. If you only want to publish a part, select the elements individually.
Approval in stages
TYPO3 supports a review process for content. A change moves through stages. The default stages are “Editing” and “Ready to publish”. Publishing comes after them. The administrator can set up custom stages in between, such as “Review by management”.
Sending a change on. In the detail view of a change, you send it to the next stage or back to the previous one. A window for a message then opens. TYPO3 stores these messages as comments in the history of the change. You see them later in the detail view. Alternatively, you select changes in the overview and use the menu at the bottom left.
Who publishes. Only people with the right permission to publish may publish to live. Neither visitors nor the system after some deadline do it. By default, authorized people can publish a change from any stage, not only from “Ready to publish”. So a change does not have to go through all stages. The stages structure the process, they do not enforce it.
The typical flow is therefore: edit in the workspace, have it reviewed, then publish. That is safer than saving live and fixing mistakes later.
Preview, preview links and QR code
The workspace preview. If you click “View webpage” in a workspace or save with “Save and view page”, the workspace preview opens. “Preview element” in the Publish module leads there too. The preview shows the live and the workspace version at the same time. The default is the workspace version with a slider that lets you slide over to the live version. At the top right you can switch to a split view, vertical or horizontal.
Preview links for people without a backend account. The button “Generate page preview links” at the top of the module creates a special link. You can share it with anyone, even with people who have no access to the installation at all. Whoever opens it sees the page as it looks in the workspace. Such a link does not publish anything.
Preview link or deep link? The share button in the backend creates a deep link. It leads directly to a place in the backend and therefore requires a login. For people without an account, the preview link is the right tool.
Checking on a smartphone. Since TYPO3 14.2, there is a button for a QR code of the page next to the “View” button, for example in the Records, Preview and Publish modules. In the context menu of a page, the entry is called “Show QR code”. If you work in a workspace, this QR code contains a preview link that works without a backend login. Lena scans it with her phone and checks the annual program on the go. In the Publish module there is also the action “Preview QR code”.
No automatic redirects in a workspace
If Lena changes the URL segment of a page in the live workspace, TYPO3 normally creates a redirect from the old address. In another workspace this does not happen. Automatic creation of redirects is switched off for workspace versions. The live address stays the same until publishing. So when you publish a changed address, think about whether a redirect is needed. You learn more about this in the course “Zugriff, Links und Weiterleitungen”.
Key points
- The number of languages is not limited. An administrator sets up languages in the site configuration under Sites in the Setup module.
- You translate pages in the Layout module with “Create new translation”. The wizard works step by step and, since TYPO3 14, is the standard way in all modules.
- “Language Comparison” shows the default language and the translation side by side. The pencil opens the page properties of the translation.
- Newly translated elements are hidden until you make them visible.
- Translate links the translation to the original and reports changes. Copy creates free copies with their own structure.
- Connected and free elements in one language result in Mixed Mode. You clean up the marked elements, and the wizard only offers the mode already in use.
- “All languages” shows an element in every language, without a Translate button.
- You translate records in the Records module, but only into languages the page is translated into.
- The Localization Overview in the Status module shows what is translated. The page tree filter finds translated titles.
- In a workspace, versions are created and live stays the same. The Publish module shows, reviews, publishes and discards changes.
- Mass actions affect the whole workspace. Authorized people publish from any stage.
- Preview links and the QR code in a workspace work without a backend account, deep links do not.
Terms
- Site configuration
- Settings of a website, including its languages, maintained by the administrator under Sites in the Setup module.
- Default language
- The base language of a site, to which all connected translations are attached.
- Translation wizard
- The step-by-step dialog used for translating in all modules since TYPO3 14.
- Language Comparison
- View in the Layout module that shows several languages of a page side by side.
- Translate
- The connected translation mode, in which the translation is attached to the original.
- Copy
- The free translation mode, which creates standalone copies without a link.
- Mixed Mode
- Problem state with connected and free elements in the same language on one page.
- All languages
- Language with the value minus 1 that shows an element in every language.
- Localization Overview
- Overview in the Status module of which pages are translated into which languages.
- Workspace
- Working environment in which changes are created as versions before they go live.
- LIVE
- The workspace with the content that visitors see.
- Publish
- The module under Content where you review, send on, publish or discard the changes of a workspace.
- Stage
- A step in the review process, by default Editing and Ready to publish.
- Preview link
- Link to the workspace version of a page that works without backend access.
- Deep link
- Link to a place in the backend that requires a login.