When KeeForm receives credentials from KeePass it starts a session, and the toolbar icon turns orange with a countdown showing the seconds remaining. During the session KeeForm keeps watching the page. In Automatic mode it retries filling automatically as the page changes; in Click to fill mode it keeps the blue lock icons and Ctrl+click ready until the countdown ends. (In older versions you clicked the toolbar icon to start another fill attempt; that now happens on its own.)

If you see the orange countdown on a page that is not a login page — for example one where you are already signed in — it means KeeForm is still armed and waiting; nothing has been entered. KeeForm only fills recognised login fields, so the risk is low, but it is still good practice to keep an eye on the countdown and to click the orange toolbar icon to end the session once you are done.

The session length is the Session timeout setting (default 25 seconds): lower it if you have a fast connection, raise it if pages load slowly for you.

Because KeeForm cannot tell that you are already signed in. When you start it for a site, it simply waits for login fields to appear and stays armed until either a form is filled or the countdown runs out. On a page where you are already logged in, no login fields appear, so nothing is filled — KeeForm just keeps waiting until the timer ends.

You can end it immediately by clicking the orange toolbar icon, which stops the countdown, discards the credentials, and removes any blue lock icons. KeeForm only fills recognised login fields, so the risk is low, but ending the session once you are done is good practice.

You don't need to. KeeForm now keeps looking and filling automatically for the whole session, retrying as the page changes until the countdown ends. In older versions clicking the toolbar icon started another fill attempt; that is automatic now, and the toolbar icon is the cancel/discard button instead.

To fill a specific field yourself at any moment, click its blue lock icon or Ctrl+click it.

• Green — connected to the KeeForm host and ready.
• Blue — waiting for the host (e.g. at startup, or when another browser is connected). KeeForm reconnects automatically.
• Red — cannot connect to the host. Check that the KeeForm application is installed and not blocked by antivirus.
• Orange with countdown — a session is active; KeeForm is filling or waiting to fill, and Ctrl+click is available.
• Checkmark (✓) — the last session filled successfully. For a few seconds you can click the icon to fill again (handy if the page redraws and clears the form); after that the credentials are discarded.

It means the form was filled successfully. For a few seconds afterwards KeeForm keeps the credentials so you can click the toolbar icon to fill again — useful if the page reloads or redraws and clears the form. Once the checkmark clears to the plain icon, the credentials have been discarded and nothing further is needed. You can change how long this lasts with the Re-fill window setting (or set it to 0 to discard immediately).

Some sites reload or redraw the login form a moment after it first appears — for example when a "Sign in with Google" or "Sign in with Apple" button finishes loading and the page re-renders. If that happens just after KeeForm filled the form, the site's own redraw clears the fields. KeeForm had already finished and reported success, so it does not keep typing into the page on its own.

To recover, wait until the form stops moving and click the KeeForm toolbar icon while it still shows the checkmark (✓). KeeForm keeps the credentials for a few seconds after a successful fill for exactly this case, and a click re-fills the settled form. If the checkmark has already cleared to the plain icon, the credentials are gone — just start KeeForm again from KeePass.

You can lengthen this window, or switch it off, with the Re-fill window setting. During the window the page stays safe: nothing is filled unless you click.

KeeForm only decorates fields it recognises as part of a login form. If you see two username fields with blue lock icons but the password field without one, that is deliberate: KeeForm found more than one possible username (for example a "log in with email or phone" form) and will not guess which you want, so it asks you to pick. The password field had no such ambiguity, so it is ready to fill as soon as you choose a username.

Detection isn't perfect, and occasionally a field KeeForm can fill doesn't show a blue lock icon straight away. First, try clicking the field — in almost all cases the lock icon appears once the field is focused. Even when the lock icon isn't visible, the centre of the field may already be active, so clicking the middle of the field can trigger filling.

You can also Ctrl+click the field, which works whenever KeeForm has recognised it. For a field KeeForm doesn't recognise at all, enable Force-fill any field and Ctrl+click it.

In Click to fill (the default), KeeForm finds the login fields and shows the blue lock icons but enters nothing until you click a lock icon or Ctrl+click a field. In Automatic, KeeForm fills the form as soon as it finds it. Click to fill is the safer default — you decide exactly when credentials are entered.

If you preferred how KeeForm behaved before — filling immediately, no icons — choose Automatic and turn Show icons off; that is close to the previous version's behaviour (with Ctrl+click added, which still works).

Automatic does not mean KeeForm fills everything on its own. When it cannot fill safely it still shows a blue lock icon and waits. The most common case is a page showing only a username field (no password yet): to KeeForm this looks the same as an ordinary text box such as a site search, so it will not type your username into it unprompted. It shows a lock icon instead — click it to fill.

The same applies when several candidate fields are present. This is intentional, so KeeForm never enters your details into the wrong field.

Ctrl+click any login field to fill its form. It is the most deliberate way to fill — nothing happens unless you hold Ctrl, so clicking around the page can never trigger a fill by accident. Because KeeForm has recognised the form, a single Ctrl+click can fill more than one field — typically both the username and password together.

Use it whenever you want to be certain, or to fill a recognised field without hunting for the lock icon. Ctrl+click works in every mode.

An expert option (off by default). Normally KeeForm only responds to fields it recognised as part of a login form. With Force-fill any field enabled, Ctrl+clicking any text field enters the username and Ctrl+clicking any password field enters the password — even on fields KeeForm did not recognise. It bypasses detection for the one field you click, so use it deliberately on unusual sites where normal detection fails.

Yes — uncheck Show icons in the options. KeeForm will still detect and fill forms; you just trigger filling with Ctrl+click instead of clicking a lock icon. This is handy if you find the icons distracting, prefer a cleaner page, or are on a site where they don't display correctly.

You control this with the Multiple forms setting (shown in Automatic mode): Fill first form, Fill all forms, or Let me choose. With Let me choose, KeeForm does not fill automatically — click the blue lock icon on the form you want, or Ctrl+click one of its fields.

On the first page only the username field is usually shown. KeeForm does not fill it automatically, even in Automatic mode: a single field on its own is indistinguishable from an ordinary text box, and we don't consider it safe or reliable to type your username into it unprompted.

So click its blue lock icon (or Ctrl+click) to fill the username, then submit. As long as the countdown is still running, KeeForm carries on watching the next page, and on the password step Automatic mode fills the password (in Click to fill, a lock icon appears on the password field for you to click).

No. KeeForm detects login fields by their position and type rather than by reading page text (so it works in every language). Occasionally a lone text field, such as a site search, looks just like the first step of a login. The blue lock icon does nothing unless you click it, so you can ignore it.

If the real login form hasn't appeared yet, it may be tucked behind a menu or a "Sign in" button that opens a dialog — open it, and KeeForm will detect and decorate the actual login fields.

No. KeeForm never has access to your password database. KeePass pushes only the single username and password for the entry you opened; KeeForm uses them to fill the form and then discards them. Nothing is stored by the extension, and KeeForm does not send the credentials to any server or third party.