Skip to main content
Documentation & User Guides | Fotoware

Dynamic tags

Dynamic tags can be used to automatically insert text, such as the current date and time or the current user's username or email address, into a search expression or a metadata field.

Where can dynamic tags be used?

Dynamic tags can only be used in pre-configured searches, such as in taxonomies and smart folders.

You can use dynamic tags: 

Note: Dynamic tags cannot be used for immediate searches, such as in the search box or the extended search dialog.

If you use dynamic tags where they are not allowed (e.g., in the search box), the search is executed without causing an error, but the search term which contains the dynamic tag will not match anything. For example, if you enter
mtf:{{now}} or never in the search box, the result will contain matches for the string never but will not be filtered by file modification time. 

Available tags

Every valid dynamic variable is expanded to its value, which is usually used as a literal string. In search expressions, it can also be interpreted as a date/time value or number.

For a list of dynamic variables and how to use them, see:

Dynamic tags in metadata macros

If a dynamic tag appears in a metadata macro in an action, it is expanded when the action is run.

Metadata macros allow additional dynamic tags that expand to metadata of the assets processed by the action or parameters of the action or task:

For backward compatibility, some additional tags that expand to the current date and time are available in metadata macros. Some tags behave differently when used in metadata macros. For more information, see Legacy Date/Time Tag Reference.

Dynamic tags in search expressions

Dynamic tags can be used directly in search expressions in the following places:

Dynamic tags in search terms

If a dynamic tag appears as an independent term (i.e., outside of double quotes), its value is used as part of the search expression as if it was given literally. For example, consider the expression:


The value of this tag is the current date and time in ISO 8601 format, for example,


So, the resulting expression will do the same as


i.e., search for all assets with a modification time of 12:30:45 on 17th of May, 2023 in local time.

If the dynamic tag has invalid syntax, then the entire search expression is malformed.

Dynamic tags in search phrases

A phrase (search text in double quotes) may contain multiple dynamic tags. When the search is executed, each dynamic tag is expanded to its value. For example:


This expression searches for all assets that were modified since the start of the current hour until now. For example, it might translate to:


Note that the contents of the phrase on the left of the ~~ operator are interpreted as a date/time value. This is because it appears as an operand of a range operator. The left operand is created using two dynamic tags. One expands to the current date, and the other expands to the current hour.

If a dynamic tag in a phrase has invalid syntax or is invalid for another reason, then it is not replaced. All other tags are still replaced if they are valid.

How dynamic tags are interpreted in stored searches

If a search expression with a dynamic tag is stored - for example, an expression using the date tag {{now}} - the tag will be resolved when executing the search, not when it's stored. For example, this applies to searches in SmartFolders and taxonomy custom searches.


then contents of the smart folder are always the result of a search for all assets modified since the day before the current day.

Dynamic tag syntax

In general, a dynamic tag looks as follows:






NAMESPACE The namespace (or category) of the tag. For example, the now namespace has tags that expand to the current local time.

In the tag


the namespace is now. The tag

does not have a namespace.


ID The id of the tag. Together, the (optional) namespace and the ID define what the tag does.

In the tag


the ID is date. In the tag


the ID is now.

ARGUMENT An optional argument following a colon. Some tags are parameterized, which means they require an argument.

The tag


is a parameterized tag. It expands to the value of the Departmentproperty in the property bag of the current user.


Some dynamic tags allow specifying an offset, which is always a time duration or a number. The offset may be positive or negative, indicated by a plus or minus sign that must precede the offset.

If the offset is a time duration, it must be given in ISO 8601 format, which is explained below.

The tag


has an offset of "plus one day" and expands to the date and time one day after the current time.

The tag


has an offset of minus one and expands to the number of the year before the current year.