| Field ReferencesHow to put references to data in fields of other entries. |
Introduction
KeePass can insert data stored in different entries into fields of an entry. This means that multiple entries can share a common field (user name, password, ...), and by changing the actual data entry, all other entries will also use the new value.
To create a field reference, you can either use the convenient field references wizard (in the entry editing window, click the 'Tools' button at the bottom left and select 'Insert Field Reference'), or insert the placeholder manually (see the syntax below).
Note that field references are intended for referencing data stored
in different entries. If you want to insert data from the
same/current entry, you should use local placeholders, like
{TITLE} and {S:FieldName};
see Placeholders.
Placeholder Syntax
The placeholder syntax for field references is the following:
{REF:<WantedField>@<SearchIn>:<Text>}
The WantedField and SearchIn parts need to be replaced by 1-letter codes identifying the field:
| Code | Field |
|---|---|
| T | Title |
| U | User name |
| P | Password |
| A | URL |
| N | Notes |
| I | UUID |
| O | Other custom strings (KeePass 2.x only) |
The Text part is the search string, i.e. this text must occur in the specified field of an entry to match.
If multiple entries match the specified search criterion, the first
entry will be used.
To avoid ambiguity, entries can be identified by their UUIDs, which are unique.
Example:
{REF:P@I:46C9B1FFBD4ABC4BBB260C6190BAD20C} would insert the
password of the entry having 46C9B1FFBD4ABC4BBB260C6190BAD20C as UUID.
Example
Let's assume you have two entries: one with title "Mozilla Website"
and one with "Mozilla Forums", and want to insert the user name
of the website account into the URL of the forums entry. Within the forum entry's
URL, you could reference the user name like this:
http://fictitious-forum.mozilla.org/?user={REF:U@T:Mozilla Website}