The General Settings section under the Settings tab allows you to configure fundamental parameters that affect how promotions behave and are managed across the system. Properly setting these options ensures smooth promotion lifecycle management, accurate application limits, and correct time calculations based on your business needs.
Retention Period
This setting controls how long promotions that you’ve archived will stay saved before they’re permanently deleted.
For example, if set to 1 month, any archived promotion will be automatically deleted after 30 days.
Choose a retention time that’s long enough to let you review or restore promotions if needed, but not so long that old data piles up unnecessarily.
Locking Period
This defines how long a promotion's usage is reserved once it’s applied to a cart, specifically after the cart data is sent to the /cart endpoint.
If the customer doesn’t complete the checkout within this time (meaning no request is sent to the /checkout endpoint), the promotion usage is released, and the count goes back to being available.
For example, if the locking period is 15 minutes, the promotion usage is held for that time after the application. If the checkout is abandoned, the promotion use becomes free again.
This prevents promotion limits from being wasted when customers don’t finish their purchase.
Timezone
This sets the default timezone for all time-based promotion rules when no timezone is specified in the cart request.
For example, selecting Europe/Berlin means all promotion start/end times and schedules will be calculated using Central European Time by default.
Make sure this matches your main business region to avoid timing issues with your promotions.
Don’t forget to click Save before leaving the page to save your changes.