Skip to main content

Migrate Metadata

This section enables administrators to migrate existing resource metadata from legacy cleartext format to encrypted format.

Metadata migration interface
Metadata migration interface in Passbolt

Configuration Options​

Items to Migrate​

Toggle whether to include resource metadata in the migration. When enabled, the following fields will be encrypted:

  • Name
  • Username
  • URI
  • Cleartext Description

If disabled, these fields remain in cleartext form. Passwords are always encrypted regardless of this setting.

Migration Scope​

Choose which types of resources to include in the migration:

  • All content - Includes both shared and personal resources.
  • Shared content only - Only shared resources are migrated.

Important Considerations​

Before initiating migration, ensure:

  • Encrypted metadata is enabled in Encrypted Metadata
  • All users who need access to migrated resources have received the shared metadata key (see Metadata Key)
Best Practice

Always backup your database before migration. Metadata migration cannot be easily reversed.

warning

Migrating content to encrypted metadata might affect integrations that rely on accessing resource metadata in cleartext format.