UserProfile/pt-br

What is it?
The user profile is the folder storing all user related data like extensions, custom dictionaries, templates, etc.

This folder is not removed when uninstalling or updating LibreOffice, so your customizations are kept.

There is a quick test from the command line to detect a broken profile. Check out the "Quick test for corrupted profiles" section. In any case you can follow the next steps to fix the problem.

Backup first
Before modifying your user profile, create a backup so you can return to the old user profile.

LibreOffice developers might ask for a copy of your user profile for debugging and bugfixing so please do not delete the backup file instantly.

Note: if you heavily customize LibreOffice, then making a periodic backup of the profile may help in case of problem. Even if shortcuts, user interface, etc. can be exported through single configuration files, restoring the whole profile will spare you the import of each single configuration file and the reinstallation of the extensions you could have added.

 Resolving corruption
Many problems in LibreOffice can be caused by corruption in the user profile.

When noticing strange behavior in LibreOffice the first thing to do is to reset the user profile. To do so, 2 methods are available.

Help wizard (LibreOffice 5.3 and newer)

 * Start LibreOffice and select
 * In the dialog select
 * LibreOffice will restart and display the dialog
 * If your problem is that LibreOffice does not start at all, launch it from the command line with  or use the start menu entry  on Windows


 * Select
 * Test and see if the problem is gone.
 * If the problem persists, you can exit the safe mode because the user profile was not the cause of the problem.
 * If the problem is solved, something is wrong with your configuration. Start LibreOffice in safe mode again to see the safe mode dialog. You can now try to disable Hardware acceleration or to restore/reset your user profile.

Manual procedure (all versions)
If you are using an old version of LibreOffice, or if the Help wizard procedure detailed above seems too complicated:
 * Close LibreOffice including "QuickStart" in system tray.
 * Find your user profile per information below, according to your operating system.
 * Rename the folder  to (for example).
 * Launch LibreOffice, a new  folder will be created with factory settings.


 * Test and see if the problem is gone.
 * If the problem persists, you can restore the previous profile because it was not the cause of the problem. To do so, delete the newly created  folder and give the renamed old one its former name   back.
 * If the problem is solved, it means that one or several configuration files were damaged. But it doesn't mean that the whole profile is dead. If you have heavily customized LibreOffice, you can still try to retrieve some parts of your configuration: as you have kept a backup, copy the subfolders (one at a time), and restart LibreOffice to see if the issue comes back or not. You can therefore spot from where the issue comes. Look at the content of the profile (below), some are less prone to corruption than others.

Expert information
Find the location of your user profile:.

Default locations
The number used in the path below refers to the last major version of LibreOffice that created that kind of profile. The format has changed from LibreOffice 3 to LibreOffice 4. You might wonder why the number has not increased with LibreOffice 5; this is because the format has not changed since LibreOffice 4. Changing that number will lose the user's personal configuration. If LibreOffice changes or removes this number in the future, then your own scripts must be modified.

Windows

 * (LibreOffice 4 to 7)
 * (LibreOffice 3)

Note: on a normal Windows install,  resolves to , at least on English versions of Windows Vista and later (part of the path may be localized on non-English versions).

Thus, you can copy and paste  in the File Explorer Address Bar and press  to access it directly. Or press and write   and hit.

GNU/Linux

 * (LibreOffice 4 to 7)
 * (LibreOffice 3 since 3.5.0)
 * (prior to LibreOffice 3.5.0)

Note: This is for the LibreOffice packages distributed by The Document Foundation. Versions provided by your Linux distribution may use a slightly different path.

Remember that the  folder is a hidden folder in your.

macOS
For LibreOffice Vanilla provided by Collabora at the App Store check
 * (LibreOffice 4 to 7)
 * (LibreOffice 3)
 * (LibreOffice 5.4)

User profile content
Inside the user profile there are several highly specialized folders:


 * autocorr: the substitution table you can configure on
 * autotext: the "AutoText" you created.
 * backup: the file backups you get when enabling the option is enabled under.
 * basic: all your macros.


 * config: some configuration files, especially toolbars for each module. Custom color palettes are also stored here.
 * database: the databases you registered.
 * extensions: registered extensions
 * gallery: your personal gallery.


 * psprint: may contain a "driver" subfolder (which may be empty), a "fontmetric" subfolder (which may be empty), and a "pspfontcache" file (in which printer fonts are cached). The "psprint" folder may be missing entirely. If it is present, it may be deleted without ill effect. If it is deleted, it will not necessarily be recreated.
 * registry: contents the most part of the configuration files.
 * Scripts: contains the optional Folders for user-defined scripts: beanshell, java, javascript and python. (for example the scripts you find over: )


 * store: may either be empty or contain a file named ".templdir.cache" (in which templates are cached). The "store" folder may be missing entirely but is usually present. If present, it may be deleted without ill effect. If it is deleted, it is usually but not always recreated.
 * temp: may contain an "embeddedfonts" subfolder that in turn contains a "fromdocs" subfolder and a "fromsystem" subfolder. The "fromdocs" and "fromsystem" subfolders may either be empty or contain temporary files. The "temp" folder may also contain a file named "document_io_logring.txt", which is a log of executed instructions. The "temp" folder may be missing entirely. If it is present, it may be deleted without ill effect. If it is deleted, is is not always recreated.


 * template: here you can find your custom templates
 * uno_packages: the extensions installed by the user.
 * wordbook: the custom dictionaries. (see also this tutorial)

Some extensions (like OOoLatex) could add other folders.

NOTE: other than the user profile, LibreOffice considers the configuration for all users you can find in the subfolders inside the main installation folder (for example, /opt/libreoffice/share on Linux for the "official" LibreOffice build, or \Program files\libreoffice\share on Windows)

Quick test for corrupted profiles: use a temporary, new user profile
While you can reset the default user profile LibreOffice uses, as described in the above sections, you can also start LibreOffice from a terminal / command line with a different, new user profile.

For Linux:

soffice -env:UserInstallation=file:///tmp/test

For Windows:

soffice.com -env:UserInstallation=file:///c:/my-test-profile

For MacOS:

open LibreOffice.app -env:UserInstallation=file:///tmp/test

Reusing user profiles
A single user profile must only ever be accessed by a single LibreOffice process. Internally, if a single user starts multiple LibreOffice processes that would all access the same user profile, only the first process does any actual work, like opening documents for editing, and the excess processes pass on their command line arguments to the first one for processing. Especially, one must not reuse a single user profile across multiple accounts on one computer, or across computers.

Also, different versions of LibreOffice can store different sorts of data in their respective user profiles. If a new version of LibreOffice does not yet find a user profile at the default location for that version, it looks for existing user profiles from old LibreOffice or OpenOffice.org versions at well-known locations and migrates any data it can continue to use to the new location. Strange effects might occur, if you explicitly request a LibreOffice version to reuse a user profile from another version.

However, most of the content of the user profile can be safely copied from a machine to another to duplicate the same configuration. Especially custom dictionaries, color palettes, shortcuts, toolbars, extensions…