---
schema_version: "1"
id: c6d9177df72e990f7d37b056bde46b56a587c73af2ae904e998094f1dce5e93e
title: Create a Synonym Rule for B2B Store
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/comm_search_create_synonym_rules.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.comm_search_create_synonym_rules.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 8395919aabeea28fd28653c2e1f3410fadaabe7504f02a50d35ea67759d5a8ef
description: Define one-way or two-way relationships to map buyer search words to your catalog data. Connect alternate phrasing, informal words, or regional terms to your exact product names to make sure that buyers find relevant products even when they use search terms that don’t exactly match your catalog.
products:
  - Commerce
  - B2B Commerce
release: "264"
---
# Create a Synonym Rule for B2B Store

Define one-way or two-way relationships to map buyer search words to your catalog data. Connect alternate phrasing, informal words, or regional terms to your exact product names to make sure that buyers find relevant products even when they use search terms that don’t exactly match your catalog.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=commerce.comm_editions.htm&amp;language=en_US" target="_blank">View supported editions</a>.</td></tr></tbody></table>

[Which Salesforce Commerce Product Do I Have?](https://help.salesforce.com/s/articleView?id=commerce.comm_what_product.htm&language=en_US)

1. In the navigation sidebar, select a store from the **Store** dropdown.
2. Select **Merchandising** | **Synonym Rules**.
3. Click **New Rule**.
4. Select a rule type: One-Way or Two-Way.
    - One-Way (A → B): Query A retrieves products matching term B, but query B doesn't retrieve products for term A. Use one-way rules when buyers are likely to use informal or alternative terms to search for formal product names. For example, with a one-way, "phone charger" → "lightning cable," searching for "phone charger" returns products labeled "lightning cable," but searching for "lightning cable" returns only products with that exact term.
    - Two-Way (A ←→ B): All terms are treated as equals. Query A retrieves products for B, and query B retrieves products for A. Use two-way rules when terms are true synonyms. For example, with a two-way rule "couch" ←→ "sofa," searching for either term returns products labeled with both terms.
5. Select the locales for this rule.
    
    You can set the rule for a specific locale such as en-US, or for all locales.
6. Enter the search term that buyers use.
    
    For one-way rules, the search term is the query term (A). For two-way rules, the search term is one of the equivalent terms.
7. Enter the matching term or terms from your catalog.
    
    For one-way rules, enter the matching term in your catalog as the target term (B). For two-way rules, enter all equivalent terms separated by commas.
8. Click **Save**.
    
    If the rule conflicts with an existing rule, a warning appears. Common conflicts include phrase overlaps, redefining a term that exists in a two-way rule, or duplicates.
9. Update the search index so that changes appear in your store. See [Update the Commerce Search Index](https://help.salesforce.com/s/articleView?id=commerce.comm_search_index_build.htm&type=5&language=en_US).

#### See Also

- [Synonym Rules for B2B Stores](https://help.salesforce.com/s/articleView?id=commerce.comm_search_synonym_rules_for_b2b_stores.htm&release=264.0.0&type=5 "Synonym rules define relationships between different search terms that buyers use to describe the same product. Buyers often search using everyday language rather than your exact catalog terms. By mapping alternate words to your catalog terminology, synonym rules ensure searches return relevant results and make products easier to discover. Configure one-way rules for targeted mappings or two-way rules for fully interchangeable terms. For example, a one-way rule allows a search for “sofa” to return products named “couch”, while a two-way rule ensures searches for either term return results for both.")
- [Edit or Delete a Synonym Rule in B2B Store](https://help.salesforce.com/s/articleView?id=commerce.comm_search_edit_delete_synonym_rules.htm&release=264.0.0&type=5 "Modify existing synonym rules or remove rules that no longer apply to your current catalog.")
- [Activate or Deactivate a Synonym Rule in B2B Store](https://help.salesforce.com/s/articleView?id=commerce.comm_search_activate_synonym_rules.htm&release=264.0.0&type=5 "Turn synonym rules on or off temporarily to adjust the search behavior without deleting them.")