> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Promotions V3

# Type: Promotion Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/promotions-v3/promotion-object.md

## Description: A promotion is a visual banner displayed on store category pages, including their product gallery sections.
Use promotions to highlight sales, seasonal offers, or featured content and link customers to relevant pages.

## Schema:

```json
 Type: Promotion Object | type: Promotion
 Description: A promotion is a visual banner displayed on store category pages, including their product gallery sections.
Use promotions to highlight sales, seasonal offers, or featured content and link customers to relevant pages.
       - name: id  | type: string | description: Promotion ID.
           - name: value  | type: string | description: 
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the promotion is updated. To prevent conflicting changes, the current revision must be passed when updating the promotion.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the promotion was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the promotion was last updated.
       - name: name  | type: string | description: Promotion name.
       - name: media  | type: PromotionMedia | description: Promotion media.
           - name: altText  | type: string | description: Image alt text.
           - name: displayName  | type: string | description: Media display name.  Overrides the default media name. Can be passed only when the media is set by a URL in this item's `url` field.
           - name: mediaType  | type: string | description: Media type.
               enum: IMAGE
           - name: uploadId  | type: string | description: ID of the asynchronous media import that Wix Media Manager runs when media is set with a `url`.
       - name: destinationUrl  | type: string | description: URL the promotion redirects to when a customer clicks the banner.
       - name: categories  | type: Array<CategoryAssignment> | description: Categories the promotion is directly assigned to. A promotion may also appear in subcategories when `appliedToSubcategories` is `true` for a directly assigned category.
           - name: id  | type: string | description: Category ID.
           - name: position  | type: number | description: Position of the promotion within the category, starting from 1.  Must be provided for each category assignment — omitting it fails validation, because positions start from 1.
           - name: appliedToSubcategories  | type: boolean | description: Whether the promotion also appears in this category's subcategories. When inherited by a subcategory, the promotion keeps the same position.  Default: `false`
       - name: enabled  | type: boolean | description: Whether the promotion is enabled.  When creating or updating with `media.url`, this value takes effect only after the media import completes successfully. See `media.url` for details.  Default: `false`
       - name: extendedFields  | type: ExtendedFields | description: Custom field data for the promotion object.  [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md) must be configured in the app dashboard before they can be accessed with API calls.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
       - name: tags  | type: Tags | description: Tags for organizing and filtering promotions.
           - name: privateTags  | type: TagList | description: Tags that require an additional permission in order to access them, normally not given to site members or visitors.
               - name: tagIds  | type: Array<string> | description: List of tag IDs.
           - name: publicTags  | type: TagList | description: Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.

```