Documentation versions (currently viewingVaadin 8)

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

Using URI fragments

Reading Fragment when Initializing UI

URI fragments can either be used for initializing the UI and/or read or modified in any listener. In the UI.init method you get a "VaadinRequest request" parameter. The UI’s Page contains a information about the HTTP request used to initialize the application and you can get the URI fragment using


A simple init that depends on the URI fragment is thus:

public class MyUI extends UI {
  protected void init(VaadinRequest request) {
    layout = new VerticalLayout();

    Label label = new Label("Hello, your fragment is "
            + getPage().getUriFragment());

Reading Fragment Changes

The URI fragment can be changed also when the application is running, either manually in the location bar in browser or from user code. These changes can be caught with a FragmentChangedListener. Notice, however, that there is no event fired for the initial URL fragment. The easiest way to handle both cases in the same way is to call the same method from the FragmentChangedListener and the init method:

public class MyUI extends UI {
  // ...

  // React to fragment changes
  getPage().addUriFragmentChangedListener(new UriFragmentChangedListener() {
    public void uriFragmentChanged(UriFragmentChangedEvent source) {

  // Handle the fragment received in the initial request

  addComponent(new Button("Show and set fragment", new Button.ClickListener() {
      public void buttonClick(ClickEvent event) {

Reading and Writing the Fragment

To later on read the fragment you can use


and to set the fragment

Page.getCurrent().setUriFragment(String fragment);