Troubleshooting: Forgot password for backend login

The following example only works if your installation's administrator has enabled the password reset feature and if your backend account has a valid email address set. It also requires that your TYPO3 installation is able to send mails. Contact your installation's administrator if in doubt.

1. Click on Forgot your password?

   Go to the backend login page and select Forgot your password?.

2. Enter your email address

   Use the same email address that you provided during registration.

   

3. Open the email and follow the link

   If you did not receive the email, check your spam folder and double-check that the entered email address is correct.

4. Enter the new password

   After you clicked on the password recovery link in the email you received you can enter a new password. The new password has to respect the password policy requirements configured by the administrator of your installation.

Troubleshooting: Login does not work

• Check if JavaScript is enabled in your browser.
• Check the credentials are correct and valid.
• If your IP address changes you might be automatically logged out.

Backend and Install Tool are locked for maintenance

If the administrator locked you TYPO3 installation for maintenance purposes, you will see one of the following error messages:

Warning

TYPO3 is in maintenance mode at the moment. Only administrators are allowed access.

or

Backend and Install Tool are locked for maintenance. [BE][adminOnly] is set to "-1".

This message can only be removed by an administrator or integrator / programmer of the TYPO3 installation.

Login trouble shooting for administrators

In case you are the administrator yourself you can find more trouble shooting options in TYPO3 Getting Started, Troubleshooting common TYPO3 backend login problems.

Adding pages within the page tree

You can create a new page by dragging and dropping a page from the top of the page tree.

1. Select the type of page you want to add by choosing from one of the icons. In this example we are creating a standard page.
2. Drop the icon either between two existing pages to create a sibling or on top of an existing page to create a child.

3. Give the new page a title.

   

New pages are disabled by default. To enable a newly created page, right-click on the page and select Enable. You can also enable a page from the Access tab in page properties.

Adding pages with the context menu

1. Right-click any existing page and choose More options > 'Create New' Wizard from the context menu.

   

   The New record screen will appear.

2. Decide where you want your new page to appear in the page tree by selecting one of the black arrows.

   

   The Create new Page screen will appear.

3. Provide a title for the page. You can also go to the Access tab and enable the page to make it visible in the frontend.

   

Visit the page types chapter for more information on the different types of pages that can be created.

Move pages

1. Choose the page you want to move, then drag it anywhere in the page tree.

   A horizontal line displays to indicate the new position of the page.

   

   A gray outlined background on existing pages indicates that your page will become a child of that page.

   

2. Release your mouse. A confirmation message will appear displaying the option to copy or move the page.
3. Select Move this item.

Copy pages

1. Choose the page you want to copy, then drag it to its new position on the page tree.
2. Release your mouse, then select Copy in the confirmation message.

Delete pages

Choose the page you want to delete. Drag it directly to the right to display the Delete option.

Context menu

A variety of functions are also available from the right-click context menu.

Filter the page tree

At the top of the page tree is a filtering tool. Type a word or numbers to filter the page tree based on matching page titles or page ID. Multiple keywords / IDs can be entered by separating them with a comma.

Default page types

By default, TYPO3 includes the following page types.

Custom page types

Depending on the project, custom page types may also be available.

General

This tab contains general information about the page. You can change the Page Type, and edit titles for the page and the URL.

The following fields are of interest:

URL Segment

The "URL Segment", sometimes also called "Slug" is used to calculate the URL at which your page is available. Usually it is filled out automatically.

If the "Redirects" system extension is installed, an automatic redirect from the old to the new URL is created:

It is also possible to edit the URL segment by clicking the "Toggle" button. You can then enter a different URL segment:

SEO

This tab is used for search engine optimization. It uses the cs_seo system extension. See section SEO Tab in chapter Search engine optimization (SEO) for TYPO3 editors for more information.

Social media

The fields on this tab are used to enrich social media snippets for the URL of the page. See section Social media tab in chapter Search engine optimization (SEO) for TYPO3 editors for more information.

Metadata

The fields available on this tab depend on how your site is configured. How the data is used by the frontend depends on TypoScript which depends on your site configuration.

Typically, you might see the Abstract field, and editorial details like Author Name and Last Update.

Appearance

This tab contains properties that influence how the page is rendered. By default it contains settings for the page layout, which influences the pages appearance in both the frontend and the Page Module in the backend. Sometimes a site package defines additional fields in this tab regarding appearance. Refer to the documentation of your site package or ask your integrator.

Page Layout / Backend Layout

Backend Layouts influence the general structure of a page not only in the backend but also in the frontend. A Backend Layout influences, which content areas are available in the Page Module to Manage content in them. A Backend Layout is usually bound to its own frontend template which influences the appearance in the frontend.

Behaviour

In this tab there is usually not much to do for an editor. Advanced editors can use it to exclude certain pages from the search.

Resources

This tab lets you link media files to the current page. How those files are handled depends on your frontend rendering configuration.

Access

This tab lets you control the visibility of the page.

For more information, see Elements visibility.

Categories

How categories for pages are used during rendering is up to the site package. By default they do not do anything.

Notes

Use this tab for your own editorial notes and internal comments, such as reminders or to-do lists.

YouTube Video "Page Properties" (TYPO3 11.5)

Types of content elements

The content elements you can see here are provided by a standard TYPO3 installation with a site package as described in the TYPO3 site package tutorial.

If you are working with a different setup you might see more, or different content elements.

Which content elements you can see as an editor also depends on your user rights:

A standard editor can see the following content elements:

An advanced editor or an administrator can see the following content elements:

Content elements seen by a typical TYPO3 editor

Typical page content

Insert regular text and image content types to build standard web pages.

Lists

Lists can be used for structured content. They provide less flexibility then standard content elements but are easier to use for their specialized use case.

Depending on how the Rendering is defined in the Site Package the way the results are displayed on the page might vary.

Advanced content elements

The following content elements are usually visible to advanced users:

Form elements

Create a login form or a simple contact form.

Menu elements

Present a menu or list of page links in different ways.

Special elements

Insert plain HTML, or a horizontal divider on the page. The "Insert records" element lets you reference other content elements, i.e. reuse a content element from another page without duplicating it.

Add new content to a page

1. On a page, click the + Create new content button in the area where you want to insert content.
2. On the Typical Page Content tab, choose the "Text & Media" element. This is the most commonly used content type. The Create new Page Content form appears.

1. In the Header field, type My new content element.
2. In the Text area, type in some text. This field uses a Rich Text Editor (RTE).
3. Save and close the content element. You can see the newly added element on the page:

Video of creating a content element (TYPO3 11.5)

Changing text and setting in a content element

Once you clicked on the edit button you can change text, images and all settings that you have permissions for. There might be additional settings that only an advanced editor or an administrator can see and edit. Those might be hidden to you.

Content in the Content element forms is not auto-saved. If you try to leave a form that has changes you will be prompted to save:

Troubleshooting content element edits

Content element has no edit button

If you have no permissions to change a content element, you will see that element in the overview but no edit, hide or delete button appears.

Possible reasons:

• The content element may only be edited by a user or group that created it.
• Only admins may edit this content element.
• The content element is of a type that your group may not edit.

An administrator can support you in finding out why you cannot edit this content element.

Content element does not get saved

If one of the fields you edited contains an illegal value now or if you did not fill out a required field, you cannot save your changes.

If the field you changed is on a different then the currently changed tab, you might not notice it right away.

Error message after saving a content element

Such error messages can happen if you are editing content during or right after an update. Note the time and exact error message and copy the URL from your browser where you saw the error. Send these to your integrator or programmer.

Changing the type of an existing content element

You can also change the content element type by selecting another element from the Type list.

When you change a content element's type, the TYPO3 backend wants to reload the screen to display different input fields, you are prompted first:

This action does not delete content. It is saved in the background and will be restored if you select the applicable content element type again.

Video: Changing a content elements type (TYPO3 11)

Overview of the Page module in TYPO3

Common page icons explained:

1. Use this icon to edit all the content elements of a column.
2. Add a new content element to the column at this specific position.
3. Content element icon. This can provide a visual clue to the type of content element. Click to access the context menu for the element (to perform actions like copy).

4. This group of icons is enabled when hovering over the whole element.

   • Use the pencil icon to edit the element.
   • Enable/disable the element to show or hide it in the frontend
   • Delete the element.
   • Open the context menu.
5. If the edit icons are missing you do not have sufficient permission to edit the content element in question.

Hiding content elements

You can temporarily hide content that should be hidden for a while but will be needed later. You can also hide a content element while you are still working on it. Hidden content elements are not visible in the frontend

A content element can also be hidden in the "Access" tab of its edit form, its context menu or the List module.

Moving content elements

You can move content elements using drag and drop. You can either drop them in one of the highlighted areas on the current page or drop them on a different page within the page tree.

Copy and paste content elements

You can also copy content elements by pressing Ctrl during drag and drop.

Copied content is hidden by default and has the text "(copy xx)" appended to its title. Your integrator can disable this default behaviour: Disable hide and prepend at copy if desired.

Finding content using the Live Search

Use the search button on the top right of the TYPO3 backend or the keyboard shortcut Ctrl + K or Cmd + K to open the live search.

You can then edit the content element containing the text you were searching for.

Troubleshooting page management

Unused elements detected on this page

Sometimes the following warning is displayed on your page:

This commonly happens when you switched the Backend layout in the page properties.

It can also happen after imports or updates. "Unused content" is usually not displayed on the page. You can restore it if it is still needed or delete it if it is not needed anymore.

The "Unused content" is found at the bottom of the page module. you can move it via drag an drop to the desired location or delete it, if it is not needed anymore.

Restore deleted content elements using the Recycler

If you accidentally delete a content element or even a complete page you can restore your data using the module Web > Recycler if you have sufficient permissions and it is installed.

See also Recycler manual, For editors.

Undo changes using the Page History

You can use the page history to undo any kind of content changes. If you have no access to the recycler you can also use it to restore deleted content.

Use the context menu on the page tree and choose "History/Undo".

In this module you can even see a detailed view on how text or other fields where changed and who made which changes when.

The BE-User 'xxx' began to edit this record x min ago

It is not possible in TYPO3 for two editors to work on the same content element at the same time. The last editor who saves the content element will override all other changes. You should therefore avoid working on content elements that another editor is currently working on. These are marked with a warning:

Creating a link

Select the text you want to link.

Click the Link icon in the toolbar or use the shortcut Ctrl + K or Cmd + K. This shortcut only works when your focus is within the editor. Outside the editor the same shortcut would open the live search.

The Link Browser window displays.

This window lets you link to an internal page, file, folder, external URL, email address or phone number.

Internal links

You can link to an internal file, folder, page or content element on a page.

On the Page tab, select the page in the page tree that you want to link to, then click the Link to ... button.

You can also link directly to a content element. In that case an anchor (link with a hashtag) is used so your readers will automatically jump to the desired content element.

You can also link to uploaded files, for example PDF files:

Removing a link

To remove a link from text, put your cursor anywhere in the linked text then click the Unlink button in the popover:

Add an image to the content element

On the Images tab, click the Add image button. The File selector window displays to let you browse for an image.

Browse the file tree, then select a folder.

Configure the image

The Images tab lets you perform a number of actions to configure an image.

Image metadata

Use the small arrow next to the thumbnail to collapse and expand this section.

Here you can set general metadata including description, alt text, and insert a link to the image.

The information displayed here is drawn from the file metadata set in the Filelist. If required, you can override this metadata to set specific values for the image for the current content element.

You can experiment with the image manipulation editor to crop or resize the image. Making changes here won't impact the original image file in Filelist.

Media adjustments

Manually specify the width and height of the image in pixels, and apply a border.

Note

This section is only visible when your site package is based on the Site Package Tutorial or on Fluid Styled Content. Site Packages based on the Bootstrap Package have means to dynamically set the size of the images. The images will resize responsively to fill their container.

Manage your images in the Filelist

You can manage your previously uploaded images in the backend module File > Filelist:

TYPO3 uses a file abstraction layer (FAL) you can therefore move images into different folders without impending the frontend output of the web page, even if they are used in multiple places.

You can move images into folders by drag and drop:

The file abstraction layer will not allow you to delete images that are still in use in some content element:

First alter or delete all content elements that still use the file, then you can delete the file itself.

See also chapter Managing files in the Fileadmin.

Add a video to a page

If you want to embed a previously uploaded video or upload a new video use the button Add media file. If you want to embed a video from an external source like YouTube or Vimeo, use the button Add media URL instead.

Configure the video

Use the Autoplay setting to specify whether the video should start playing as soon as the page loads.

You can configure various settings for media files (for example, adding a border, setting page position and behavior) just as you would to configure an image.

External video sources and data privacy

Using certain external video sources can have legal consequences concerning data privacy laws in your country.

Talk to your Data Protection Officer (DPO) or legal department. Ask your integrator to install an extension that ensures you can use YouTube without data privacy issues on your page.

Extension b13/twoclickmedia enables you to use the standard "Text & Media" content element while requiring consent from your readers before any data is sent to YouTube.

Other extensions like t3brightside/youtubevideo provide their own content element.

Create a form from scratch

1. In the Web > Forms module, click the + Create new form button.
2. In the Create new form wizard, choose to create a blank form.

3. Give your form a name, then click Next and Finish.

   A blank form displays.

   

4. Click the Create new element button. The New element window displays.

   

   TYPO3 comes with over twenty form fields by default, including:

   • Basic elements like text or password fields
   • Special elements requiring specific format validation, like phone numbers or dates
   • Select elements like checkboxes or multiple choice
   • Advanced elements that have special rules, like user uploads or calendar date pickers
   • Container elements to visually organize surveys

   Once you’ve selected a form element, you can customize the settings for how the field is displayed.

5. Choose the Text element and the field is added to your form. You can configure settings for the field (such as placeholder text and field validation) on the right-hand side of the screen .

   

6. Click the Preview mode icon to see an indication of how your form will display on the frontend. Use the Edit mode icon to return to editing your form.

   

Working with forms

When you have added multiple fields to your form, you can drag and drop them to rearrange their order.

Click the Settings button at the top of the form to add Finishers like a confirmation message or redirection to another page.

You can integrate extensions with existing forms. For example, if you're running a sales operation, you can integrate with Mautic and any changes to a TYPO3 form will update Mautic to give you seamless lead tracking.

The List module header

The list view displays a list of records stored on the current page, grouped by type. The List module is commonly used for records that have no dedicated backend module, for example website users and groups.

The list view has action icons in the module header including:

1. Create new record (a wizard appears to let you choose which type)
2. Edit page properties of the current page
3. Clear the cache of the current page
4. Refresh the List view
5. Create internal note
6. View Show or hide search or The clipboard
7. Share Copy an URL to this page or bookmark it for quick access

Editing a record of a certain type

If there are already database records stored on the current page, each record type features its own action buttons for available actions:

In this example the first button can be used to edit the user group, the second button to hide or unhide it, the third button to delete it. The button with the three dots offers additional options.

Finding a record in a long list

If there are a large number of records you can use the search box to search for a record containing a certain word.

It is also possible to include subpages of the current page by choosing the number of levels (for performance reasons) in which to search.

If you do not know on which page the record could be found you can also use the Backend search.

The search can be opened by selecting the magnifying glass in the top right corner of the toolbar or by pressing the Cmd + K keystroke on MacOS or the Ctrl + K keystroke on Windows and Linux systems.

How to copy and paste via list module

Open the context menu by clicking the three dots button or the icon to the left of the record. Copy or cut the database record.

To paste the copied record you have several options:

Trouble shooting during copy and paste

If you see any error messages not listed here, note the date and time, error message and what you have been doing. Send the information to your site administrator.

Why is the header appended with (copy 1)?

By default the title of the pasted record is post fixed with "(copy x)" and the new record is marked as hidden and not displayed in the frontend.

This default behaviour of titles being prefixed can make working with copy and paste tedious and advanced editors often prefer that the integrator of the site turns of this behaviour. They can use the setting disablePrependAtCopy to disable this.

Attempt to insert record on a page that can't store record type

Some record types, for example frontend user records or category records may only be created in pages of type "folder". If you try to insert such a record on a plain page, an error message will be displayed:

The record was not pasted in this case. Use the page tree to switch to a folder, for example the folder "Frontend Users" and click the "Paste in clipboard content" there.

The value of the field "username" has been changed as it is required to be unique

Some fields need to be unique across the complete TYPO3 installation, for example a user name or identifier.

If you try to copy & paste such a record, the affected fields are automatically renamed by appending a number.

The record has been pasted but renamed. Edit the new record and replace the field with a unique value.

Edit selected fields

To enable mass editing you have to switch into the record list single view by clicking the tables title:

To edit the headers of all records in one go, select the pencil icon next to the "Header" label (1).

You will then see a screen with input fields to change all headers and save them all at once.

All fields that are currently viewable can be edited at the same time by selecting a different icon (2) in the screenshot above.

The result is almost the same form, but with several fields per database record displayed.

Edit selected fields of selected records

It is possible to select only those records that should be edited by using the checkboxes:

The result is a form for editing just the chosen field for the selected records.

Managing files in the TYPO3 CMS

Files including documents and images are managed in the Filelist module. Similar to the Web > List module, it displays a navigation tree, which corresponds to the file structure on the server, and a list of all files for the selected directory.

For admin users, the folder displayed by default is called "fileadmin/ (auto-generated)" and corresponds to the fileadmin/ folder located under the document root folder on your web server.

Using these files inside content elements to display them or link to them in your web site is covered in the images chapter.

Clipboard

There's a clipboard just like in the List module.

The handling is the same as the description used in the Advanced clipboard usage.

Uploading new files

You can upload files to a given folder by using the context menu or to the current directory by using the action icon in the docheader.

Next steps

The next chapters cover configuration and administration tasks that require special access privileges as described in Access control in the backend (users and groups).

Defining a new language

Languages are defined per site.

Adding a new language is done in the Site Management > Sites module, which is restricted to admin users. Detailed information on how to configure your site to add more languages can be found in the Site Handling documentation.

The Introduction Package's default languages are English, Danish and German languages.

Translation modes

When you choose to translate content, TYPO3 offers two methods:

• Translate - Use this option when you have a strict translation workflow or content structure.

  TYPO3 will create a direct connection between the original language and the translation. When the original language content is changed, the translations are marked as out-of-date and you can see the changes in the original language when editing a translation.

  This mode means that TYPO3 can help you maintain consistency when you have separate teams localizing content. This mode also allows TYPO3 to automatically mark translated content for review, and notify translators when the original text changes.

• Copy - Use this option when you would like the content structure to be free and independent between languages.

  TYPO3 creates a copy of the content in the target language. No connection is maintained between the original and the translation, which means subsequent versions of the translations can easily diverge from the original.

Working with translations

1. Working with the Introduction Package, in the Web > Pages module, go to the "Congratulations" home page.

2. Using the menu in the docheader, switch to the "Languages" view.

   

3. In the drop-down menu "Create a new translation of this page", choose a language, let's say German in this case. The page properties displays for the German version of the page.

4. Type the German translation in the Page Title field.

   

5. Save and close the page. The screen now displays two versions of the content elements showing the default language and the German version side by side.

   

6. In the German column, click the Translate button for a content element. The Localize wizard displays.

   

7. For this example, click the Translate button then click Next. Step 2 of the wizard will pass by automatically since we are translating in a single language. Step 3 provides a summary of the elements that will be translated.

8. Click Next to complete the wizard.

   The German version of the content element is now prepended with [Translate to German:]. The element is hidden by default, so that incomplete translations aren't displayed on the frontend until you are ready.

   

Adjusting the view

The Page module may now seem cluttered, with one column for each translation. You can view a single language at a time by switching back to the "Columns" mode and choosing a specific language in the docheader.

Next steps

The Frontend Localization Guide contains detailed information about setting up a multilingual web site and how to actually do the translation and localization.

The Site Handling documentation contains information about how to configure your site to add more languages.

General tab

SEO Tab

Social media

The social media tab contains information which is used to enrich the snippet that is shown when visitors share your URLs in social networks, modern browsers etc.

TYPO3 offers to have different content for OpenGraph (used for example by Facebook and LinkedIn) and X (formerly Twitter) Cards.

Both implementations allow you to set a title, a description and to provide an image. When this information is not set manually, the social network will decide itself what to show. Most probably it will use the information from Title for search engines and Description.

Metadata Tab

The Metadata tab contains a list of elements like Abstract, Keywords and editorial information.

Some site packages may utilize this for embedding within your frontend. They are not output by default

"Missing Meta Description" widget

To make it more convenient for TYPO3 editors to optimize their website for search engines, typo3/cms-seo offers a dashboard widget that shows pages without a meta description.

The description field is important for SEO purposes. This field is used to instruct search engines to use this text to show as a teaser of your page in the search result snippets. With this description, you can give the user a clear overview of the topic of this page:

Adding the "Missing Meta Description" widget to your personal Dashboard

If you have the access rights to the Dashboard module and are granted access to the "Missing Meta Description" widget you can add it yourself to your Dashboard:

1. Open the Dashboard module
2. Click on the plus button to add a widget
3. Go to category "SEO"
4. Choose widget "Pages missing Meta Description"

Using the "Missing Meta Description" widget to improve SEO results

Therefore this widget lists pages without a description in their meta data:

You can now click on the pencil icon to add a description to the page:

Publication dates

You can specify a period of time for content to be visible. This might be useful for seasonal announcements or festive periods. Any page or content element with a defined Publish Date will not be visible before that date. If it has an Expiration Date, it will be hidden from that point onward.

When you set a publication date in the future then try to navigate to that page, you are redirected to the home page.

When you enable the Extend to Subpages setting, the publication date (and other access restrictions) also apply to all child pages of the current page. This makes it possible to apply restrictions to a whole branch of the page tree.

Frontend users

The concept of the TYPO3 backend and frontend is explained in the Getting Started Tutorial.

You can use the concept of frontend users (website visitors) to create member-only content and restrict access to pages and content elements by requiring a log in.

Frontend users are always part of frontend groups. Access is granted to groups, never directly to users. Users and groups are defined like any other record, and stored in a suitable page in the backend.

Create a user group and user

1. Create a new folder in the page tree, and name it "Frontend users".

   

2. Navigate to the Web > List module, and select your new folder.

3. Click the + Create new record icon at the top left of the Docheader. The "New record" wizard displays.

   

4. Click Website Usergroup to create a new frontend group.

5. Name it "Private Area".

   

6. Save and close the record.
7. Use the "New record" wizard again, but this time create a Website User.

8. Type a username, a password and click the "Private Area" group to select it.

   

   You can add further information on the Personal Data tab if required.

9. Save and close the record.

Assign access rights

Now that we have at least one group, and a user assigned to that group, we can assign access restrictions. This is done on the Access tab of the page properties or content element properties.

1. Navigate to the Web > Page module, and create a new page called "Members only".
2. Add a text content element to the Members Only page, with text similar to "You need to authenticate to access the members area".
3. On the Access tab, select the "Hide at login" group for it.
4. Save and close the record.
5. Add another text content element to the page, with text similar to "Welcome to the members area".
6. On the Access tab, select the "Private area" group for it.
7. Save and close the record.

You should have something like this:

Try setting the access for an entire page to "Private area". When you save the page, notice how the icon in the page tree changes. This is a visual reminder that the page is not public. If you try to access a restricted page in the frontend, the TYPO3 error message "Page Not Found" will display.

Add a login form

The next step is to place a login box somewhere on the site so that visitors can log in to view the restricted content.

1. On the "Members only" page, click the + Content button between the two existing content elements.
2. In the new content element wizard, go to the Form elements tab and select "Login Form".
3. Give it a header (for example, Log in).
4. Go to the Plugin tab. There are several options for the Login Form, but the only one which is absolutely necessary is the "User Storage Page".

5. Use the Browse for records icon to browse the page tree and select the "Web site users" folder.

   

6. Save and close the record.

7. View the page. You should have something like this:

   

8. Enter the user name and the password you defined earlier for the frontend user, and you should see the following:

   

This is just a quick overview of the login form provided by TYPO3 CMS. It has a rich set of features that are described in the Frontend Login manual.

Sharing links

To share a link, look for the Share icon located at the top right hand side of any page in the backend.

Linking to a page

The example below would create a deep link to the About Us page:

Linking to a content element

This example would a create a deep link to the Introduction content element, found on the About Us page:

Linking to backend modules

It is possible to create links to places within backend modules. This example would create a link to the Site Configuration module.

URLs and deep links

When creating links to anything in the backend, it is recommended that the Share button is used to generate the link. Copying the URL from the browser is not recommended.

Navigating the page tree using a keyboard

It is possible to navigate the page tree using only a keyboard and it adheres to the guidelines set out in WAI-ARIA Authoring Practices 1.1.

• Home moves the focus to the first item in the page tree.
• End moves the focus to the last item in the page tree.
• Enter either expands the item or selects it.
• Up and Down arrow keys will move the focus up and down the page tree.
• Right arrow key will expand the focus if possible.
• Left arrow key will close the focus if possible.

Actions in backend forms

Editing text in the Rich Text Editor (RTE)

Below is a list of common keyboard commands that can be used when editing text in TYPO3's RTE.

Reloading pages and clearing browser cache

Opening the backend search modal

Multiselect in content elements

The keyboard commands can be used on a select element:

Or a folder element:

Or a group element:

Selecting and deselecting options with the keyboard:

• enter = Add options, either from right to left or left to right
• delete or backspace = Remove an option for Windows and Mac users
• alt + arrow up = Move the option one up
• alt + arrow down = Move the option one down
• alt + shift + arrow up = Move the option to the top
• alt + shift + arrow down = Move the option to the bottom

More combinations:

• shift + arrow up = Include the upper option
• shift + arrow down = Include the lower option
• home = Move the cursor to the top
• end = Move the cursor to the bottom

Browser cache

The browser on the client machine (Chrome, Edge, Firefox, etc) also caches pages. Sometimes you cannot see changes you have made to a page because your browser has cached the old content.

It depends on the browser and the operating system, how you can clear your browsers cache.

On Windows in most browsers you can press Ctrl + F5 to clear the browser cache.

Automatic cache clearing

With TYPO3, the cache of a page is cleared automatically in the following cases:

• You changed something about the page itself like its title
• You changed a content of the page like a text or image on that page
• In certain time intervals, usually once a day
• If content with a starttime or endtime set becomes visible or invisible
• In some other cases that your integrator or developer might have defined

Scenario: Changes are not visible in the frontend

If the cache did not get automatically cleared, the changes you made might not be visible right away in the frontend.

Some scenarios in which manual cache clearing might be necessary:

• You changed the title of a page. You view the affected page and everything looks fine. Now you go to the start page and cannot see your change in the menu. The following happened: Changing a pages title deletes the cache of the affected page. It does, however, not delete the cache of other pages like the start page.
• You added a news record. It does not appear in the news list. Creating a record does not automatically delete the cache of any page unless the integrator made some configurations.
• You changed content on one page that should also be displayed on other pages. This is often done with static parts of the page that should be editable such as the footer, a carousel in the header, etc.

Manual cache clearing

Clearing the cache of a single page can be done without ill effect in most installations.

To clear the cache of that page, go to the module Web > Page and click the button representing a lightning bolt with the tooltip Clear cache for this page.

When you reload the affected page, the changes should be visible right away. If the changes are not visible, clear the Browser cache. Or use an incognito tab in your browser.

Only editors who have the relevant user rights can flush the cache of all pages. If you cannot see the lightning bolt button beside the help menu button in the toolbar you might not have the rights to carry out this action:

Previewing a page without clearing the cache

If you need to preview a page and cannot clear its cache you can use the parameter no_cache=1 to preview the page as it will look once the cache is cleared. This option might have been disabled by the administrator however.

For example, visit https://example.org/community/events?no_cache=1.

Working with multi media: Digital asset management

Multi media assets (images, videos, audio, etc) are usually stored as files on the server. Especially videos are frequently displayed from third-party sources such as Youtube or Vimeo.

In TYPO3 you can manage all assets in the backend module File > Filelist if you have sufficient permissions. See chapter Managing files in the TYPO3 CMS.

Writing accessible text

See also the following W3C page: Writing for Web Accessibility

Copyright

Whenever you use files not created by yourself, for example images or videos, the copyright must be considered.

Using a file or even a text without proper copyright lead to high fines. If in doubt, do not use a content without consulting legal advice first.

Even images that you created yourself might infringe someones copyright. For example you may not take pictures of certain artwork or draw a picture of your favorite cartoon character and publish it.

Have a look at the related Wikipedia article: Copyright

Data privacy

In different countries there are different laws about data privacy. In general, you may not publish pictures of or data from any person alive or dead unless the person consented. There are some exceptions for persons of public interest such as politicians, scientists or movie stars.

Personal data does not only include a persons name but each information that might help to identify the person in question such as phone number, email address, IP address, nick names, pictures, car license plates etc.

Wikipedia has a good article on Personal Data which explains the situation in different countries.

Publishing personal information without consent might lead to high fines in some countries. If in doubt, do not use any personal information without consulting legal advice first.

Credits

This guide is based on material originally written by Marlies Cohen and Eikaa.

It has since been updated by Susanne Moog, François Suter and Felicity Brand.

Thanks to them all!

Feedback

If you find a bug in this guide, please use the "Edit on GitHub" button in the top right corner and submit a pull request via GitHub. Alternatively you can file an issue using the bug tracker: https://github.com/TYPO3-Documentation/TYPO3CMS-Tutorial-Editors/issues.

To support the translation to other languages see Internationalization and Localization.

Maintaining high quality documentation requires time and effort and the TYPO3 Documentation Team always appreciates support. If you want to support us, please contact us as described in the next section.

Contact the Documentation Team

For general questions about the documentation get in touch with the Documentation Team.