# What’s new announcements

> “What’s new” announcements contain text that highlight recent updates, new features or important changes in the latest version of the application. Its purpose is to inform users about enhancements and guide them in utilizing new functionalities effectively.

#

## General rules

We follow this three-step approach when creating our updates. They explain what’s new, its purpose and benefit to users, and a possible further action. Although not every dialog requires all three steps, we aim for this whenever possible.

| Step | Purpose | Content | Structure and examples |
| --- | --- | --- | --- |
| 1. | Heading | Clearly state aim and purpose for the dialog, such as the theme, date, feature or version. | **Heading**: What’s new + topic:What’s new in Version 2.5What’s new in OctoberWhat’s new for 2025What’s new in dashboards |
| 2. | Description | Provide its purpose and benefits with information about key features. | **Description**: Receive instant notifications for critical events and system updates to stay informed and respond quickly to important changes. |
| 3. | Action | Provide links or buttons to more detailed information (usually with a verb). | **Action**: Learn more |

Use the wording “What’s new…” for the heading without a question mark (?) or period.

  
    What’s new in October
    What’s new in Version 3.2
    What’s new this month
  

  
    What’s new this month?
  

Use a contraction in the heading, i.e. “What’s” not “What is”.

  
    What’s new in October
  

  
    What is new in October
  

Use paragraphs or bullet points to present or highlight one point at a time instead of italics or bold.

  
    What’s new in the dashboard
      • Edit with new filter options.
      • Set up zones to itemize your assets.
  

  
    What’s new in the dashboard. Now includes customizable widgets, allowing you to tailor your view to your specific needs, new ways to edit your dashboards by moving or adjusting filters to help you with your day, and zones for dashboards such as by plant or groups to itemize your assets more easily.
  

Use a personal and engaging tone without being too informal (avoid emojis or slang).

  
    With this new version we bring you new features and improvements to enhance your experience.
  

  
    Yo fam, we’ve been grinding to drop some lit upgrades to level up your vibe! 🚀✨
  

Provide a clear way for users to dismiss announcements without confusion.

  
    Close
    Skip
    Skip and don’t show again
  

  
    Confirm
    Proceed
    Continue
  

Provide a clear way for users to postpone announcements.

  
    Not now
    Remind me at next login
  

  
    Maybe later
  

Avoid technical, negative or wordy dismiss actions.

  
    Terminate dialog
    No, I don’t want to improve my workflow
    I confirm I understand this announcement and wish to close this notification
  

## Dos and Don’ts

  
    Do allow users to close, postpone or choose to not see the content again
  

  
    Don’t add so much content that users need to scroll, instead use pages or split news
    Don’t embed critical text in images as it’s hard to translate and read
    Don’t add time-critical actions only in announcements as they are too easy to close
  

## Related

* [Onboarding](./onboarding.md)