Admin ConsoleUser Management

Sync Options and Filters

When configuring the Directory Connector application, you can use a variety of sync options and filters to customize your sync operation and limit the users and/or groups that are processed to your Bitwarden organization.

Available sync options and filter syntaxes are different for each directory server type. Refer to the Configure sync options and Specify sync filters sections of one of the following articles for help:


If you are using the Directory Connector CLI, see Directory Connector File Storage for help editing your data.json configuration file.

Large syncs

Regardless of which directory you are syncing from, use the More than 2000 users or groups are expected to sync option to signal to Directory Connector that you are expecting a large number of users or groups:

Signal a Large Sync
Signal a Large Sync

You may also activate this option directly in the Directory Connector configuration file (data.json) by setting "largeImport": true:

"syncConfig": { ..., ..., ..., "largeImport": true },"

If you don't enable this option, Directory Connector will limit a sync to 2000 users or groups.

Overwriting syncs


This option is for very specific use-cases or debugging purposes and is disabled by default.

By activating this option, every user except one owner user and every group will be re-synced, replacing them with the user list and/or group list that is fetched from the source directory.


Do not use this option for offboarding users, this should be accomplished in one of the following ways:

  • Activating the Remove disabled users during sync option.

  • Manually removing users from the web vault.

In either case, consider using admin password reset to takeover and audit removed users' vaults before removing them from the organization, and and using one of these methods to delete their accounts after removed.

Additionally, Directory Connector will not delete or remove groups.

Overwrite Sync
Overwrite Sync

You may also enable this option directly in the Directory Connector configuration file (data.json) by setting "overwriteExisting": true:

"syncConfig": { ..., ..., ..., "overwriteExisting": true },"

Make a suggestion to this page

Contact Our Support Team

For technical, billing, and product questions.

Bitwarden account email*
Verify account email*
Are you self-hosting?*

Cloud Status

Check status

© 2024 Bitwarden, Inc.TermsPrivacySitemap
This site is available in English.
Go to EnglishStay Here