---
schema_version: "1"
id: 22e23ad3d620e845bd9365482c6a67ebf3f212f4bc6c7b31935e62154068364b
title: PromotionQualifier
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_promotionqualifier.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionqualifier.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 50957f5f0fdf8f96d26ee22816d6c7ea3c3de5a21b372a126a2dc79ae7173875
description: Represents the product, product category, or order that you want to target with your promotion qualifier in a B2B or D2C store. This object is available in API version 52.0 and later.
---
# PromotionQualifier

Represents the product, product category, or order that you want to target with your promotion qualifier in a B2B or D2C store. This object is available in API version 52.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update(), upsert()

## Special Access Rules

The PromotionQualifier object is available only if the B2B Commerce or D2C Commerce license is enabled.

## Fields

<table class="featureTable sort_table" summary="">


          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d1618478e111">Field</th>

              <th class="featureTableHeader  " id="d1618478e114">Details</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">ApproachingDiscountThreshold</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">currency</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The amount that a customer has to reach before seeing an
                    approaching discount message.</dd>

                  <dd class="dd">For example, if a promotion qualifier minimum is set at $150 and
                    this field is set at $50, then a customer receives a banner
                    notification that they're approaching the discount when they have
                    at least $50 in their cart. This field is available in API version
                    64.0 and later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">CurrencyIsoCode</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Defaulted on create, Filter, Group, Nillable, Restricted
                    picklist, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Available only for orgs with the multicurrency feature enabled.
                    Contains the ISO code for any currency allowed by the
                    organization.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">ExternalQualifier</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">A qualifying product or product category stored outside of
                    Salesforce. This field is available in API version 56.0 and later.
                  </dd>


                </dl>

                <div class="box message info">
                  <div class="inner">
                    <div class="bd">
                      <div class="media">
                        <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png" alt="Note">
                        <div class="mediaBd">
                          <h4 class="mbs">Note</h4>
                          <p>This field is available through the API only.</p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">LastReferencedDate</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">dateTime</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The timestamp for when the current user last viewed a record
                    related to this record.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">LastViewedDate</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">dateTime</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The timestamp for when the current user last viewed this record.
                    If this value is null, it’s possible that this record was
                    referenced (<span class="keyword parmname">LastReferencedDate</span>) and not
                    viewed.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">MinimumAmount</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">currency</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The minimum dollar amount that a buyer must purchase to qualify
                    for the promotion.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">MinimumQuantity</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">double</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The minimum quantity that a buyer must purchase to qualify for the
                    promotion.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">Name</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Autonumber, Defaulted on create, Filter, idLookup, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Name of the promotion qualifier.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">PromotionId</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The ID of the promotion that you want to associate with your
                    promotion qualifier.</dd>

                  <dd class="dd">This is a relationship field.</dd>



                  <dt class="dt dlterm">Relationship Name</dt>

                  <dd class="dd">Promotion</dd>



                  <dt class="dt dlterm">Relationship Type</dt>

                  <dd class="dd">Lookup</dd>



                  <dt class="dt dlterm">Refers To</dt>

                  <dd class="dd">Promotion</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">PromotionTierId</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The ID of the promotion tier associated with the qualifier. Only
                    used with tiered promotions.</dd>

                  <dd class="dd">This is a relationship field.</dd>

                  <dd class="dd">This field is available in API version 57.0 and later.</dd>



                  <dt class="dt dlterm">Relationship Name</dt>

                  <dd class="dd">PromotionTier</dd>



                  <dt class="dt dlterm">Relationship Type</dt>

                  <dd class="dd">Lookup</dd>



                  <dt class="dt dlterm">Refers To</dt>

                  <dd class="dd">PromotionTier</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierId</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Nillable, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The ID of the qualifier.</dd>

                  <dd class="dd">This is a polymorphic relationship field.</dd>



                  <dt class="dt dlterm">Relationship Name</dt>

                  <dd class="dd">Qualifier</dd>



                  <dt class="dt dlterm">Relationship Type</dt>

                  <dd class="dd">Lookup</dd>



                  <dt class="dt dlterm">Refers To</dt>

                  <dd class="dd">Product2, ProductCategory</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierOperator</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Restricted picklist, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd"></dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">EQUAL_TO</samp></li>

                      <li class="li"><samp class="codeph nolang">NONE</samp></li>

                      <li class="li"><samp class="codeph nolang">NOT_EQUAL_TO</samp></li>

                    </ul>
                  </dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierProductCategoryName</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Group, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The name of the product category referenced in the qualifier. This
                    field is available in API version 55.0 and later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierProductName</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Group, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The name of the product referenced in the qualifier. This field is
                    available in API version 55.0 and later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierProductSku</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Group, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The stock keeping unit of the product referenced in the qualifier.
                    This field is available in API version 55.0 and later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierRuleCriteriaType</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Restricted picklist, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The type of qualifier rule criteria.</dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">All</samp></li>

                      <li class="li"><samp class="codeph nolang">Any</samp></li>

                    </ul>

                  </dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1618478e111" data-title="Field"><span class="keyword parmname">QualifierType</span></td>

              <td class="entry" headers="d1618478e114" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Group, Restricted picklist, Sort, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The type of qualifier that you want to add to the promotion.
                    <samp class="codeph nolang">Product</samp> applies the
                    qualifier to a single product, <samp class="codeph nolang">ProductCategory</samp> to a predetermined group of products,
                    and <samp class="codeph nolang">TransactionTotal</samp> to the
                    entire order.
                  </dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li"><samp class="codeph nolang">Product</samp></li>

                      <li class="li"><samp class="codeph nolang">ProductCategory</samp></li>

                      <li class="li"><samp class="codeph nolang">TransactionTotal</samp></li>

                    </ul>
                  </dd>


                </dl>

              </td>

            </tr>

          </tbody>

        </table>

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[PromotionQualifierFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.")

Feed tracking is available for the object.

[PromotionQualifierHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.")

History is available for tracked fields of the object.

#### See Also

- [Promotion](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotion.htm "Represents a promotion for B2B or D2C stores. This object is available in API version 52.0 and later.")
- [PromotionMarketSegment](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionmarketsegment.htm "Represents a market segment within B2B Commerce that promotions can be assigned to. This object is available in API version 52.0 and later.")
- [PromotionQualifier](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionqualifier.htm "Represents the product, product category, or order that you want to target with your promotion qualifier in a B2B or D2C store. This object is available in API version 52.0 and later.")
- [PromotionSegment](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionsegment.htm "Represents a promotion segment, which you can assign to different stores or buyer groups, allowing them to access the promotion. This object is available in API version 52.0 and later.")
- [PromotionSegmentBuyerGroup](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionsegmentbuyergroup.htm "Represents a promotion segment, associated with a buyer group, and used for B2B Commerce. This object is available in API version 52.0 and later.")
- [PromotionSegmentSalesStore](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotionsegmentsalesstore.htm "Represents a promotion segment, associated with a store, and used for B2B Commerce. This object is available in API version 52.0 and later.")
- [PromotionTarget](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotiontarget.htm "Represents the product, product category, or order that you want to target with your promotion in a B2B Store or D2C store. This object is available in API version 52.0 and later.")
- [PromotionTier](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotiontier.htm "Represents a tier of a promotion that includes multiple tiers. A promotion can have up to 10 tiers. This object is available in API version 57.0 and later.")