Placeholders

Placeholders are tokens that Keyguard replaces with real data at the moment you use a field — copying it, opening it in a browser, and so on. The syntax is largely based on the KeePass specification.

Placeholders currently work in:

• an item’s URL field;
• URL override commands.

How resolution works

• Placeholder names and their basic parameters are case-insensitive — the comment prefix {c:...} is the one exception and must be lowercase.
• All placeholders in a field resolve at the same shared instant, so time-sensitive placeholders stay in sync with each other.
• A known placeholder with no value resolves to an empty string — {otp} becomes nothing if the item has no one-time password configured.
• An unknown placeholder is kept as-is — {keyguard} stays {keyguard}.

Item fields

> https://example.com?user={username}
https://example.com?user=joe

Custom fields

Reference a custom field by name with {s:name}. For example, if an item has a custom field named “Email”, {s:email} resolves to its value. If several fields share the name, the first one wins.

> https://example.com?license={s:license}
https://example.com?license=12345678ABCD

URL parts

Available in URL override commands. These extract pieces of the URL being overridden, so your command can reassemble them. {base} is identical to {url} and supports the same parts.

For the URL https://user:pw@keepass.info:80/path/example.php?q=e&s=t:

Text transformations

Replace with a regular expression

{t-replace-rx:/text/search/replace/}

The first symbol after : defines the separator — any symbol except { and } — and the trailing separator is required.

If the username field contains username@example.com:

> {t-replace-rx:/{username}/.*@(.*)/$1/}
example.com

See the underlying implementation’s documentation for the exact regex semantics.

Convert to another representation

{t-conv:/value/type/}

The separator works the same way as above. Supported types:

• u or upper — uppercase;
• l or lower — lowercase;
• base64 — Base64 (no padding, no wrap, URL safe);
• hex — HEX (lowercase);
• uri — URI-encode;
• uri-dec — URI-decode.

> https://example.com?user={username}&password={t-conv:/{password}/uri/}
https://example.com?user=joe&password=Password1%21

Environment variables

System environment variables are supported; enclose the variable name in % characters.

> {%HOME%}
/home/username

Date and time

Local

UTC

Comments