Content search

Get help with searching in the Web App

Overview

This article explains how to use our Web App to search through your content*. As you can search in many locations, and in a few different ways, we’ll cover searching for content (C), media (M) and content models (CM).

* If you want to find search documentation for the API, read our Documentation pages.

Contents:

  1. Simple keyphrase search (C, M, CM)
  2. Search within a Content Type (C)
  3. Get contextual help (C, M)
  4. Use match operators (C, M)
  5. Filter by reference value (C)
  6. Search for references (C)
  7. Media specific searches (M)
  8. Troubleshooting (C, M, CM)

1. Simple search with a keyphrase (C, M, CM)

Start by typing a keyphrase in the search input to search through all of the text fields (short and long) within your entry:

Some notes:

  • The search function is case insensitive.
  • It also works on each key type after the third character without explicitly saving so you can validate your search terms on the fly.
  • Quotation marks around text values, both single and double, will work - but make sure that you include both of them or not at all.

2. Search within a Content Type (C)

When you want to search within a specific Content Type, use the drop down menu to the left of the search input field and select one of the available content types.

3. Get contextual help (C, M)

If searching with a keyphrase is not enough, you can press the down arrow. And when you focus on the search area you will get a list of all the options at hand. When using the contextual drop down menu you can select some predefined values if they are available. Select, or press enter on, any of these types and you’ll see the following:

  • Date type fields, where you get a datetime picker.
  • Boolean type fields, where you get either "yes" for true or "no" for false.
  • Short text type fields, where you'll get the distinct values that you defined as your only accepted terms (like in a radio buttons list or a drop down).

content search help 3 contextual help

4. Use match operators (C, M)

When it comes to evaluating or comparing values, there is a set of operators you can use:

Content types : <= < >= > == yes no
Text (short / Long) Supported x x x x x x x
Number (integer / Decimal) x Supported Supported Supported Supported Supported x x
Date and time x Supported Supported Supported Supported Supported x x
Boolean x x x x x x Supported Supported
Image Dimension x Supported Supported Supported Supported Supported x x
Cell x Supported Supported Supported Supported Supported x x

5. Filter by reference value (C)

Let's say you have a collection of blog posts that belong to a certain category. If you want to find all the posts in that category, then you need to search for them using a specific reference. To do this you need to provide the ID value of the category.

To find the ID value, go to the “Info panel” of the entry:

6. Search for references (C)

Not to be confused with the "Filter by reference values" search option, "search for reference" is a search alternative that only shows up in the entry editor when you have fields with reference type and you want to find an entry to link to.

For example, when you want to find and assign a category to a blog post.

Here, some options such as filtering by content type are not available as the amount and type of content you can search in is set in the field validation tab, under the Content model section.

7. Media specific searches (M)

Assets can additionally be searched by certain meta data types. These types are:

  • Width
  • Height
  • Type
  • Size
  • Filename

Depending on the field type (like Text or Number), you can use the operators mentioned above to configure your search.

8. Troubleshooting (C, M, CM)

My search does not return anything

Currently, if you just type in a keyphrase it will search in all of the text fields in the entry. However, if you prefix the keyphrase with a specific field name (for example name : John) then you need to include the entire value (for example name : John Doe).

I have a field called author - why is it not searchable?

That's because author is a reserved word. The full list of reserved words reads:

  • id
  • author
  • status
  • updatedAt
  • createdAt
  • publishedAt
  • firstPublishedAt

While it's possible to name fields using reserved words, such fields are not searchable.

Have more questions or comments? Feel free to reach out to us by sending an email to support@contentful.com.

Discover Contentful

Learn how Contentful works

Read about our content management infrastructure, our flexible APIs and our global CDN.
View key features

See how our customers use Contentful

From apps and sites to digital signage and iBeacon campaigns — we deliver content everywhere.
Explore other customers