Skip to content
CMS Max Documentation

How Product Search Works

Understand how customers search your store and how results are ranked so you can optimize your product listings

Overview

CMS Max uses a full-text search system that delivers fast, relevant results across your entire product catalog. Search results are ranked by relevance — not just whether a word appears, but where it appears and how closely it matches — so customers find what they're looking for quickly.

Product search results on the storefront

What Gets Searched

When a customer searches your store, the system looks across all of these product fields:

Highest relevance — matches here push products to the top of results:

  • Product title
  • SKU
  • GTIN / barcode

Strong supporting signal — these fields contribute meaningfully to relevance:

  • Brand name
  • Category name
  • Meta description

Broad content matching — these fields are searched but carry less weight:

  • Tags
  • Product description
  • Page content
  • Variant options

How Results Are Ranked

The system ranks results using several signals, applied in order:

  1. Exact title match — Products whose title exactly matches the search term appear first.
  2. Brand and category match — Searching for a brand name returns all products from that brand, ranked by relevance.
  3. Supporting metadata and content — Tags, variant values, descriptions, and page content provide broader matching signals.
  4. Recency as a tiebreaker — When relevance scores are equal, newer products appear first.

Misspelled Searches

When a search finds nothing, CMS Max looks for close spellings of each word among the words that name your products, such as titles, brands, categories, and meta descriptions, and searches again. A close spelling is usually one letter off (missing, extra, wrong, or two letters swapped), or two letters off in longer words. Four-letter words are corrected more cautiously, since changing one of their letters often makes a different word. A customer who types smirnof, smirnov, smirnof vodak, or smirnof 1.75L still finds your Smirnoff vodka, reisling finds your Riesling, and guiness finds your Guinness. A partly typed word first matches only the words it starts: chard shows your Chardonnays, not Hard Seltzer. Every word except single letters still has to match, as typed, as the start of a longer word, or as a close spelling (only the first eight words of a long search are used), so a search for a brand you don't carry, such as sailor jerry, doesn't list products that only match its other words. A word you don't carry at all can still show a product whose name is close to it, such as brown showing Crown Royal. Words that only appear in tags, variant options, or product descriptions are not used as corrections. Searches that already have results are never changed. When site-wide search filters leave a search with no results, it may show close matches instead. Searches that exclude words with - or put a phrase in quotes are never corrected.

New product names start working as spelling corrections once the store's word list is refreshed. A misspelled search refreshes it in the background, at most every six hours, so on a store with few misspelled searches it can take longer. Correctly spelled searches find new products immediately. The name of a hidden product, including a sold-out product when your store hides them, is not corrected to a different product's name, once the word list has been refreshed since the product was added.

Partial Product Codes

When a search finds no results, customers can find a product by the beginning of a model code or SKU made only of letters and digits. The partial code must start with a letter, contain at least one digit, and be at least three characters long. For example, TC5003B, tc5003, and TC5 can find a product with code TC5003BN in its SKU or other searchable product details. For a code containing a hyphen, such as SKU-10042, type the whole code.

If the original search already finds a product, those results are kept without adding longer codes. Partial matching starts at the beginning of a code, so 5003B does not find TC5003BN. Wrong digits are not corrected. Numeric barcodes and sizes must match exactly, and searches with exclusions or quoted phrases do not use this fallback.

Site-Wide Search Customers searching from the main search bar get results across your entire site — including products, pages, blog posts, events, locations, and job openings. This is ideal for customers who aren't sure whether what they're looking for is a product or a page.

Product Catalog Search (the Shop page) Customers browsing your shop can search within the product catalog specifically, with additional filtering options for price range, brands, categories, descriptive product tags, and purchasable variant values such as Color and Size. This is optimized for product discovery and comparison.

These filters only show values used by products in the complete matching search result. This includes products on later result pages, so moving between pages does not unexpectedly change the available filters.

Price limits include the amount entered. For products with variations, search uses the lowest positive price among enabled variations, including eligible active product-specific, store-wide, category, and brand sales and member discounts. Disabled and unpriced options do not make a higher-priced product fit below your maximum. For example, a product starting at $34.95 is excluded when Max is $10. Price sorting and category/brand catalog filters use the same starting price. Max 0 is an active filter and can be removed with Clear All Filters, including when no products match.

Product Title Display

In the Product Search widget, choose Product titles > Full title to wrap product names inside grid cards. Two lines is the default. The choice stays active when shoppers search, filter, sort or change pages. List layouts show full names and do not offer this choice. Saving a List layout clears the card title choice. Editing a widget without a display choice uses Grid. Widgets configured as Carousel retain that layout when edited; new search widgets offer Grid and List.

Full Search has its own Layout > Product titles choice for product cards. Mixed content results show full headings independently of this setting. Each search widget has its own choice; Product List shared settings do not configure search widgets. Customized card templates or stylesheets must support the full-title modifier.

Advanced Search Techniques

Customers can use these techniques for more precise searches:

Syntax What It Does Example
Quoted phrase Finds exact phrase in that order "blue dream"
Minus sign Excludes a term from results gummies -thc
Multiple words Searches across all fields wyld strawberry
SKU lookup Finds a product by its exact SKU SKU-10042
Partial model code Finds codes beginning with the typed letters and digits when the original search finds nothing TC5003B finds TC5003BN

Because the system ranks results by where terms appear, the quality of your product data directly affects how easy products are to find:

  • Product titles carry the most weight — use clear, descriptive names that customers would actually search for.
  • SKUs are searched with highest priority — make sure they are entered accurately.
  • GTINs are also top-priority — add barcodes where available.
  • Tags support broader matching — use them for attributes customers search by (e.g., material, dietary preference, style).
  • Brand and category assignments matter — ensure every product is correctly categorized and assigned to the right brand.
  • Product descriptions help with longer-tail searches — write descriptions that include natural language customers might use.