---
title: "White Space (WS) engine"
slug: "white-space-ws-engine"
description: "The White Space (WS) engine uses XS engine outputs to match all inactive customers to a profile based on the available customer data."
updated: 2024-02-26T16:05:25Z
published: 2024-02-26T16:05:25Z
canonical: "docs.zilliant.com/white-space-ws-engine"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zilliant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# White Space (WS) engine

The White Space (WS) engine uses [XS engine](/v1/docs/cross-sell-xs-engine) outputs to match all inactive customers to a profile based on the available customer data.

          Before you continue

          

To configure and run the WS engine, first run the XS engine.

## Configuration

The WS engine reuses the same XS Volume Metric, XS Product Group, and Cluster Segment settings defined as part of the XS engine’s [configuration](/v1/docs/cross-sell-xs-engine#configuration). To configure settings specific for the WS engine, go to the Sales IQ Customers worksheet. Depending on your user permissions, the worksheet will resemble the following image.

![SIQ Customers worksheet](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/SIQ%20Customers%20worksheet.png?sv=2026-02-06&spr=https&st=2026-10-31T04%3A18%3A12Z&se=2026-10-31T05%3A18%3A12Z&sr=c&sp=r&sig=a0pJTSb0Pt4yyTMhxyH4z3yoCUcynUUk30ZTw4Fydhk%3D)

The WS engine uses the following **Matching Attribute** and **Matching Value** [calculated columns](/v1/docs/calculated-columns) in this worksheet to determine how to match inactive customers with profiles created from the XS engine. For an effective matching process, make sure any attributes and values referenced by the columns will populate data for both active and inactive customers in this worksheet.

- **Matching Attribute 1, 2, 3, & 4**—Configure these calculated columns with qualitative/string customer attributes for the engine to use in the matching process. The engine does not use attributes left empty.
- **Matching Value 1, 2, 3, & 4**—Configure these calculated columns with quantitative/numeric customer attributes for the engine to use in the matching process. The engine does not use values left empty.

## Outputs

![Outputs - WS](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/Outputs%20-%20WS.png?sv=2026-02-06&spr=https&st=2026-10-31T04%3A18%3A12Z&se=2026-10-31T05%3A18%3A12Z&sr=c&sp=r&sig=a0pJTSb0Pt4yyTMhxyH4z3yoCUcynUUk30ZTw4Fydhk%3D)

To view the results of running the WS engine, go to the WS Engine Output worksheet. Depending on your user permissions, the worksheet will resemble the following image.

![WS Engine Output worksheet](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/WS%20Engine%20Output%20worksheet.png?sv=2026-02-06&spr=https&st=2026-10-31T04%3A18%3A12Z&se=2026-10-31T05%3A18%3A12Z&sr=c&sp=r&sig=a0pJTSb0Pt4yyTMhxyH4z3yoCUcynUUk30ZTw4Fydhk%3D)

This engine generates results for every inactive Customer Id + active Product Group combination. This worksheet contains the following metric fields:

- **Cluster Median Ratio**—Median volume share for the corresponding XS product group across all core customers in the corresponding profile.
- **Customer Ratio**—Volume share for the corresponding product group against the corresponding customer’s Total Cluster Period Volume.
- **Ratio Gap**—Ratio of the difference between the Customer Ratio and the Cluster Median Ratio, to the Cluster Median Ratio. Negative values identify a Customer Id + XS Product Group combination where the Customer Ratio exceeds the Cluster Median Ratio.

          For example,

          

If the **Cluster Median Ratio** is *0.25*, and the **Customer Ratio** is *0.05*, then the engine defines the **Ratio Gap** as (*0.25* - *0.05*) / *0.25* = *0.80*.

- **Customer Potential**—Total volume potential of the customer. For more information, read [Customer metrics](/v1/docs/customer-metrics).
- **Action Impact**—Annualized impact of getting volume back to the Baseline Avg. This is a [calculated column](/v1/docs/calculated-columns) defined as the difference between the Cluster Median Ratio and the Customer Ratio, multiplied by the Customer Potential. Modify this column as needed to create the desired Action Impact metric.
- **Current**—The Customer Ratio. Modify this calculated column as needed to capture the best measure of the “Current” state for any [actions](/v1/docs/about-campaigns#actions) created.
- **Target**—The Cluster Median Ratio. Modify this calculated column as needed to capture the best measure of the “Target” state for any actions created.

To navigate, go to **Sales IQ** > **Engine Config** > **Sales IQ Customers**.

To navigate, go to **Sales IQ** > **Outputs** > **WS Engine Output**.