Skip to main content

Profiles

Search profiles control how search queries are executed, including which fields to search, their relative importance, and rules for boosting or filtering 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.
  • Boosting rules: Configure rules to promote or demote products.

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

Configuring Boosting Rules​

The Boosting rules tab controls how products are ranked in search results.

  1. From the profile, select the Boosting rules tab or click Edit next to Boosting rules.
Boosting rules configuration

Text Match Type​

Select how scores from multiple matching fields are combined:

OptionDescription
Best single field matchUses the highest score from any matching field. Best for general product search.
Highest weighted fieldUses the score from the highest-weighted matching field. Use when field importance matters more than match quality.
Sum of all matchesSums scores from all matching fields. Rewards products that match in multiple fields.

Boost Factors​

The Boost factors table allows you to increase or decrease the importance of specific attributes.

ColumnDescription
AttributeThe attribute to boost.
Boost factorA multiplier for this attribute's contribution to relevance. Higher values increase importance.

Advanced Boosting Rules​

Advanced boosting rules allow you to promote or demote products based on specific conditions such as categories, tags, or attribute values.

The Advanced boosting rules table has the following columns:

ColumnDescription
Rule nameThe name identifying the rule.
Boost factorThe weight applied when the rule condition is met.

To create a rule, click + New Rule and select an option from the Boost products in/with menu.

Hierarchy & Node (Categories)​

Boost products based on their category assignment.

  1. Select Hierarchy & node (categories).
  2. A pane appears with a table showing Name, Slug, and Last updated columns.
  3. To drill down into a node with children, click the > symbol to the left of its name.
  4. Select the node you want to boost.
  5. Click Add Selected.
  6. Enter a Boost Weight (positive values promote, negative values demote).
  7. Save the rule.

Product Tags​

Boost products that have specific tags.

  1. Select Product tags.
  2. A list of available tags appears.
  3. Select the tag you want to boost.
  4. Click Add Selected.
  5. Enter a Boost Weight (positive values promote, negative values demote).
  6. Save the rule.

Product Attribute​

Boost products based on attribute values.

  1. Select Product attribute.
  2. Select the attribute you want to use.
  3. Click Add Selected.
  4. In the Configure rule pane, set the condition:
    • Select an operator: Equals, Contains, Not Equal, or Starts with.
    • Enter a Value to match against.
    • Enter a Boost Weight (positive values promote, negative values demote).
  5. Save the rule.
note

The available operators may vary depending on the attribute type.

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