The Keyword Search module shows products that match a Shopify product search query. It is flexible, and works well when you want a dynamic product pool without using a Shopify collection.
When to use it
Use Keyword Search when the product source can be described by tags, product type, vendor, title, or search terms.
- Show products tagged
accessory,gift, orbestseller. - Target product types like "Socks", "Refills", or "Travel Size".
- Build a product pool for campaigns without creating a collection.
- Create a fallback source that updates as product data changes.
Setup steps
- Open the upsell strategy you want to edit.
- In the Product modules section, click Add Module.
- Select Keyword Search.
- Build your product query. You can use tags, product types, product names, and availability filters.
- Review the product preview table to confirm the query returns the products you expect.
- Set the Recommended Quantity.
- Write Offer Text.
- Click Save.
Configuration options
Option | What it controls | Recommended approach |
Search query | The Shopify product search used to find products. | Use tags, product types, vendors, or title terms that are kept up to date. |
Preview table | Shows products currently matching the query. | Don't save until the preview matches your intent. |
Product filters | Adds extra limits after the query returns products. | Use filters for price and title guardrails. |
Offer Text | The message shown for matching products. | Write broad copy that works for every product in the query. |
Recommendations
Use precise query terms. A broad query can return products that technically match but don't make sense as upsells.
Need | Recommended query approach |
Campaign products | Use a campaign tag, such as |
Accessory category | Use product type or title terms that only match accessories. |
Exclude poor-fit products | Use hide filters in the query builder, or Hidden Products for global exclusions. |
When to choose this over Collection
Choose Keyword Search when the product pool is better described by product data than collection membership. Tags, product types, vendors, and title terms are good examples.
Choose Collection when your merchandising team already maintains the product pool in Shopify.
Query examples
Use focused queries such as tag:"accessory", product_type:"Refill", or vendor:"Brand Name".
Preview the products before saving. If the preview includes poor-fit products, tighten the query before the offer goes live.
Troubleshooting
The query returns no products
Check spelling, tag names, product types, and availability filters. The preview table shows what the query currently matches.
The query returns too many products
Add another condition, such as a product type, tag, or title term. You can also use a Shopify collection instead.
The wrong products appear
Use the preview table to identify why they match. Then adjust the query or add those products to Hidden Products if they should never appear.
