How to install the Prefixbox AI Search & Filter App
Find all the details here:
Dashboard
On the Home page, you will find the some useful and relevant information regarding your plan and the configuration of your application.
Find all the details in this article:
Menu structure
In this second part of the user manual you will find detailed descriptions regarding the features of the application. Many of these features can be both accessed from the "Home" page through a shortcut, or using the main menu.
The application's main menu is the following:
For all the details visit this article:
Configuration menu
You can find all main configuration options under the configuration menu, which has 3 tabs:
Configuration -> General
On the 'General' tab you can handle everything from catalog syncing to how Prefixbox interprets your product data.
Synonyms – Link similar words to improve search coverage.
Field management – Pick which Shopify fields (e.g. tags, product types) are used in search and filters.
Catalog sync – View product catalog sync status and history, or force a manual sync.
Catalog settings – Control how out-of-stock products are handled.
Search relevance – Fine-tune results with field weighting and spell correction.
Language – Add and manage translations.
Theme overview – Check if Prefixbox is active on your themes.
Configuration -> Search & collection pages
On the 'Search & collection pages' tab you can customize what shoppers see when they land on result or collection pages.
Filters – Choose which filters appear, their order, and their behavior.
Sorting – Set up default sort orders and add custom ones.
Pagination – Decide how many products load and how they load (e.g. infinite scroll).
Product cards – Pick what info appears on each product tile (price, image, CTA).
Result page texts – Update the messages shown on empty or filtered search results.
Configuration -> Autocomplete
On the 'Autocomplete' tab you can tailor the quick-suggestion dropdown (aka Instant Search or Predictive Search) for mobile and desktop separately.
Mobile/Desktop configuration – Control which suggestion types show up (e.g. products, collections), their order, and section labels.
Mobile/Desktop product cards – Choose what details are shown on product cards (e.g. price, title, badges, buttons). Configure these separately for mobile and desktop views.
General Tab - Theme embed overview
Get a clear overview of the embed status on your themes.
Click on 'View details' button. This will navigate to the "Theme overview" page.
As you can see on the current theme the core embed is already enabled, so you might continue with activating all the other modules. To activate the other modules click on the "Manage app embed" button.
The added themes are displayed in the 'Theme library'.
The "Manage app embeds" page will be displayed where you can see the selected theme or select another one. You can easily switch between themes here:
If you do not wish to select another theme, go on activating all the modules by clicking on the "Enable app embed" button.
This will navigate to the selected module's customization page where the module can be activated. Make sure that the toggle is on and always click on "Save" in the top right corner of the page.
The modules can be activated starting from the "Home" page as well. As you can see all these modules are still "Inactive" but these buttons will navigate to the right place where the modules can be added to the selected theme.
Clicking on the "Add to my theme" button for the first time a quick help will be displayed on how to add Prefixbox search to your theme. To navigate to the theme editor, click on the "Go to theme editor" button.
At the end of the process, the "App embeds and blocks" page should look like this:
That all the modules are "Active" will be reflected on the "Home" page as well.
General Tab - Synonyms
Synonyms let you connect different words shoppers might use for the same product — ensuring they see the right results, no matter which term they search for.
You can find this in Configuration > General > Synonyms.
For all the details visit this article:
General Tab - Field Management
Manage which product data fields Prefixbox AI Search can use.
⚠️ Important: You must enable the fields you want Prefixbox to use before creating custom filters, sorting options, or other search features. Without enabling them here, those fields won’t be available anywhere else in Prefixbox.
You can find this setting under Configuration > General > Field management.
For all the details visit this article:
General Tab - Catalog sync - Product catalog and Collections
Manage how Prefixbox handles your product catalog and keeps it up to date.
Catalog settings control how your products appear in search and collection pages, while catalog sync ensures Prefixbox always has the latest data from your store.
Both can be found in Configuration > Generic.
For all the details visit this article:
General Tab - Language
The application supports multilingualism. With just one click, a copy of the original website can be created in the selected language. The only prerequisite is that first the entire content of the original store must be translated into the selected language.
To find out more about how to translate your content, first you should install the
Translate & Adapt application and visit this site:
When all the prerequisites for making the store multilingual are met, this is where we can add the new language.
Go to "Configuration" > "General" tab > "Language" and click on "Customize" on that tile:
To add a new language click on the "Add language" button.
The Add language popup window will be displayed where you can select the language you wish to add then click on the "Add" button.
*Note: Please note that only those languages can be added to the application here that have first been added under Shopify's Settings > Languages menu and have also been set to published status.
When the new language is added, the setup process starts that will take a few minutes.
Language configuration - Edit display text
Once the setup is complete, you can start editing the display texts here:
The text content of the added languages can be edited on 5 tabs. Until any changes are made on these tabs, the configuration of the default language will apply to all languages. (The layout can only be edited in the Layout menu, meaning the configuration set there applies to all added languages.)
The 5 tabs are the following:
Filters&sorting
Search results
Autocomplete
Products
Custom filters
Filters&sorting tab
On this tab, you can edit the display text of the selected filters and sorting options.
When a new sorting option is added in the Layout configuration, it will automatically appear here as well, allowing you to edit its display text.
As soon as you start editing the text in the left-side panel, the changes will be dynamically displayed in the Preview panel.
Search results tab
On this tab, you can customize the text displayed on the search and category pages.
Autocomplete tab
Customize the text here for the Autocomplete box, which displays keyword, category, and product suggestions.
Products tab
On the Products tab, you can configure the text displayed on the "Add to Cart" button, the "Sold Out" badge, and the stock information.
Custom filters tab
Customize here the labels of your filters. All the filters that have been previously added at the Layout>Search layout settings configuration will be displayed here.
Unpublish a language
When a language has already been added, later it can be unpublished. To unpublish a language go to Shopify>Languages. Select the language and unpublish it.
If you return to the Prefixbox application, the "Unpublished" tag will indicate that the language is not currently active. All data related to this language is preserved—nothing is deleted. When you choose to republish it, everything will function as before. Even the display texts that were previously configured will be preserved.
Remove a language
If a language is removed, all content associated with it will be deleted. If you want to use that language in the store again, you will need to re-add it in the Languages menu and configure it from scratch.
By clicking on the "Remove" button, a confirmation modal is displayed as follows:
General Tab - Search Relevance
Fine-tune how Prefixbox ranks and returns search results for your store.
Search relevance settings control which fields matter most when matching search queries, correct typos automatically, and even use your order history to improve sorting. These settings help ensure your shoppers see the most relevant products first — even if they make typos or use less common terms.
You can find this in Configuration > General > Search relevance.
For all the details visit our article:
Search & Collection Pages Tab - Filters
Set and edit your filters on the Search and Collection pages at "Configuration" > "Search & collection pages" tab > " Filters" tile.
Filters allow visitors to narrow down search results based on specific criteria. By default, the Prefixbox app will display "Price", "Brand" and "Availability" filters.
Only filters relevant to displayed products will appear.
For example, if a search returns a product that does not have the attribute "Brand" set, the brand filter will not be displayed.
After you have added metafields at Fields management, you can make some of them filterable. However, not all the fields will be eligible for filtering.
Metafields that are not filterable will not even appear in the list of fields where you select fields that you wish to add as filters.
To assign the filterable attribute to your fields, follow these steps:
Go to "Filters". Here you can see the list of filters. By default three filters that have been automatically added when you installed the application: 'Price', 'Brand' and 'Availability'. The 'Field Label', 'Source' and 'Source type' attributes of the filters are displayed as seen in the picture below:
Add a new filter
To add a new filter click on the "Add filter" button.
The Create new filter page will be displayed, where first the source of the new filter must be selected:
'Filter search options'
By clicking in the "Select source" field, the list of filterable fields are displayed where you can select the field that you wish to add as a filter. As described previously, only those field values can be selected that are filterable. Use the search field to find the value you wish to add then select it by clicking on it.
When the value has been selected, you can start configuring the filter settings.
By enabling the 'Include search box' , your filter will become searchable. You can add a text that will appear in the search box of this filter.
'Filter value display' - has two values:
'Display all filter values' - all the values assigned to the filter will be displayed.
'Show only a number of values' - The list of values will be collapsible. First, only a number of values will be displayed, the rest can be added gradually. If you select this option, two more fields will be displayed:
'Show more button text' - if not all the values are displayed at first, by clicking on this button, the rest of the values will be displayed.
'Show less button text' - after the show more button is used, you can hide again the values using this button.
If you follow the above settings, here is an example of how your filter will be displayed on your online store:
'Filter values'
The values of the filters are displayed in a list that can be sorted in the following ways:
Manually
Alphabetical order (A-Z)
Alphabetical order (Z-A)
Result count (low to high)
Result count (high to low)
You can decide which values should be displayed for the selected filter on your store. There is a possibility to either exclude some values that are not needed, or create groups of values depending on how these should be displayed.
When the sorting is set to 'Manually', a drag&drop funtion is available to order the values.
'Exclude selected' values
When some values are excluded, the number of results will not be affected, but these values will not appear at the filter values, so they cannot be used to filter the results.
To exclude some values select them by enabling their checkbox, click on the "Exclude selected" button and save your modifications.
The excluded values will appear at the end of the list as follows:
The excluded values can be modified by deleting or adding new values.
'Create group'
Values can be selected and grouped. This action will not affect the number of the results. By selecting the newly created group when filtering the results, all the products that belong to the values selected into the group will be displayed.
To create a group of values select the values and click on the "Create group" button.
The 'Create group' popup will be displayed. Give a name to the group and save the group.
When the group has been created don't forget to save the modifications.
Add new filters one by one by clicking on the "Add filter" button.
Wait at least 5 minutes for the changes to appear.
Test your online store for changes.
Search & Collection pages - Product cards
Here you can customize the design of the product tiles on your Search & Collections pages.
Overview of product card configuration:
For all the details please visit our article:
Customizing Prefixbox Modules in the Shopify Theme Editor
You can visually style how Prefixbox modules appear on your storefront — directly inside Shopify’s built-in Theme Editor.
For all the details visit our article:
Autocomplete tab - Product Cards
Control how suggestions appear in the autocomplete panel — including layout, section labels, and number of items.
Visit our article for all details:
Integrations
If you want your products to be reviewable and allow customers to create wishlists, you can integrate applications specifically designed for this purpose. Such applications include Judge.me, Yotpo, and Swym Wishlist Plus. After downloading, these apps can be added to your store and activated under the Integration menu.
When the apps have been installed don't forget to enable them in the Theme editor. Make sure that the toggle is on for every application that you wish to use.
Merchandising
Promote the products you want to sell or send shoppers to the right page when they search with Redirects.
Merchandising modifications will be reflected in your store in just a few seconds.
Add a promotion
Ensure certain products appear at the top of the search results page (for pre-defined search terms) by creating a promotion.
To add a new promotion:
Go to Merchandising > Promotion.
Click on the “Add promotion” button.
The "Add promotion" page will be displayed where the fields in red are compulsory.
To create a rule you will need the following parameters:
Give a Name to your rule.
Define search term(s). You can define more than one search term. Type in the term and click on the "Add" button.
Set the start date. This determines when your rule becomes active. By default the date of the creation is set as the date of the creation of the rule, but you can adjust the date and the time. The "Run promotion indefinitely" checkbox is set by default which means that the rule does not have an end date. By not using this checkbox the "End date" and "End time" fields will become active, so you can set the end date for your promotion.
Click on "Browse" on the right side of the "Add products to promote" field and select the products you wish to promote with this rule.
The list of products will be displayed where you can search for the products you wish to promote and then select them. When the products have been selected, click on "Add".
The products that have been added will be displayed as seen in the picture below. You can still adjust the order of the promoted products using the drag and drop feature.
When everything is set for the new rule, don't forget to click on the "Save" button (either at the bottom or top), to save all the settings.
Wait a few minutes for the changes to become active. Then go to your online store and check that the new promotion rule works.
According to the example, if you search for "dress", the selected product(s) should appear on top of your search results.
You can add a maximum number of 10 products to a promotion rule.
The promotion you have added will appear in a list as follows:
Edit a promotion
To edit an existing promotion just click on it and do the necessary modifications then click on "Save".
You can add or remove keywords, modify the date and time of the promotion, add or remove products.
The modifications will appear on your store in about 5 minutes.
Remove a promotion
To remove a promotion just click on it. When the "Edit promotion" promotion page is displayed, scroll to the bottom of the page and click on the "Remove" button.
Add a redirect
A redirect rule will redirect your shoppers to a pre-defined URL whenever they execute a specific search query.
This can be useful in directing shoppers to informational pages. For example, if they search 'delivery' they will automatically be redirected to your content page outlining the delivery process.
You can add multiple terms to a certain rule.
To configure a redirect rule, follow these steps:
Go to Merchandising > Redirects.
Click on the “Add redirect” button.
The following window will be displayed where the fields in red are compulsory:
Name your rule.
Define search term(s). You can define more than one search term. To add new terms, just click on the "Add" button.
Provide the redirect URL and save the rule.
The new rule will be displayed in a table as seen in the picture below.
Wait a few minutes for the changes to become active. Then go to your online store and test your new redirect rule.
According to the example above, if you now search for "delivery" and press enter, you should land at https://admin.shopify/com/store/teststore/delivery page.
Edit a redirect rule
To edit an existing redirect rule just click on it and do the necessary modifications then click on "Save".
You can add or remove keywords, modify the url of the redirect.
The modifications will appear on your store in about 5 minutes.
Remove a redirect rule
To remove a redirect rule just click on it. When the "Edit redirect" page, click on the "Remove" button.
Change the currency format of your store
To edit the currency of your store:
Go to Settings>General>Store defaults
Read more about the currency formatting types here:
Analytics
On this page, you can see you search analytics.
You can set and customize the timeframe of the reports at the top right corner.
Account details
Review your current plan, usage limits, and catalog sync status.
The Account details page gives you a complete view of how much of your plan you’ve used — and when you’re approaching any limits.
Plan and usage
See your current plan (e.g. Free, Standard, Advanced) along with all usage quotas:
Monthly search quota – how many searches you’ve used this month
Product catalog size – how many products you’ve synced to Prefixbox
Search tool usage – how many promotions, redirects, and synonyms you’ve added
If you’re over any limits, you’ll see a yellow warning and a quick link to upgrade
To change your current plan click on "View plans".
Here you can see all the available plans including the current one. You can either upgrade the current plan or downgrade it, depending on your business needs.
You can read more about how to manage your subscription here:
Contact details
Add an extra contact — like your main merchandiser or support lead — so our team can reach out when needed.
This helps avoid missed messages, especially if you don’t monitor the Shopify admin email regularly.
Glossary
Search ER
Short for Search Engagement Rate.
Description: The proportion of Unique Searches with any click or cart event.
Unique Searches
Definition: Unique search queries that returned results. The same search query is counted only once in a session.
Search CTR
Short for Search Click-Through Rate
Definition: The proportion of Unique Searches with any click or cart event. It only differs from Search ER that this metric only counts clicks, not cart events.
Search CR
Short for Search Conversion Rate
Definition: The proportion of Unique Searches with any cart event. It only differs from Search ER that this metric only counts cart events.
Search Success Rate
Definition: The percentage of product search sessions in which users engaged with (clicked or carted) at least one product on the Search Engine Result Page. This includes products in Related Product and Autocomplete modules.
This differs from Search ER, as Search Success Rate is based on sessions, while Search ER is based on Unique Searches, making the scope different.
Searches
Definition: Total number of search engine result pageviews where results were returned. Paging, sorting and filtering creates additional pageviews as well.
SERP Click events
Definition: Total product Click events on the Search Engine Results Page.
SERP Cart events
Definition: Total number of product Cart events on the Search Engine Results Page.
Search Session Count
Definition: The number of sessions that included at least one search event.
Zero Result Search Rate
Definition: The ratio of Zero Result Searches to Unique searches. It measures the proportion of searches that do not return any relevant information or matches.
Zero Result Searches
Definition: Search results pageviews where the search engine returned 0 results. Zero result searches has three types: Time-out, Filter and Not found.
Zero engagement searches
Definnition: The number of Unique searches where there was no engagement (click or cart) on the SERP in the given period.