Schedule product launch windows
This Product hard launch use case manages products with limited availability windows. Perfect for seasonal products, flash sales, limited editions, or promotional items that should automatically appear and disappear without manual oversight.
How it works
Specify both start and end dates for product availability using publish_date and expiry_date custom attributes. The system shows products during their availability window and hides them when the period expires.
Note that this is an API driven use case that requires changes in your API calls. No dashboard changes are needed.
Prerequisites
Ensure that you have access to the Catalogs & events admin permission.
Implementation steps
Step 1: Configure attributes for availability range
Configure the two custom attributes publish_date and expiry_date for availability windows or a custom timestamp range as follows:
Field configuration | Description | Example |
Configure the field as follows in the Catalogs application.
|
The date and time when a product should launch on your site.
Accepted formats: YYYYMMDDHHMM, YYYYMMDD, or Unix timestamp For multisites: Provide the attribute in the time zone you will use in your API calls. |
Launch from 12 PM on September 12, 2025:
UNIX: 1757678400 YYYYMMDDHHMM: 202509121200 |
Avoid using reserved attributes like launch_date and start_date. Custom attributes are better suited for this use case and allow greater flexibility.
Step 2: Send attributes in your feed
Send both publish_date and expiry_date attributes for time-bound products. Products will only appear during their specified availability window.
Note
This use case depends on your feed update frequency and is tightly coupled with feed processing timelines. Products will only become visible after your next feed processing cycle.
Step 3: Filter API calls for date ranges
Use both filter parameters in your API calls to show only products within their availability window:
&fq=publish_date:[* TO CurrentTimeCode]
&fq=expiry_date:[CurrentTimeCode TO *]
Replace CurrentTimeCode with the appropriate timestamp, ensuring the format matches your feed. CurrentTimeCode represents the current local time code, using the same format as publish_date/expiry_date.
If you provide publish_date/expiry_date in YYYYMMDDHHMM, you should also provide CurrentTimeCode in YYYYMMDDHHMM. If your site and servers are in the same region, provide the time code in the same time zone as the publish_date/expiry_date.
Handle time zones consistently
The publish_date/expiry_date timestamps in your feed correspond to the time zone used for generating your API calls.
To adjust your API calls to the desired time zone, add to CurrentTimeCode if the local server is behind the publish_date/expiry_date time zone, or subtract from CurrentTimeCode if the local server is ahead of the publish_date/expiry_date time zone.
See the table below for examples on changing CurrentTimeCode to adjust the launch time:
publish_date/expiry_date at 12:00 UTC | ||
Local time zone | Change to CurrentTimeCode | Launch time |
GMT (UTC +0) | No change | 12:00 UTC |
PST (UTC -7) | Add 7 hours | 12:00 UTC (5:00 local) |
No change | 19:00 UTC (12:00 local) | |
CET (UTC+1) | Subtract 1 hour | 12:00 UTC (13:00 local) |
No change | 11:00 UTC (12:00 local) |
If you want a simultaneous, global launch
- In the feed, provide publish_date/expiry_date values in UTC +0.
- In your API calls, provide CurrentTimeCode in UTC +0.
If you want launches based on local time
- In the feed, provide publish_date/expiry_date values in your primary market’s time zone.
- In your API calls, provide CurrentTimeCode in local time.
Example
Holiday seasonal merchandise
A home goods retailer manages multiple seasonal collections with overlapping availability periods. They use the launch window method to control product visibility:
- Halloween collection: publish_date=202510010000, expiry_date=202511010000
- Black Friday specials: publish_date=202511250000, expiry_date=202511302359
- Holiday gifts: publish_date=202512010000, expiry_date=202412252359
The system automatically shows Halloween products starting October 1st and hides them November 1st, while simultaneously managing Black Friday and holiday collections according to their respective schedules.
This eliminates manual oversight and ensures products appear and disappear at optimal times.
Updated 20 days ago