Boost Shopify Product Search Rankings Using Metafields in Search & Discovery

This trigger watches for product updates in real-time and captures the product ID when changes occur. Every time a product gets updated—whether you're changing inventory, descriptions, or metafields—the workflow starts automatically and passes the product ID to the next step. No configuration is needed for the trigger itself.

This step queries Shopify for a specific metafield on the updated product. You need to configure two fields: the metafield namespace and key that contain your custom search terms. For example, you might use namespace "custom" and key "boost_keywords" to store alternative product names or common search phrases. The values from this metafield get passed to the filter step to verify it's not empty.

This filter checks whether the metafield retrieved in the previous step contains a value. If the metafield is empty or doesn't exist, the workflow stops here and doesn't modify the search boost list. If a value exists, the workflow continues to add that term to the boost configuration. The comparison happens automatically using the metafield value from the previous step.

This step queries the Shopify Search & Discovery metafield that stores boosted search queries for the product. It uses the specific namespace "shopify--discovery--product_search_boost" and key "queries" which is Shopify's standard location for search boost configuration. The existing boost values get passed to the next step where they're combined with your new term.

This custom JavaScript step takes the existing boost values from the previous step and adds your new search term to the list. It parses any existing boost values, adds the new value from your custom metafield, then removes duplicates using a Set operation to prevent the same term from appearing multiple times. The combined list of unique search terms gets passed to the final step for updating.

const Mesa = require('vendor/Mesa.js');

/**
 * A Mesa Script exports a class with a script() method.
 */
module.exports = new class {

  /**
   * Mesa Script
   *
   * @param {object} payload The payload data
   * @param {object} context Additional context about this task
   */
  script = (payload, context) => {
    const vars = context.steps;

    let boostValues = JSON.parse(vars.shopify_1.value) ? JSON.parse(vars.shopify_1.value) : [];

    let newValue = vars.shopify_3.value;
    boostValues.push(newValue);

    // Get unique values so there aren't duplicates
    boostValues = [...new Set(boostValues)];

    Mesa.trigger.setTaskExternalData({
      "label": boostValues.join(', ')
    })

    Mesa.output.next(boostValues);
  }
}

This step updates the Shopify Search & Discovery metafield with the complete list of boost terms from the custom code step. It writes to the "shopify--discovery--product_search_boost" namespace and "queries" key, formatting the data as a list of single line text fields. Once updated, Shopify's search algorithm immediately starts considering these boosted terms when ranking products in search results.