---
title: "discount_application"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/sline/object/discount-application'
  md: 'https://developer.shopline.com/docs/sline/object/discount-application.md'
---

# discount_application


    Information about a specific discount.

    For how to present discounts in the store theme, refer to [Discounts](https://developer.shopline.com/docs/online-store-3-0-themes/theme-features/pricing-and-payment/discounts.md).




## Properties

    <div>
    

        
<ObjectProperty 
    name="target_selection"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The scope of the line items or shipping lines to which the discount applies.


> **TIP**
>
> Whether the scope corresponds to line items or shipping lines depends on the `target_type` property of the discount.

| Valid value | Description |
|-------|-------|
| all | All line items or shipping lines.  |
| entitled | The line items or shipping lines that meet the specified criteria. |
| explicit | Explicitly selected line items.  |
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="target_type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The type of line to which the discount applies.

| Valid value | Description |
|-------|-------|
| line_item |  A line item |
| shipping_line | A shipping line |
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="title"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The name of the discount for display.


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="total_allocated_amount"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
The total discount amount.

> **TIP**
>
> Format the amount using the [money](https://developer.shopline.com/docs/sline/filter/money.md), [money_with_currency](https://developer.shopline.com/docs/sline/filter/money-with-currency.md), or [money_without_currency](https://developer.shopline.com/docs/sline/filter/money-without-currency.md) filter.
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="value"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The discount value.

The meaning of this value depends on the `value_type` field of the discount. 



> **TIP**
>
> Format the amount using the [money](https://developer.shopline.com/docs/sline/filter/money.md), [money_with_currency](https://developer.shopline.com/docs/sline/filter/money-with-currency.md) or [money_without_currency](https://developer.shopline.com/docs/sline/filter/money-without-currency.md) filter.
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="value_type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
The type of discount value.

| Value type | Meaning |
|-------|-------|
| fixed_amount | An amount |
| percentage | A percentage |
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="activity_type"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
The type of activity associated with the discount. Valid values are:

- `0`: Spending and Save, Free Shipping
- `1`: Flash Sale
- `2`: Bundling
- `3`: Coupon
- `4`: Landing Page Store
- `5`: Gift with Purchase
- `6`: Pre-order
- `7`: Add-ons
- `8`: Gift Sets
- `9`: Post-purchase Upsell
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty 
    name="benefit_type"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
The type of discount benefit. Valid values are:

- `-1`: None
- `1`: Flat Discount
- `2`: % Discount
- `3`: Free Shipping
- `4`: Upsell
- `5`: Any N for Fixed Price
- `6`: Set Price
- `7`: Gift with Purchase
- `8`: Flat Price
- `9`: Cheapest One Free
- `11`: Nth Item at % Off
- `12`: Buy X, Get Y Free
- `13`: Manual or Advanced Discount
- `14`: Multi-buy Offer
</ObjectSummary>
</ObjectProperty>
        
    
    </div>