# Feature OP-20425 - What's new in: a popover to inform users about new features in every new release

Project: OpenProject
Status: merged
URL: https://community.openproject.org/work_packages/OP-20425

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 18.0.0, Passion time |
| Sprint |  |
| Backlog bucket |  |
| Votes |  |
| List |  |
| Roadmap | 2026 Q4 |
| Relevance | Medium — Useful Mid-Term |

## OPEN POINTS / FEEDBACK

_No work packages_

## Features and Chunks

_No work packages_

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| OP-20715 | Bug | The title font is too big | in development | Lars Wassermann | 18.0.0 |  | Modules and project features / Navigation, Modules and project features / Navigation / Header navigation, Frontend components and Primer design system |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Modules and project features / Navigation, Modules and project features / News, Marketing |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan | Community (COM) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups | https://www.figma.com/design/zIyuX8f5oda3pJTIcSCy9I/What-s-new?node-id=42-527 |
| Found in mobile app version |  |
| Follow-up feedback e-mail |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee | Cécile Guiot |
| Accountable | Sonita Soth |
| Product manager | Sonita Soth |
| Developers | Oliver Günther |
| Designer | Parimal Satyal |
| Ordered by |  |
| Signed off by |  |
| Interest by | Home (224196000003952096), Frozit (38662) |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** an OpenProject user  
**I want to** know about new features when I upgrade to a new version  
**so that** I know what has changed and what new capabilities now exist in my project management tool

**Context**

This is a Passion Time feature, part of: <mention class="mention" data-id="77188" data-type="work_package" data-text="##SE-620" data-display-id="SE-620">\#\#SE-620</mention>

**Acceptance criteria**

  - When an OP admin upgrades their instance to a new version, show an icon in the top navigation bar, to the left of the icon Notification center
    
      - *Used icon:* `gift`
    
      - When there are new/unread items, the icon has a small red badge on the top right corner to draw the user's attention
    
      - On hover, show tooltip: "What's new in {major release number}"

  - Clicking on the icon displays a popover:
    
      - **Title** (top left), same string as the tooltip: "What's new in {major release number}"
    
      - **Link to release video** (top right):
        
          - Component: link
        
          - Leading icon: `video`
        
          - Label: "View release video"
        
          - Optional: Only visible when the release video link is present
    
      - **A list of feature items**

  - A feature item consists of:
    
      - **Title**: Name of the feature (owner: Marketing)
    
      - **Description**: A short description (owner: Marketing)
        
          - Guidelines: Can be multi-line but 2 lines max recommended, ~130 characters max
    
      - **Link**: This can be a link to a blog article, a release video or documentation (Owner: Marketing)
        
          - *\[open\] Linking to the feature itself a technical possibility, but perhaps not the best idea (what if the user doesn't have the necessary permissions? What if the module is not enabled? If it's a project-level feature, which project do you link to?)*
    
      - **A read/unread badge**: blue, same component as the blue dot for unread elements in the Activity tab
    
      - *\[open\] Large illustration:*
        
          - *A optional full-width image block to be used only on the first item/star feature. This can be an illustration or an animated gif.*
    
      - *~~\[open\] Feature icon:~~*
        
          - *~~This ideally isn't an Octicon since all features don't have an Octicon associated with them. The question then is: who provides this icon?~~*
        
          - *~~We shouldn't optionally have an icon: either all items have an icon or none do (for alignment and consistency)~~*
        
          - *~~Marketing have indicated that this might not be practical~~*

  - Number of items:
    
      - There are no technical limits on how many items are shown, although the recommendation is to try to limit to 5–7 max. This is however a soft limit, not a technical one.
    
      - There is a *max-height (to be decided, ~7 items shown?)* to the popover, after which there will be an internal scroll. This will almost certainly not be reached on desktop screens.
    
      - **Similar to the feature highlights, Marketing picks items that make sense and will be aware of the sizing implications**

  - Behaviour over time:
    
      - The icon disappears after 7 days of the first activation from the user
        
          - e.g., Icon shows with red dot, user clicks it. 7 days later, it is not rendered in the top menu
    
      - A red dot indicates a new release.
        
          - The minute the user clicks on it, the red badge disappears.
            
              - Even if she doesn't click on any feature.
            
              - The blue dots will still indicate the ones that she has not yet read
    
      - For each item, the blue dot disappears once the user clicks on the item

  - Mobile version:
    
      - On mobile, there is no room for an additional icon. Instead, it moves as an link in the the user menu, with:
        
          - icon: the same icon as on the navigation bar (including the red badge)
        
          - label: same string as the title of the popover ("What's new in {release number}")

  - Ownership: Marketing provides info per item.

**Visual reference**

<img class="image_resized op-uc-image op-uc-image_inline" style="width:591px;" src="/api/v3/attachments/925858/content">

**Mockups:**

[Figma mockups](https://www.figma.com/design/zIyuX8f5oda3pJTIcSCy9I/What-s-new?node-id=42-527)

**Technical notes**

  - The release number in "What's new in {n}" should come automatically from the system (current major version)

  - Aggregation:
    
      - ~~Some users might skip certain versions and need to upgrade from, say, 16.0 to 18.0.~~
    
      - ~~\[to be confirmed\] However, admins today need to upgrade one major release at a time, so it is currently not possible to know if a user is coming from a much older version.~~
    
      - In v1, we will only show new features for the *current* new release.

**Permissions and visibility considerations**

  - Menu is shown to all logged-in users

**Translation considerations**

  - The feature title and text should ideally be translated into at least our core languages (EN, DE, FR, ES...)

**Out of scope**

  - Aggregation when upgrading from a much older version, including possibly linking to the blog index pre-filtered to show all release articles