Settings troubleshooting

Diagnose and fix Cartographer settings issues: changes that don't take effect, a corrupted settings file, settings you can't find, and secure settings that won't save.

Un changement de paramètre ne prend pas effet

Cause 1: Some settings only apply after a restart.
Solution 1: Restart Cartographer.

Cause 2: It's a Security tab setting.
Solution 2: Change it through the Settings UI, not by editing the settings file directly.

Le fichier de paramètres est corrompu

Cause: settings_v2.json has invalid JSON, often from a manual edit.

Solution :

1. Fermez le Cartographer.
2. Supprimez ou renommez settings_v2.json.
3. Redémarrer — elle est recréée avec des valeurs par défaut, et vous devrez reconfigurer vos préférences. Voir Paramètres des emplacements des fichiers.

Je n’ai pas trouvé de paramètre

Cause 1: It's on a different tab than expected.
Solution 1: Check the other Settings tabs.

Cause 2: It's version-specific.
Solution 2: Confirm your Cartographer version, then check the release notes. The setting may have moved or been removed in a later version.

Les paramètres sécurisés ne seront pas enregistrés

Cause 1: Your Windows user profile isn't loaded correctly — the secure settings file relies on the Data Protection API (DPAPI).
Solution 1:

1. Redémarrez Cartographer.
2. Contact UiPath Support if it persists.

Cause 2: macOS didn't let UiPath Assistant use its Keychain key (login keychain locked, or access denied).
Solution 2:

1. Unlock your login keychain and allow access to UiPath Assistant Safe Storage.
2. Quit and reopen UiPath Assistant.
3. Contact UiPath Support if it persists.

Cause 3: The Keychain-protected file couldn't be decrypted.
Solution 3: It's reset to defaults, and plugin secrets must be entered again. Contact UiPath Support if it persists.