---
schema_version: "1"
id: eb631f51d28fdcda3d65db5acd19c4f0fb8e3e1e0f653473fe720290d7b82b2c
title: PromotionTarget
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_promotiontarget.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_promotiontarget.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: d310cf161158f17680a9c9bbacbef5ef0d28344637ef45a41d06dea87cadbdae
description: 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.
---
# PromotionTarget

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.

## Supported Calls

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

## Special Access Rules

The PromotionTarget 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="d1622832e111">Field</th>

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

            </tr>

          </thead>

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

              <td class="entry" headers="d1622832e114" 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 promotion discount is expressed as an amount, not as
                    a percentage.</dd>


                </dl>

              </td>

            </tr>

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

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

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

                  <dd class="dd">percent</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 percentage discount of the promotion. Valid values
                    include numbers from 1 through 100.</dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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 adjustment discount applied to the product
                    or group of products.</dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li">
                        <samp class="codeph nolang">FixedAmountOffLineItemTotal</samp>—Fixed
                        amount off the total of all line items.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">FixedAmountOffTransaction</samp>—Fixed
                        amount off the entire transaction. This value is
                        available in API version 56.0 and later.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">FixedAmountOffUnitPrice</samp>—Fixed
                        amount off the unit price.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">FixedPrice</samp>—Fixed price for a product.
                        This value is available in API version 56.0 and
                        later.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">TotalFixedPrice</samp>—Fixed price for a
                        set number of products. Requires a quantity limit.
                        This value is available in API version 56.0 and
                        later.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">FixedAmountOffUnitPrice</samp>—Fixed
                        amount off the unit price.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">PercentageDiscount</samp>—Percentage
                        discount.
                      </li>

                      <li class="li">
                        <span class="keyword parmname">BonusProduct</span>—Gift
                        product at no additional cost after qualifying
                        purchases. This value is available in API version
                        64.0 and later.
                      </li>

                    </ul>

                  </dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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="d1622832e111" data-title="Field"><span class="keyword parmname">ExternalTarget</span></td>

              <td class="entry" headers="d1622832e114" 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 target 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="d1622832e111" data-title="Field"><span class="keyword parmname">IsMinItemCountRequired</span></td>

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

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

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



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

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



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

                  <dd class="dd">If <samp class="codeph nolang">true</samp>, the max
                    value in the <span class="keyword parmname">RestrictionQuantity</span>
                    field must be met before the promotion is applied. The
                    default value is <samp class="codeph nolang">false</samp>. This field is available in API
                    version 56.0 and later. </dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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="d1622832e111" data-title="Field"><span class="keyword parmname">LastViewedDate</span></td>

              <td class="entry" headers="d1622832e114" 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="d1622832e111" data-title="Field"><span class="keyword parmname">Name</span></td>

              <td class="entry" headers="d1622832e114" 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">The name of the promotion target.</dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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 reference.</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="d1622832e111" data-title="Field"><span class="keyword parmname">PromotionTierId</span></td>

              <td class="entry" headers="d1622832e114" 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 target.
                    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="d1622832e111" data-title="Field"><span class="keyword parmname">RestrictionQuantity</span></td>

              <td class="entry" headers="d1622832e114" 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">Maximum number of times the discount can be applied to
                    the target. This field is available in API version 56.0
                    and later. </dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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 product or product category that you want
                    to target.</dd>

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



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

                  <dd class="dd">Target</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="d1622832e111" data-title="Field"><span class="keyword parmname">TargetOperator</span></td>

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

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

                  <dd class="dd">enum</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">For product and category targets, specify if the
                    qualifying product or item in the qualifying category
                    must be in the cart to determine if the cart satisfies
                    the promotions criteria. For example, a quantity or
                    amount across one or more items. This field is available
                    in API version 59.0 and later.</dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li">
                        <samp class="codeph nolang">EQUAL_TO</samp>—Specifies that the
                        qualifying product or item in the qualifying
                        category must be in the cart.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">NOT_EQUAL_TO</samp>—Specifies that the
                        qualifying product or item in the qualifying
                        category isn’t required to be in the cart.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">NONE</samp>—Specifies that none of the
                        other possible values apply. If the target type is
                        for an order, you must use none.
                      </li>

                    </ul>
                  </dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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
                    target. This field is available in API version 55.0 and
                    later.</dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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 target. This
                    field is available in API version 55.0 and later.</dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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
                    target. This field is available in API version 55.0 and
                    later.</dd>


                </dl>

              </td>

            </tr>

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

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

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

                  <dd class="dd">enum</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">Controls what promotion rules must be met for the
                    promotion to be valid. This field is available in API
                    version 59.0 and later.</dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li">
                        <samp class="codeph nolang">ALL</samp>—Specifies that all of the
                        promotion rules must be met.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">ANY</samp>—Specifies that any of the
                        promotion rules can be met.
                      </li>

                    </ul>
                  </dd>


                </dl>

              </td>

            </tr>

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

              <td class="entry" headers="d1622832e114" 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 target of the promotion.</dd>

                  <dd class="dd">Possible values are: <ul class="ul bulletList">
                      <li class="li">
                        <samp class="codeph nolang">Product</samp>—Applies the promotion to
                        a single product.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">ProductCategory</samp>—Applies the
                        promotion to a group of products.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">Shipping</samp>—Applies the promotion to
                        all shipping methods on the order.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">StandardShippingRate</samp>—Applies the
                        promotion to a single shipping method on the
                        order.
                      </li>

                      <li class="li">
                        <samp class="codeph nolang">Transaction</samp>—Applies the promotion
                        to the entire order.
                      </li>

                    </ul>

                  </dd>


                </dl>

              </td>

            </tr>

          </tbody>

        </table>

#### 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.")