How to use Quick AutoFill

Why use Quick AutoFill

With Quick AutoFill, you can fill out login forms in one second.

Quick AutoFill shows relevant credentials right above your keyboard, on the QuickType bar:

Quick AutoFill on iOS
Once you tap the username, the system will check your identity with Face ID or Touch ID and then fill out the form.

If your database is locked or not available, the system will show the full KeePassium AutoFill popup. You can also open it manually by tapping the “key” button at the right.

Initial Setup

There are three steps to activate Quick AutoFill:

  • Activate AutoFill in device settings (iOS guide, macOS guide)
  • Open KeePassium settings → Password AutoFill → turn on Quick AutoFill
  • Finally, open your database.

How it works

The system maintains an internal list of usernames and URLs they correspond to. Importantly, this list does not contain any passwords — these remain in your KeePassium database.

When you open a database, KeePassium will find entries that contain any URL address and will share the following data with the system:

  • Username for that entry (if there is no username, the entry will be skipped)
  • Any URL addresses found in the entry
  • Information to help find the entry later:
    • Entry’s unique identifier (UUID)
    • Database file name
    • Database file provider (such as local storage, iCloud Drive, Dropbox, etc. File path is not shared.)

Later on, when you tap the username in the QuickType bar:

  1. The system launches KeePassium AutoFill module, but does not show it on the screen.
  2. The AutoFill module receives the webpage URL, the username you selected, and other information about the entry (the information that was previously saved).
  3. Based on that information, the AutoFill:
    • Finds and loads the appropriate database
    • Finds the required entry
    • Returns entry’s password to the system.
      • If the entry contains an OTP code, KeePassium can copy it to clipboard for your convenience

If something goes wrong and KeePassium cannot load the database or find the entry, the system will show the full AutoFill popup so you can find the entry manually.

Troubleshooting

Out of sync

Due to the technical limitations, system’s list might get out of sync with your database. As a result, you might see duplicate or outdated entries. In some cases, when you tap an outdated username, KeePassium would insert the current username and password instead.

The best solution is to reset system’s username list:

  • Open KeePassium settings → Password AutoFill
  • Turn off Quick AutoFill. This will clear the system’s cached usernames.
  • Turn Quick AutoFill back on

Once you open your database, KeePassium will re-populate the system’s username storage and Quick AutoFill will work again.

Response latency

When you select the username, KeePassium remains invisible but does all the usual heavy lifting: fetches the database (possibly from a cloud storage), decrypts and parses the file. For certain files, this process can take a long time. However, in Quick AutoFill mode KeePassium cannot show any progress bar. If you prefer to have some visual feedback, tap the “key” button to open the full AutoFill popup.

Quick AutoFill in apps

For the moment, Quick AutoFill works only with web pages. Support for apps is coming in one of the future updates.


See also

Last Updated: 2021-11-22