Skip to main content
Documentation & User Guides | Fotoware

Searching for assets

 

When you log in to FotoWeb with a Standard or Plus user license, the site's home page is displayed. There is a large search bar at the top of the screen.

FotoWeb FR8 Search bar Main UI.png

When you access an archive, the search bar is located on the top banner:

FotoWeb FR8 Search bar in grid.png

If you are using FotoWeb Pro, see Searching for assets in FotoWeb Pro.

Performing a basic search

To perform a basic search, simply start typing words in the search box. This will execute a full-text search across all the entire definition of metadata fields.

Example:

beautiful beach

By default, this is be construed as the precise string "beautiful beach".  How FotoWeb interprets searches that contain several words without quotation marks to separate them can be configured by the FotoWeb administrator in the search string modification settings.

Searching for an exact phrase

To search for an exact phrase, such as a complete name, enclose the phrase in quotation marks:

"barack obama"

This only returns matches in assets that contain the exact phrase barack obama. It does not return assets that contain the phrase president obama, for example.

Searching in specific fields

To search in a specific field, specify the field followed by the word or phrase you're searching for.

For example, to search for winter in the Keywords field (field no 25):

25:winter

You can also expand this search, for example, you can search for winter and snow as keywords in field 25:

25:winter & 25:snow

This example uses the boolean operator AND. There is a complete list of such operators below.

To expand the search further, you can search for winter and snow in field 25 and the phrase alpine skiing in the caption (field 120):

25:winter & 25:snow & 120:"alpine skiing"

Note: In the last example above, a search string such as 25:winter&snow will produce another result, since it specifies a search for winter in field 25, while the search for snow is based on free-text in all fields in the metadata definition since no field is specifically set for that term.

For a complete list of XMP fields in the definition that comes with the standard Fotoware installation, see XMP field code reference

Wildcard characters

You can use wildcard characters in a search to help you find what you are looking for: 

? (question mark)

Matches any single character

Example:

shoe? 

This search will match the word shoes, but not shoe.

* (asterisk)

Matches any number (including zero) of characters

Example: 

shoe*

This search will match shoe, shoes, shoestring, and so on.

Example: Searching for filenames using wildcards

fn:*.jpg

Finds all assets whose filename has the extension .jpg. A complete list of specifiers (predicates) can be found in the search reference.

Boolean search

The following boolean operators can be used:

Operator Example search Result
AND / &

winter & snow

winter AND snow

Finds assets with both words present. 

Note: The AND operators can be omitted. If two clauses are put next to each other, they are implicitly combined using the AND operator

OR / |

apples OR pears

apples | pears

Expression matches if both or both operands match.
NOT / - apples NOT pears Expression matches assets with the words apples that do not also contain the word pears

For more information, see the search expressions reference.

Numeric range search

A numeric range search can be used to search for pictures of a certain size, assets within a date range, and so on.

There are two range forms that can be used, closed range form and open range form.

Closed range form example:

pw:800~~2048

This executes a search for pictures with a pixel width in the range of 800 to 2048 pixels.

Open range form example

pwf:800 AND pwt:2048

This is essentially the same search; we have specified pixel width from (pwf) and pixel width to (pwt). See FotoWeb search expressions reference for a complete list of operators.

The benefit of using an open range form is that you can specify only an upper or a lower limit. So if you're interested in finding pictures that are 800 pixels wide or more, but don't want to specify an upper limit, your search can look like this:

pwf:800

 

Example 1: Searching for assets that have been modified between Jan 1st and 31st 2022

mt:2022-01-01~~2022-01-31

Here you use the mt specifier, modified time, which lets you set an interval.

Example 2: Searching for assets that have been modified since Jan 1st 2022

mtf:2022-01-01

This search uses the mtf specified, modified time from, without specifying an end. Consequently, all files modified since the specified start date will be found.

Example 3: Searching for assets that have been uploaded since Jan 1st 2022

A slightly different approach is needed when searching in XMP date fields: To find files that have been uploaded since Jan 1st, 2022, we can perform a search in the Uploaded time field (no 362). The syntax looks like this:

362:2022-01-01~~9999-12-31

Since there is no way to specify an end date representing today, you can use a date far in the future - in this case we've set the end date in the year 9999. The same can be used to set a start date far in the past - you can set the start date in the year 1700, for example, to make sure you include all files since then.

For a complete set of available search expressions, see the FotoWeb search expressions.

Extended search

When searching for assets, you can use extended search parameters to more closely specify which fields to search in, folder names to include, and more. For more informatio, see Using FotoWeb extended search.

Search result display

When you have executed a search, a number on each archive tab indicates the number of matches in each archive, and you can switch between archives to see the files.

Clearing the search

To clear the search, select X in the search field.

Other ways to locate files

While searching is a convenient way to locate the files you're looking for, browsing archives by folders or taxonomies, when available, is also very useful to find assets.

A complete overview of FotoWeb's search capabilities can be found in the Search Expressions reference article.

Searching for assets using Asian languages

 

Some Asian languages (such as Thai, Chinese, Japanese, and Korean) do not have spaces between all words. To support full text search in these languages, FotoWeb automatically wraps search words in Asian languages between wildcard characters. For example, if you search for "สตาร์คราฟต์", FotoWeb internally searches for "*สตาร์คราฟต์*". This causes the search to match assets where the search word appears in a sentence in the Thai language without being separated from the rest of the text by spaces.

Wildcard  character wrapping is applied separately to each word in a search expression. It is only applied to words that contain letters in one of the following languages: Thai, Korean, Japanese, Chinese (not including rare and historical characters with Unicode values above U+FFFF). This means that when searching for words that do not contain any of these Asian characters, such as numbers or names in Latin characters, you have to manually enclose them in wildcard characters. For example, you need to manually search for "*1950*" instead of "1950" to match the number "1950" in a sentence in Chinese, where "1950" is not separated from the rest of the text by spaces.

Wildcard character wrapping is applied to full-text searches and taxonomy searches (regular and custom searches) as well as field searches using the API. In all cases, wildcard characters are applied per word.

Note: Wildcard Wildcard character wrapping is applied to full-text searches and taxonomy searches (regular and custom searches) as well as field searches using the API. In all cases, wildcard characters are applied per word.wrapping as described above has an impact on performance and will increase search times.