GQL Full-text Search gql-full-text-search

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Explore the GQL full-text search feature in Experience Manager Assets. Use it to search for assets based on specific metadata, such as title, description, and author name.

The GQL full-text search feature lets you search for assets based on specific metadata, such as title, description, author, and so on.

To search for an asset based on its metadata, for example title, specify the metadata keyword followed by its value in the search panel. The GQL full-text search feature will fetch only those assets whose metadata exactly match with the corresponding value you enter.

For example, to search for assets that have the title “Target,” perform these steps:

Searching Assets searching-assets

  1. From the toolbar of the Assets user interface, click or tap the Search icon to display the Omnisearch box.

  2. With the cursor in the Omnisearch box, press Enter.

  3. Click or tap the GlobalNav icon to display the Filters panel.

  4. In the Omni Search box, specify the value “Target.” To limit your search to a specific folder, click or tap the Browse icon in the Filters panel and select the folder. In this case, the match is searched for only within the folder and the subfolders under it.

    note note
    NOTE
    You can also perform full-text search on folder. In this case, you must specify a non-empty full-text search term.

    gql_search

  5. Press Enter. The Assets user interface displays only those assets whose title exactly matches “Target.”

The GQL full-text search feature lets you search assets based on the following:

  • Complex query built by combining through an And operation, the values you specify for multiple metadata fields (properties)
  • Multiple values for a single metadata field
  • Substring matches

The GQL full-text search feature lets you search for assets based on the following metadata properties. Names of the properties (for example author, title, and so on) as well as values are case sensitive.

NOTE
GQL full-text search works for full-text predicates only.
Property
Search format (facet value)
Title
title:John
Creator
creator:John
Contributor
contributor:John
Location
location:India
Description
description:“Sample Image”
Creator tool
creatortool:“Adobe Photoshop 7.0”
Copyright Owner
copyrightowner:“Adobe Systems”
Contributor
contributor:John
Usage Terms
usageterms:“CopyRights Reserved”
Created
createdMM:SS.000+05:30…YYYY-MM-DDTHHSS.000+05:30
Expires Date
expiresMM:SS.000+05:30…YYYY-MM-DDTHHSS.000+05:30
On time
ontimeMM:SS.000+05:30…YYYY-MM-DDTHHSS.000+05:30
Off time
offtimeMM:SS.000+05:30…YYYY-MM-DDTHHSS.000+05:30
Range of time (expires dateontime,offtime)
facet field: lowerbound…upperbound
Path
/content/dam/<folder name>
PDF Title
pdftitle:“Adobe Document”
Subject
subject:“Training”
Tags
tags:“Location And Travel”
Type
type:“image\png”
Width of image
width:lowerbound…upperbound
Height of image
height:lowerbound…upperbound
Person
person:John

Here are some examples of search formats for complex queries:

  • To display all assets with multiple facets fields (for example: title=John Doe and creator tool = Adobe Photoshop):

tiltle:“John Doe” creatortool : Adobe*

  • To display all assets when the facets value is not a single word but a sentence (for example: title=Scott Reynolds)

title:“Scott Reynolds”

  • To display assets with multiple values of a single property (for example: title=Scott Reynolds or John Doe)

title:“Scott Reynolds” OR “John Doe”

  • To display assets with property values starting with a specific string (for example: title is Scott Reynolds)

title:“Scott”

  • To display assets with property values ending with a specific string (for example: title is Scott Reynolds)

title:“Reynolds”

  • To display assets with a property value that contains a specific string (for example: title = Basel Meeting Room)

title:“Meeting”;

  • To display assets that contain a particular string and have a specific property value (for example: search for string Adobe in assets having title=John Doe)

*Adobe* title:"John Doe "OR title:“John Doe” *Adobe*

NOTE
The properties path, limit, size, and orderby can’t be ORed with any other property.
The keyword for a user-generated property is its field label in the property editor in lowercase, with spaces removed.
NOTE
If you write a JCR query to search for subassets only, the matched referenced assets are also displayed along with the matched subassets.

Full text search also supports operators such as -, ^, and so on. To search these letters as string literals, enclose the search expression in double quotes. For example, use “Notebook - Beauty” instead of Notebook - Beauty.

You can improve the relevance of keywords for particular assets to help boost searches based on the keywords. In other words, the images for which you promote specific keywords appear at the top of the search results when you search based on these keywords.

  1. From the Assets UI, open the properties page for the asset for which you want to promote a keyword.

  2. Switch to the Advanced tab and click/tap Add under Elevate for search keywords.

    elevate_for_search

  3. In the Search Promote box, specify a keyword for which you want to boost the search for the image and then click/tap Add. In necessary, specify multiple keywords in the same way.

    add_search_word

  4. Click/tap Save & Close.

  5. Search for the keyword using the Omnisearch box. The asset for which you promoted this keyword appears among the top search results.

recommendation-more-help
4452738f-2bdf-4cd4-9b45-905a69d607ad