Skip to main content

Profiles

Search profiles control how search queries are executed, including which fields to search, their relative importance, and filters that apply to results.

To access search profiles, go to Merchandise > Search > Profiles.

Search profiles list

The Profiles screen displays a table of all configured search profiles with the following columns:

ColumnDescription
Profile nameThe name/slug of the profile.
DescriptionA description of the profile's purpose.
FieldsThe number of searchable fields configured.
MenuActions menu for managing the profile.

One profile is marked as the default and is used when no specific profile is requested.

Creating a Search Profile

  1. Go to Merchandise > Search > Profiles.
  2. Click +New Profile in the top right.
  3. Enter a Slug (required) to identify the profile.
  4. Enter a Description to explain the profile's purpose.
  5. Configure the profile using the tabs described below.
  6. Save your changes.
New profile form

The profile configuration screen has the following tabs:

  • Overview: General profile details (slug and description).
  • Searchable attributes: Configure which fields are searchable and their weights.
  • Search scope: Configure filters that apply to all searches using this profile.

Configuring Searchable Attributes

The Searchable attributes tab controls which fields are included in searches and their relative importance.

  1. From the profile, select the Searchable attributes tab or click Edit next to Searchable attributes.
Searchable attributes configuration

There are two tables:

  • Core Attributes: Standard product fields such as name, description, and SKU.
  • Extended Attributes: Custom fields from your product templates.

Both tables have the same structure. Toggle Searchable for this profile to include or exclude each attribute from searches using this profile.

Configuring Search Scope

The Search scope tab allows you to define filters that are automatically applied to all searches using this profile.

  1. From the profile, select the Search scope tab.
  2. In the Filters table, click + Add filter to add a new filter.
  3. Configure your filter criteria.
Search scope filters

Managing Profiles

Each profile in the list has a menu icon on the right with the following actions:

ActionDescription
Make defaultSet this profile as the default for all searches.
DuplicateCreate a copy of this profile.
DeleteRemove this profile.
Ask External AI