Documentation versions (currently viewingVaadin 8)

Vaadin 8 reached End of Life on February 21, 2022. Discover how to make your Vaadin 8 app futureproof →

Creating an application that preserves state on refresh

By default, Vaadin 7 does not preserve UI state when the browser page is refreshed. This means that the instance number in this example is incremented and the text field cleared on every page refresh:

public class CreatingPreserveState extends UI {
    private static int instanceCounter = 0;

    private final CssLayout content = new CssLayout();

    public void init(VaadinRequest request) {
        TextField tf = new TextField("Instance #" + (++instanceCounter));


You can however modify your application to preserve your UI between page refreshes with the @PreserveOnRefresh annotation like so

public class PreserveStateUI extends UI {

If you want to reinitialize some part of your application when the page is refreshed, you can (starting from Vaadin 7.2) override the refresh method in your UI class. This method is called whenever an already initialized UI is refreshed.

protected void refresh(VaadinRequest request) {
    content.addComponent(new Label("UI was refreshed @"
            + System.currentTimeMillis()));