> Documentation index: [Saleor](/llms.txt) · [This section](/api-reference/discounts/llms.txt)
> Source: https://docs.saleor.io/api-reference/discounts/objects/promotion-rule

# PromotionRule Object

Represents the promotion rule that specifies the conditions that must be met to apply the promotion discount.

```graphql
type PromotionRule implements Node {
  id: ID!
  name: String
  description: JSON
  promotion: Promotion
  channels: [Channel!]
  rewardValue: PositiveDecimal
  rewardValueType: RewardValueTypeEnum
  predicateType: PromotionTypeEnum
  cataloguePredicate: JSON
  orderPredicate: JSON
  rewardType: RewardTypeEnum
  translation(languageCode: LanguageCodeEnum!): PromotionRuleTranslation
  giftIds: [ID!]
  giftsLimit: Int
}
```

<a id="fields"></a>

### Fields

<a id="id"></a>

#### [`id`](#id) ● [`ID!`](/api-reference/miscellaneous/scalars/id.md)

<a id="name"></a>

#### [`name`](#name) ● [`String`](/api-reference/miscellaneous/scalars/string.md)

Name of the promotion rule.

<a id="description"></a>

#### [`description`](#description) ● [`JSON`](/api-reference/miscellaneous/scalars/json.md)

Description of the promotion rule.

<a id="promotion"></a>

#### [`promotion`](#promotion) ● [`Promotion`](/api-reference/discounts/objects/promotion.md)

Promotion to which the rule belongs.

<a id="channels"></a>

#### [`channels`](#channels) ● [`[Channel!]`](/api-reference/channels/objects/channel.md)

List of channels where the rule applies.

Requires one of the following permissions: AUTHENTICATED\_APP AUTHENTICATED\_STAFF\_USER

<a id="reward-value"></a>

#### [`rewardValue`](#reward-value) ● [`PositiveDecimal`](/api-reference/miscellaneous/scalars/positive-decimal.md)

The reward value of the promotion rule. Defines the discount value applied when the rule conditions are met.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="reward-value-type"></a>

#### [`rewardValueType`](#reward-value-type) ● [`RewardValueTypeEnum`](/api-reference/discounts/enums/reward-value-type-enum.md)

The type of reward value of the promotion rule.

<a id="predicate-type"></a>

#### [`predicateType`](#predicate-type) ● [`PromotionTypeEnum`](/api-reference/discounts/enums/promotion-type-enum.md)

The type of the predicate that must be met to apply the reward.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="catalogue-predicate"></a>

#### [`cataloguePredicate`](#catalogue-predicate) ● [`JSON`](/api-reference/miscellaneous/scalars/json.md)

The catalogue predicate that must be met to apply the rule reward.

<a id="order-predicate"></a>

#### [`orderPredicate`](#order-predicate) ● [`JSON`](/api-reference/miscellaneous/scalars/json.md)

The checkout/order predicate that must be met to apply the rule reward.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="reward-type"></a>

#### [`rewardType`](#reward-type) ● [`RewardTypeEnum`](/api-reference/discounts/enums/reward-type-enum.md)

The reward type of the promotion rule.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="translation"></a>

#### [`translation`](#translation) ● [`PromotionRuleTranslation`](/api-reference/discounts/objects/promotion-rule-translation.md)

Returns translated promotion rule fields for the given language code.

<a id="promotion-rule-translation-language-code"></a>

##### [`languageCode`](#promotion-rule-translation-language-code) ● [`LanguageCodeEnum!`](/api-reference/miscellaneous/enums/language-code-enum.md)

A language code to return the translation for promotion rule.

<a id="gift-ids"></a>

#### [`giftIds`](#gift-ids) ● [`[ID!]`](/api-reference/miscellaneous/scalars/id.md)

Product variant IDs available as a gift to choose.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="gifts-limit"></a>

#### [`giftsLimit`](#gifts-limit) ● [`Int`](/api-reference/miscellaneous/scalars/int.md)

Defines the maximum number of gifts to choose from the gifts list.

Added in Saleor 3.19

This API is currently in **Feature Preview** and can be subject to changes at later point.

<a id="interfaces"></a>

### Interfaces

<a id="node"></a>

#### [`Node`](/api-reference/miscellaneous/interfaces/node.md)

An object with an ID

<a id="member-of"></a>

### Member Of

[`Promotion`](/api-reference/discounts/objects/promotion.md) object  ● [`PromotionRuleCreate`](/api-reference/discounts/objects/promotion-rule-create.md) object  ● [`PromotionRuleCreated`](/api-reference/discounts/objects/promotion-rule-created.md) object  ● [`PromotionRuleDelete`](/api-reference/discounts/objects/promotion-rule-delete.md) object  ● [`PromotionRuleDeleted`](/api-reference/discounts/objects/promotion-rule-deleted.md) object  ● [`PromotionRuleTranslate`](/api-reference/discounts/objects/promotion-rule-translate.md) object  ● [`PromotionRuleUpdate`](/api-reference/discounts/objects/promotion-rule-update.md) object  ● [`PromotionRuleUpdated`](/api-reference/discounts/objects/promotion-rule-updated.md) object