Display a sequence of Search Filter options selected from a picklist in a Blueprint.

When using Targeted Search and Blueprint Maker to connect a Search Filter Group to a Blueprint picklist, there are additional display options to consider for display. These include displaying the human readable name (instead of the label) and also displaying human-readable multi-selections in a sequence. The steps and information below describe how to prepare your Blueprint for your preferred display.

Create a Page Blueprint

Begin by following the instructions outlined on Using Targeted Search Filters in a Blueprint Maker Blueprint. When it comes to placing the substitution field that represents your Filter Group picklist selection, proceed to the step below.

Set the substitution field syntax

There are several options to consider when placing and typing out the substitution field that represents your Filter Group picklist. As a reminder, during the Blueprint Wizard process, a user will be prompted to select one or more options comprised of Filters from a Filter Group. As the designer of the Blueprint, you must consider whether to display the human-readable name (AKA display name) or just the label (as text). If displaying human-readable names, you may also want to consider how to display multiple selections (e.g. as a comma-separated sequence). Use the table below to guide your decision.

SyntaxExample for BlueprintExample Output (multi-select)
(no additional syntax)[[office]]office-atlanta, office-oakland, office-chicago
-human-readable-filters[[office-human-readable-filters]]Atlanta Oakland Chicago
-human-readable-filters-comma-separated[[office-human-readable-filters-comma-separated]]Atlanta, Oakland, Chicago
-human-readable-filters-dash-separated[[office-human-readable-filters-dash-separated]]Atlanta-Oakland-Chicago

Proceed with defining your JSON 

Continue with the instructions on Using Targeted Search Filters in a Blueprint Maker Blueprint. Ensure that when defining your substitution field in the JSON as a blueprintField object, you set the "type" attribute to "list" and correctly set the "filterGroup" attribute to the name of the Filter Group (e.g. "Offices" in our example here).


If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.