Vaadin Flow Route Title Configuration: Missing Precedence Rule Between @Route.pageTitle and getPageTitle()

Answer

When a Vaadin Flow component declares both a @Route(pageTitle = "…") annotation and overrides getPageTitle(), the method’s return value determines the browser <title>. The annotation serves only as a static fallback that is used if the method is not overridden or returns null.

Explanation

1. Annotation role: @Route.pageTitle is read during route registration and provides a default title string.
2. Method role: getPageTitle() is invoked each time the route is navigated to, allowing dynamic title resolution.
3. Precedence rule: The UI‑side Page component first checks the value returned by getPageTitle(); if it is non‑null, that value is sent to the client and sets the document title. Only when the method returns null (or is not overridden) does the framework fall back to the annotation‑provided default.
4. Version consistency: This behavior has been present since Vaadin 23.x LTS and remains unchanged in later releases because it follows the general pattern of dynamic overrides superseding static metadata.

Verification steps

1. Create a view:

@Route(value = "test", pageTitle = "Static Title")
public class TestView extends Div {
    @Override
    public String getPageTitle() {
        return "Dynamic Title";
    }
    public TestView() {
        add(new Paragraph("Check the browser tab title."));
    }
}

2. Run the application and navigate to /test.
3. Observe the browser tab: it should display "Dynamic Title".
4. Remove or comment out getPageTitle() and repeat; the tab should now show "Static Title".

Additional considerations

• PWA manifest fields (short_name or name) may influence the title shown when the app is installed as a standalone application, but they do not affect the normal browser tab title.
• Custom JavaScript that directly sets document.title can override the Vaadin‑provided value; this is outside the framework’s control.
• No built‑in Vaadin listeners or PWA mechanisms change the precedence described above.