---
schema_version: "1"
id: 0d8f30b965101bc65b5efa82220622901073519f80c51db93f57d107144e2271
title: Promotions Import and Export in B2C Commerce
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/cc/264-0-0/b2c_promotion_import_export.md
canonical_url: https://help.salesforce.com/s/articleView?id=cc.b2c_promotion_import_export.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 6e530f14a5791272abcca23b815aa8f50a62fb912b1d1481d032f9cf6c1f44cf
description: Use the promotion.xsd to specify an import and export file for both campaigns and promotions.
products:
- Commerce
- B2C Commerce
release: "264"
---
# Promotions Import and Export in B2C Commerce
Use the `promotion.xsd` to specify an import and export file for both campaigns and promotions.
## Top Level Element and Mass Data Import Structure Examples in B2C Commerce
Structure examples for defining campaign and promotion elements at the top level and for mass data support.
The top-level campaign or promotion elements can appear as follows:
```markup
```
For importing mass data, use this structure:
```markup
```
## Promotion Campaigns in B2C Commerce
A campaign is a complex data type within the `promotion.xsd` schema that is primarily used to group promotions.
Campaigns are also associated with customer groups. Specify customer groups as within a promotion import/export file, or separately using the customergroup.xsd. The following example is within the promotion.xsd:
```markup
```
## Promotion Classes in B2C Commerce
All promotion classes (product, order, shipping, and bonus) share certain elements that are defined at the level of the promotion XML element and specified in `promotion.xsd`.
The differences between the main promotion classes (product, order, and shipping) are represented as an optional choice of promotion class specific rule elements.
```markup
```
Import and export excluded product rules with order promotions using the `excluded-products` element.
```markup
...
```
The `qualifying-products` element is supported for shipping and order promotions.
This is a sample of how an order promotions import and export XML appears:
```markup
true
class
10% off orders $500 and up
10% off orders $500 and up.
10% off orders $500 and up.
GiftCerts
500.0
10.0
```
Note The `non-qualifying-products` element is deprecated. It is supported on import but not on export.
## Exporting Individual Promotions
You can import and export individual promotions within B2C Commerce Business Manager.
Within an export, the set of campaigns, promotion campaign assignments, and promotions is limited to the selected values within the specified elements.
1. Click App Launcher , and then select **site** | **Merchant Tools** | **Online Marketing** | **Import & Export**.
2. On the Import & Export page, in the Promotions section, click **Export**.
3. On the Promotion Export - Select Promotion page, search for promotions by ID, name, or class.
4. Select one or more promotions and click **Next >>**.
5. On the Promotion Export - Step 2: Configure Export page, select **Export Search Results** or **Export Selected Only**.
6. Specify the export file name.
7. Click **Finish**. The export file will process on the Import & Export page.
8. Click the resulting export file to view it.
## Importing/Exporting Rank and Exclusive Attributes in B2C Commerce
The promotion attributes _Rank_ and _Exclusive_ are supported in the promotion .xsd.
- The value list of the system attribute _rank_ can be overwritten by the import/export functionality.
- The value list of the system attribute _exclusive_ is _not_ customizable.
The promotion.xsd schema is now extended as follows:
```markup
```
See the Promotion.xsd for further details on the input/output format.
Note Though the PromotionExclusivity setting is mandatory, the xsd element can't be declared as mandatory for technical reasons. Thus, a default value is set for a new promotion in case the element isn't specified. This default value is _no._
The promotion.xsd supports the free discount type.
The complex type BogoProductDiscount includes the discount type.
```markup
```
The complex type TieredShippingDiscount also includes the new discount type.
```markup
```
The element _free_ is an empty XML element.
Example:
```markup
...
2.0
```
## Buy X for Total Product Promotion in B2C Commerce
Add a _Buy X for Total_ product promotion to a campaign.
The _total-discounts_ element represents the _Buy x for total_ promotion type. The _total-discounts_ element is of type _TotalProductDiscount_ within the existing promotion import or export file.
The following is sample XML:
```markup
true
10
no
ShirtsForTotalPrice
Buy 2 shirts for $20 total or 3 shirts for $23 total
Shirts
20.00
3
30.00
5
```
Note If you add a _Buy X for Total_ product promotion to a campaign, add the corresponding elements to your import or export files.
## Customer Group Import and Export for Promotions in B2C Commerce
Customer groups are related to campaigns. Use the `customergroup.xsd` schema with promotions.
The following sample XML contains a campaign (without actual promotions) that has two customer groups.
```markup
A sample campaign.
true
2008-01-17T11:04:24
2008-01-17T11:04:31
```
## Source Code Import and Export for Promotions in B2C Commerce
Use the `sourcecode.xsd` schema to import and export for promotions.
The following XML sample outlines a product promotion that is marked as explicitly triggered by two sample source code groups:
```markup
...
...
```
## Import of Promotion and Campaign Coupon Assignments in B2C Commerce
The `promotion.xsd` schema can define how to specify coupons that are attached to promotions and campaigns.
Specific coupon details are defined in the `coupon.xsd` schema.
Note The UTF-8 format is a variable-length character encoding for Unicode. It's able to represent any character in the Unicode standard. This schema is presented only to illustrate its functions and can change at any time.
```markup
```
This portion is where you specify the coupons that are parts of a campaign.
```markup
. . .
. . .
. . .
```
This portion is where you specify the coupons that are parts of a promotion.
```markup
. . .
. . .
. . .
. . .
```
This portion is where you define coupons names and IDs.
```markup
. . .
```
This portion is where you define `PromotionQualifiers` as a generic type.
```markup
. . .
. . .
```
## Product Promotions Import and Export in B2C Commerce
A product promotion rule adds all required information to target certain products with product-specific discount rules.
### Product Attribute Conditions Import and Export for Promotions in B2C Commerce
The promotion.xsd schema supports product specifications that contain product attribute conditions.
Support occurs through these complex types:
- ProductSpecification.ConditionGroup
- ProductSpecification.ProductAttributeFilter
### Rank and Exclusivity Import and Export for Promotions in B2C Commerce
Import and export functionality also includes _rank_ and _exclusivity_ attributes.
In the following _rank_ and _exclusivity_ example, the PromotionExclusivity setting is mandatory and the xsd element can't be declared as mandatory for technical reasons. B2C Commerce sets a default value of _no._ for a new promotion in case the element isn't specified.
```markup
...
...
```
Note Promotion import format supports only rank values >= 1.
The complex types BogoProductDiscount and TieredShippingDiscount contain the discount types.
```markup
```
Note The free-discount element is an empty element.
### Promotion Product Rule Attribute Conditions in B2C Commerce
When importing your catalog, make sure to consider product attributes.
Although product attributes can be numeric, the product attribute value is only a string. Strings are the lowest common denominator of all supported attribute types. The import logic validates operator and attribute values based on metadata definitions. These definitions are similar to what exist for custom product attributes in catalog imports.
The following are the validation rules:
- The import logic checks attribute IDs, operators, and values using XML schema validation; they must not be empty strings.
- The attribute-id value is used to retrieve the attribute definition from the Product system object type. If no such attribute definition exists, the condition is skipped.
- If the attribute condition type is not supported, the condition is skipped.
- If an attribute condition supports only one value, and multiple values appear in the XML, a warning is logged and the first value is used.
- Only supported operators are allowed (value types). If the system detects an unsupported operator, it skips the attribute condition.
- If one of multiple values is invalid, the entire attribute condition is skipped.
This table illustrates the validation rules.
| Value Type | Value | Multiple 'attribute-value' elements allowed? | Operator |
| --- | --- | --- | --- |
| String | \- | yes | \- |
| Integer | numeric value without decimal places | no | Operator "less than" is mapped to internal operator "less than or equals". Operator "greater than" is mapped to internal operator "greater than or equals". |
| Boolean | value equals to 'true' or 'false' | no | \- |
| Set of String | \- | yes | \- |
| Set of Integer | numeric value without decimal places | no | Operator "less than" is mapped to internal operator "less than or equals". Operator "greater than" is mapped to internal operator "greater than or equals". |
| Enum of String | one of the values of attribute definition | no | \- |
| Enum of Integer | numeric value without decimal places | no | Operator "less than" is mapped to internal operator "less than or equals". Operator "greater than" is mapped to internal operator "greater than or equals". |
This table shows how B2C Commerce evaluates attribute conditions based on their type.
| Value Type | Supported Operators | Multiple Values Supported | Client-side Value Editor | Sample Condition |
| --- | --- | --- | --- | --- |
| String | equals | yes (OR combined) | text field | product attribute "size" equals "10" |
| Integer | greater than or equals, equals, less than or equals | no | text field | product attribute "size" greater than or equals "4" |
| Boolean | equals | no | combo box | product attribute "enabled" is "true" |
| Set of String | equals | yes (OR combined) | text field | product attribute "Image Aspect Ratio" equals "16:9" |
| Set of Integer | greater than or equals, equals, less than or equals | no | text field | product attribute "width" greater than or equals "3" |
| Enum of String | equals | no | combo box | product attribute "weight" equals "27 lbs" |
| Enum of Integer | greater than or equals, equals, less than or equals | no | combo box | product attribute "width" equals "3" |
### Include and Exclude Conditions for Promotions in B2C Commerce
As part of the promotion product rule, import and export any include and exclude conditional qualifiers (including Price Books).
In addition, export conditional qualifiers as part of the shipping cost rule (shipping method import).
## Order Promotions Import/Export in B2C Commerce
Order promotions are simpler than product promotions, their XML schema a subset of the previously-described product promotions schema.
This sample shows a tiered order promotion granting a $10 or $25 discount on the order, provided the merchandise total exceeds $100 or $200, respectively.
```markup
true
Simple OrderPromotion
100
10
200
25
```
This sample shows a simple order bonus promotion that add a free product (SKU1) to the order if the customer purchased something (order total threshold greater than 0).
```markup
true
Bonus OrderPromotion
0
SKU1
```
Use the element `` and the complex type `PromotedPaymentMethods` to create discounts on an order based on payment method. This example promotion gives a 10% discount to any order that uses Paypal as the payment method.
```markup
false
false
no
Use Paypal to receive 10% off your order!
10% for paypal
PayPal
true
0.0
10.0
```
Note It isn't possible to create a payment method discount for the bonus products and choice of bonus products order promotion classes. B2C Commerce calculates this discount when the shopper places the order, before choosing bonus products.
## Shipping Promotions Import/Export in B2C Commerce
The import/export format for shipping promotions is similar to that of order promotions. The major difference is that shipping promotions let you define discounted shipping methods.
This sample XML shows a tiered shipping promotion granting a 50% or 100% discount on selected shipping methods provided the qualifying products total exceeds $50 or $100 respectively.
```markup
true
Tiered ShippingPromotion
ups-ground
ups-air
50
50
100
0
```
The promotion in the above example has a condition-type of "shipment-total". Alternatively, a shipping promotion can specify a condition-type of "product-quantity". Such promotions require that a certain quantity of qualifying products be in the shipment in order for the discount to apply. The XML for this type of promotion includes a `` section before the `.`
In general, a shipping promotion with a condition-type of "product-quantity" requires that a specified number of qualifying products and no excluded products be in the shipment. However, whether or not a shipping promotions permits or prohibits excluded products is configurable. The optional element which accepts values of true or false can be included in the promotion XML to control this behavior. If you omit the element for a newly imported promotion, B2C Commerce prohibits excluded products.
See the schema promotion.xsd for details.
## Promotion Schedule Import/Export in B2C Commerce
All promotion classes support an optional promotion schedule that controls when a promotion is active.
The following is a snippet from the Promotion Schedule section of the promotion.xsd.
```markup
```
This sample XML contains a schedule for the month of January (see start end date) that limits promotions to Monday, Friday, Saturday and Sunday between 9 AM and 7 PM (on those days).
```markup
2008-01-01T13:32:01
2008-01-31T13:33:30
Monday
Friday
Saturday
Sunday
09:00:00
19:00:00
```