Customizing the "What's New" dialog

The "What's New" dialog shows a curated list of features that are rolled out over time.

This document explains how to:

• understand the built-in release metadata
• shift release dates globally
• override or add custom release dates
• remap feature versions via configuration or extensions

Release metadata

The built-in dates and features are processed in the following order:

1. apply release shift in days
2. apply custom release dates
3. apply custom versions

Use-Case 1: Shift by fixed number of days

To move all release dates by a fixed number of days, configure releaseShiftInDays:

# shift all releases by 3 months / 90 days
io.ox/core//whatsNew/releaseShiftInDays: 90

Use this if you want to keep the relative ordering of releases while delaying the entire schedule.

Use-Case 2: Define custom release dates / skip releases

If you need fine-grained control, you can provide explicit dates per version via releaseDates:

# combine 8.45, 8.44 and 8.43
io.ox/core//whatsNew/releaseDates/8.45: "2025-10-01"
io.ox/core//whatsNew/releaseDates/8.44: "2025-10-01"
io.ox/core//whatsNew/releaseDates/8.43: "2025-10-01"

After this, all three versions will appear under October 2025 when rendering the dialog.

Use-Case 3: Set custom versions

In some scenarios you want to change under which version a feature appears, for example if you rollout features later.

Features are identified by their index (see table below).

Assume you want to change the version of the Scheduled email sending feature from 8.20 to 8.46. If the Scheduled email sending feature currently has index 26, you can configure customVersions:

# change the version of the `Scheduled email sending` feature from `8.20` to `8.46`
io.ox/core//whatsNew/customVersions/26: "8.46"

Feature indexes

Here is a list of the features with their corresponding index, title, and version:

Troubleshooting

For troubleshooting, all configuration examples below assume you are using the browser console and the core settings module:

const { settings } = await import('./io.ox/core/settings.js')

To test shifting all release dates by a number of days, you can use the following setting:

settings('io.ox/core')
  .set('whatsNew/releaseShiftInDays', 7)
  .save()

To test changing the release dates of specific versions, you can use:

settings('io.ox/core')
  .set('whatsNew/releaseDates', {
    '8.45': '2025-10-01',
    '8.44': '2025-12-20'
  })
  .save()

To test changing the custom version of a feature, you can use:

settings('io.ox/core')
  .set('whatsNew/customVersions', {
    45: '8.46'
  })
  .save()