Topics

CMS search


In This Guide

Brightspot provides a number search, sorting, and filtering options to help editors locate the right asset at any time.


Full-text search

The easiest way to search for items is to type words you remember from the item in the Search field in the header. Starting with the second character you type, Brightspot uses full-text search to display all items having words with the characters you typed so far.

For example, after you type play, Brightspot displays all items having words that contain play, such as plays, playing, and play.

Every time you perform a full-text search, Brightspot saves the search term in the Recent Searches widget.

full-text-search.png


Filter search results

Full-text search can display many matching items, most of which may not pertain to the item for which you’re searching. You can narrow the retrieved items by filtering on fields in the search panel. Each time you make a selection, Brightspot immediately updates the list of filtered items.

You can also filter items without doing full-text search.

Except for step 1, all steps in the following procedure are optional.

To filter search results:

  1. In the header, click in the search field. The search panel appears.
    Filter search results example.png
  2. Type text in the Search field to perform a full-text search.
  3. From the topmost list, select the type of content for which you are searching. Making a selection from this list displays additional filter fields relevant to the content type. For example, if you select Article, Brightspot displays filter fields for AuthorSection, and Tag in the Article Filters section. This section changes based on the content type you chose.
  4. To search for an item based on a date range, expand the date range list and select from the following choices:
    • Any Publish Date—returns items of the selected status regardless of date.
    • Publish Date: Today—returns items of the selected status for today only.
    • Publish Date: Yesterday—returns items of the selected status for yesterday only.
    • Publish Date: Past 7 Days—returns items of the selected status from within the past seven days.
    • Publish Date: Past 30 Days—returns items of the selected status from within the past 30 days.
    • Publish Date: Custom—opens a date range picker that allows you to choose the start and end date of the date range you want to search for items of the selected status.
  5. To search by an item’s status, open the status list and select one or more of the following statuses.
    • Published
    • Archived
    • Draft
    • Revision
  6. To reset the search criteria, filters, and search results, click Reset at the top of the search panel.

Every time you apply a filter, Brightspot saves it along with the search criteria under the Recent Searches list (see the figure Recent Searches list).

Tip
Brightspot resets the global filters when you change the content type. For example, if you first search for articles with status Draft, and then search for images, Brightspot resets the status to Published. You can retain the values for the global filters as you change content types by turning on Enable Sticky Search Filters. For details, see Global site settings.


Configuring global filters

In the Global Filters widget, some filters are always visible, and some are in a collapsible widget. You can configure the filters appearing in that widget.

To configure placement of global filters:

  1. In the Global Filters widget, click settings. A Select Fields widget appears.
    Configuring global filters.svg
  2. Click fields in the Selected Fields column to move them to the Hidden Fields column. These fields appear in a More Filters or Less Filters widget.
  3. Click fields in the Hidden Fields column to move them to the Selected Fields column. These fields always appear under Global Filters.
  4. Click Update.

Configuring placement of content-type filters

In a content-type filters widget, some filters are always visible, and some are in a collapsible widget. You can configure the filters appearing in that widget.

To configure placement of content-type filters:

  1. Under Global Filters, select the required content type. A content-type filters widget (such as Article Filters) appears.
    Configuring content type filters.svg
  2. In the content-type filters widget, click settings. A Select Fields widget (such as Select Article Fields) appears.
  3. Click fields in the Selected Fields column to move them to the Hidden Fields column. These fields appear in a More Filters or Less Filters widget.
  4. Click fields in the Hidden Fields column to move them to the Selected Fields column. These fields always appear under the content-type filter.
  5. Click Update.

Search display options

The search panel includes a variety of controls you can use to modify the listing of retrieved items.

Search display options.png


Perform an advanced query search

Using the advanced query builder, you can compose retrievals to almost any level of complexity. For example, the advanced query builder can construct queries in the following MySQL patterns:

SELECT fieldnames WHERE field1 = A;
SELECT fieldnames WHERE field1 = A AND field2 = B;
SELECT fieldnames WHERE field1 = A AND field2 <> B;
SELECT fieldnames WHERE (field1 = A AND field2 = B) OR (field3 LIKE '%philosop%' AND field4 <> D);

The following procedure describes how to build a query that retrieves all articles containing the word Critique and authored by Immanuel Kant.

To perform an advanced query search:

  1. In the search panel, in the Filters widget, in the Advanced Query field, click edit. The Advanced Query Builder widget appears.

    Advanced Query Search.png

  2. From the drop-down list, select Match All (AND). This selection ensures Brightspot retrieves items that match all of the criteria you enter.
  3. Click Add Another Match All (And). A set of fields appears.
  4. Do the following:

    1. From the top drop-down list, select Comparison.
    2. From the next list, select Article.
    3. From the next list, select Any Fields.
    4. From the next list, select Contains Text.
    5. From the next list, enter Critique.
  5. Click Add Another Match All (AND). A new set of fields appears.
  6. Do the following:

    1. From the top list, select Comparison.
    2. From the next list, select Article.
    3. From the next list, select Author(s).
    4. From the next list, select Is:.
    5. Click the selection field, and select Immanuel Kant.
  7. Click Search.

The Advanced Query Builder widget closes, and the matching items appear in the search panel.


Search filters

The following table provides examples of search and filter criteria.


Filter search 1.png
Filters for any content type published between June 16, 2021 at 9:00 AM and June 30, 2021 at 9:00 AM.
Filter search 2.png
Filters for any content type published on or before June 30, 2021 at 9:00 AM and is currently in a status of draft. This scenario occurs if you publish an item and then subsequently create a new version of that item and save it as a draft.

Filter search 3.png
Searches for published articles containing the word imperative, and filters the results for articles authored by Immanuel Kant.

Filter search 4.png
Filters for images tagged careers containing colors close to black.
Tip
You can customize the search panel to match your workflow. For example, when filtering by Author, you can automatically filter by Article as well.


Sorting retrieved items

To sort retrieved items:

  • From the Sort list, select the field by which you want to sort the listing of retrieved items.

    The following fields are available to use for sorting:

    • Update Date
    • Calendar Date
    • Date
    • Label
    • Page Views
    • Publish Date
Tip
You can set the default search field for a content type.


Adding fields to search results

Brightspot lists the retrieved items with a standard set of fields. You can add fields to or remove fields from the listing.

To add fields to search results:

  1. From the Fields list, select Custom. The Select Fields widget appears.

    Add fields to search results_1.png

  2. Under Hidden Fields, type all or part of a field’s name. As you type, Brightspot filters the list of hidden fields.
  3. From the Hidden Fields list, toggle a field name. The field moves to the Selected Fields list.
  4. From the Selected Fields list, toggle a field name. The field moves to the Hidden Fields list.
  5. Click Update.

The Select Fields widget closes, and you return to the listing of retrieved items with the new fields appearing.

Tip
You can automatically include fields in the search results for a particular content type. For example, you can specify that the Author field always appear when filtering on Article.


Actions available from search results

The following table lists the actions you can perform on retrieved items.

To...See...
Bulk edit items in the search resultsBulk editing
Bulk archive items in the search resultsBulk archiving
Create a new collection from items in the search resultsCreating a collection from search results
Create a new work stream from items in the search resultsWork streams

Exporting search results

You can export the search results as a CSV file. This feature is available only if you filter by a particular content type.

To export search results:

  1. In the search panel, search for and filter the required items. Include a filter for content type.
  2. Do one of the following:
    • Mark the checkboxes for found items you want to export.
    • Clear all the checkboxes to export all found items.
  3. Click more_horiz, then select Export or Export All.

Your browser downloads a CSV file. The file contains a column for each column in the search results except Update Date and Viewers.


Saving a content search

If you repeat the same search often, you can save the search criteria in the search panel. You can then run the saved search without again entering the criteria.

To save a content search:

  1. In the search panel, create search criteria and filtering options as described in Filtering search results.
  2. Click more_horiz, then select Save Search. The Save Search widget appears.
    Saved search example.png
  3. In the Name field, type a name for the search.
  4. Click Save.

The Save Search widget closes, and the saved search appears in the Saved Searches list.

Save content search 2.png