How to set up limiting the display time for items in the store

You can set the display period for an items in the store to:

  • maintain the relevance of the catalog at a given time, for example, during holiday sales
  • create an item in advance without displaying it in the catalog
  • motivate users to buy items by displaying a timer next to the item
Note
When you create a catalog interface using Site Builder, the timer is displayed automatically. When you create a catalog in your own interface, you need to implement the timer.

Limiting the display time is available for the following item types:

  • virtual items
  • virtual currency and virtual currency packages
  • bundels
Note
For virtual items, virtual currency packages and bundles, configuration is available through the Publisher Account and using API calls. For virtual currency, configuration is available using API calls only.

To set a time limit for displaying a virtual currency, virtual currency packages and bundles in the store via Publisher Account:

  1. When creating an item in Publisher Account, set the Show in store toggle to On.
  2. Select Time period and specify the time zone, the beginning, and end of the period. To not indicate the end of the item display period, check the No end date box.

To set a time limit for displaying an items in the store via API, use:

Pass following parameters to the item creation or item update API call:

  • periods[0].date_from with the date and time of the beginning of item display period in YYYY-MM-DDThh:mm:ss±TMZ format, where TMZ is the time zone indicator in hh:mm GMT format
  • periods[0].date_until with the date and time of the end of the item display period in YYYY-MM-DDThh:mm:ss±TMZ format, where TMZ is the time zone indicator in hh:mm GMT format. To not indicate the end of an item's display period, pass null

You can set up multiple periods for displaying an item in the store. To do this, pass an array of objects with the start and end dates of all periods in the API calls.

Example:

Copy
Full screen
Small screen

    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]

    Was this article helpful?
    Thank you!
    Is there anything we can improve? Message
    We’re sorry to hear that
    Please explain why this article wasn’t helpful to you. Message
    Thank you for your feedback!
    We’ll review your message and use it to help us improve your experience.
    Rate this page
    Rate this page
    Is there anything we can improve?

    Don’t want to answer

    Thank you for your feedback!
    Last updated: March 28, 2023

    Found a typo or other text error? Select the text and press Ctrl+Enter.

    Report a problem
    We always review our content. Your feedback helps us improve it.
    Provide an email so we can follow up
    Thank you for your feedback!