improvements

Author: hugocasa

…-token-expiration-notifications/index.md …-token-expiration-notifications/index.mdchangelog/2026-03-02-token-expiration-notifications/index.md renamed to changelog/2026-03-03-token-expiration-notifications/index.md changelog/2026-03-02-token-expiration-notifications/index.md renamed to changelog/2026-03-03-token-expiration-notifications/index.md

@@ -2,12 +2,11 @@
 slug: token-expiration-notifications
 title: Token expiration notifications
 tags: ['Core']
-description: Windmill now monitors API token expiration and notifies owners via email 7 days before expiry and upon deletion. A new instance setting controls in-app critical alerts for token expiry.
+version: v1.649.0
+description: Windmill now monitors API token expiration and notifies owners via email 7 days before expiry and upon deletion. A new instance setting controls critical alerts for token expiry.
 features:
   - 'Email notifications sent to token owners 7 days before expiration and when expired tokens are deleted.'
-  - 'New "Alert on token expiry" instance setting to enable in-app critical alerts for expiring/expired tokens.'
-  - 'Color-coded expiration badges in the tokens table for tokens expiring within 30 days.'
-  - 'Warning banner in the tokens table for tokens expiring within 7 days.'
+  - 'New "Alert on token expiry" instance setting to enable critical alerts for expiring/expired tokens.'
   - 'New TokenExpiringSoon and TokenExpired workspace webhook event types.'
 docs: /docs/core_concepts/critical_alerts#token-expiration-notifications
 ---

docs/advanced/18_instance_settings/index.mdx

@@ -313,7 +313,7 @@ Enable to mute critical alerts in the UI.
 
 ### Alert on token expiry
 
-Enable to send [critical alerts](../../core_concepts/37_critical_alerts/index.mdx#token-expiration-notifications) in the UI when API tokens are about to expire (within 7 days) or have expired. This setting is off by default.
+Enable to send [critical alerts](../../core_concepts/37_critical_alerts/index.mdx#token-expiration-notifications) when API tokens are about to expire (within 7 days) or have expired. This setting is off by default.
 
 Email notifications to token owners are always sent regardless of this setting, as long as [SMTP](#smtp) is configured.
 

docs/core_concepts/37_critical_alerts/index.mdx

@@ -26,7 +26,7 @@ Critical alerts are generated under the following conditions:
 Windmill monitors API tokens and sends notifications when they are about to expire or have expired. Token owners receive an email notification 7 days before expiration, and again when the token is deleted after expiry.
 
 - Email notifications are always sent when [SMTP](../../advanced/18_instance_settings/index.mdx#smtp) is configured, regardless of the "Alert on token expiry" setting.
-- In-app critical alerts are only shown when the ["Alert on token expiry"](../../advanced/18_instance_settings/index.mdx#alert-on-token-expiry) instance setting is enabled.
+- Critical alerts are only sent when the ["Alert on token expiry"](../../advanced/18_instance_settings/index.mdx#alert-on-token-expiry) instance setting is enabled.
 - Session and ephemeral tokens are excluded from expiration notifications.
 
 The tokens table in user settings also shows color-coded expiration badges for tokens expiring within 30 days, and a warning banner for tokens expiring within 7 days.

docs/core_concepts/4_webhooks/index.mdx

@@ -107,6 +107,8 @@ securely!
 
 :::
 
+When [SMTP](../../advanced/18_instance_settings/index.mdx#smtp) is configured, token owners automatically receive an email notification 7 days before a token expires, and again when the token is deleted after expiry. The tokens table in user settings also shows color-coded expiration badges for tokens expiring within 30 days. For more details, see [Token expiration notifications](../37_critical_alerts/index.mdx#token-expiration-notifications).
+
 ![Create new tokens](./tokens.png.webp)
 
 ### Webhook specific tokens