Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

Release notes for Vaadin Designer

Vaadin Designer is available for Vaadin platform and Vaadin Framework 8.

There is also separate product for Vaadin Framework 7. Release notes for that product can be found from

The latest version for Vaadin platform and Framework 8 is Vaadin Designer 4.6.11.

See the full list of releases.

Please review the requirements below and the  FAQ if you have problems.

Useful links

Vaadin Designer 4.x

What's new in 4.3

  • Part of Vaadin platform 14

What's new in 4.2

  • Configurable styles and themes

What's new in 4.1

  • Introduced a setting for disabling the shared styles import

What's new in 4.0

  • Redesigned Palette, Properties and Outline views for platform designs
  • Powerful ready-made snippets that allow you to quickly create content
  • Improved editing of text nodes
  • Performance improvements for large projects

Vaadin Designer 3.x

What's new in 3.1

  • Gradle project support
  • Works on Eclipse Photon
  • Part of Vaadin platform 11

What's new in 3.0

  • New Polymer template syntax for designs
  • Write Javascript and CSS directly into to the design file
  • New Palette for web components and HTML elements
  • Use any Polymer web component from Bower or WebJars
  • Support for nested designs
  • Any Flow component can be used as a companion file
  • Companion files are not overwritten on update


  • Windows 10 / OS X 10.12 / Ubuntu 16.04 LTS
  • Newest Chrome, Safari, Firefox or Edge.
  • Java 8 to Java 11.
  • Eclipse Oxygen, Photon and 2018. Java EE edition.
  • JetBrains IntelliJ IDEA 2016, 2017, 2018. Community or Ultimate edition.
  • Vaadin 8 or Vaadin platform.

Known Issues and Limitations

Vaadin platform
  • External preview doesn't work on IE11.
  • Horizontal scrolling using the trackpad doesn't work on Eclipse.
  • Some keyboard shortcuts, e.g. "delete", don't work in Eclipse Oxygen and Neon.
  • Running Eclipse macOS on JDK11 is not supported
  • Running Eclipse SimRel for Windows or Linux on JDK11 is not supported
Vaadin 8
  • All the components in Framework 8.4 are not supported (#1624)
  • Custom widgetsets not used when designing. Custom (project) components and nested designs are shown as place holders when designing.
  • Limited support for GridLayout; no column- or row-spanning.
  • The declarative format does not currently support ClassResource (e.g for icons and images). The supported resources are: ThemeResource (theme://), ExternalResource (http://), FileResource (file://) and (for icons only) FontIcon (fonticon://).
  • Using a theme from another project (e.g Maven multi-module project) is not supported.

Vaadin Designer 2.x

What's new in 2.2

  • Provide a way to access exported component through getter
  • Delay theme recompilation until save (IntelliJ)

What's new in 2.1

Support @PropertyId annotation for fields exported to Java companion file

  • Ability to set the PropertyId property for fields, and the value will be mapped into a @PropertyId annotation in the Java companion file

Replace layout with another layout in the outline

  • Replace with… added to context menu in the outline. Allows replacing any layout with another layout, preserving contents.

Copy size when wrapping

  • Copy size from wrapped components. For example, if you wrap a Component in a Layout, the size of the Component is copied to the Layout.

Icon preview

  • Show a preview of Vaadin Icons when editing the Icon property

Improved theme support

  • Support themes in resources folders.

Create Grid columns from bean

  • Automatically create Grid columns when item-type property is changed

Experimental embedded Chromium browser in Eclipse

  • Embedded Chromium browser can be enabled from plugin settings

What's new in 2.0

Requires Vaadin Framework 8 and Java 8. Does not support Vaadin Framework 7.

  • You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.
  • Generic types for selection components supported by ItemType property
  • Properties renamed to match new Vaadin 8 properties e.g. InputPrompt is now Placeholder
  • Stability improvements and bug fixes



Released 2021-11-05

  • Prevent clearing PrimaryStyleName property in Vaadin 8 designs (#1194)
  • Minor UI changes


Released 2021-10-19

  • Add companion file name to New template wizard (#2294)
  • Auto update Chrome editor preview after source change (#2387)
  • Explicitly refresh project after Polymer 3 dependencies installation (#2416)
  • Consider existing types only during annotation scan (#2065)
  • Fix custom theme support for latest project types (#2414)
  • Correctly detect custom theme name (#2415)
  • Improve Node server installation (#2397)
  • Improve exception handling in servlet (#2109)
  • Improve startup and loading performance
  • Minor UI changes and bugfixes


Released 2021-08-25

  • Support preview mode for embedded editor (#2409)
  • Allow creating new Vaadin 8 designs (#2410)
  • Restore selection after Chrome editor refresh (#2411)
  • Fix exception when clicking on empty Paper area (#2406)
  • Do not hide Help button behind text node editor (#2408)
  • Clear selection when clicking on empty Paper area (#2407)


Released 2021-08-10

  • Improve Node server installation (#2397)
  • Fix indefinite loop while indexing (#2374)
  • Fix exception in a "New Flow design" dialog (#2367)
  • Use logging interval for websocket heartbeat messages (#2373)


Released 2021-07-30

  • Fix not working Vaadin 8 Designer for IntelliJ IDEA 2021.2 (#2405)
  • Show IntelliJ IDEA settings dialog in version 2021.2


Released 2021-07-29

  • Fix not working Vaadin Designer for IntelliJ IDEA 2021.2 (#2404)
  • Create Lit templates by default in IntelliJ IDEA after upgrading Vaadin (#2401)


Released 2021-06-29

  • Support embedded browser editor for Flow and Java 11
  • Fix not working Designer for Vaadin 8 and Java 11 (#2393)
  • Use correct editor type depending on project, OS and IDE
  • Improve Node server installation


Released 2021-04-22

  • Custom theme support (#2383)
  • Gradle projects support (#2390)
  • Improved performance and fixed potential security issues


Released 2021-03-30

  • Lit template support for Flow 14.5+


Released 2020-01-16

  • Fix missing Java connector icon on web-based Toolbar (#2371)
  • Fix NPE when Id annotation has no value (#2372)


Released 2020-11-08

  • Support creating a new Lit template in Vaadin 17+ projects (#2332)
  • Support rendering and working with Lit templates in Designer visual editor. (2330)


Released 2019-09-05

  • Improved DnD visualization and logic.
  • Start from a layout template for new design. (#1857)
  • Use correct design folder in addon project. (#2125)


Released 2019-08-29


Released 2019-08-13

  • Fix warning bubble missing for unresolved imports. (#2108)
  • Update instructions to install frontend dependencies. (#2114)


Released 2019-08-01

  • Show instructions for JDK11 users. (#2100)
  • Show information about missing dependencies. (#2106)


Released 2019-07-17

  • Add Intercom chat toggle for IntelliJ. (#2098)

Released 2019-07-10


Released 2019-07-04

  • Fix problem with adding web components to design. (#2071)
  • Fix deletion issue in a small design. (#2066)
  • Ignore nested node_modules folder. (#2056)
  • Support nested generic parameters for ComboBox itemType property. (#2067)


Released 2019-06-03

  • Generated companion file has wrong annotation value. (#2046)


Released 2019-05-03

  • Vaadin 14 support: use Vaadin Designer to create and edit Polymer 3 based designs.


Released 2019-04-11

  • Fixed Eclipse hanging during editing design source. (#2022)
  • Fixed Eclipse crash while opening template. (#2015)
  • Fixed preferences opening exception in IntelliJ. (#2014)


Released 2019-02-19

  • Fixed not working Delete and other keys in Eclipse for Windows and Linux. (#2004)
  • Update editor if text content has been changed in Eclipse.
  • Fixed project settings exception. (#2000)


Released 2019-01-31

  • Support color palette choice for themes. (#1882)
  • Store style settings to project. (#1877)
  • Show only relevant project settings. (#1995)
  • Support data binding in embedded template. (#1907)
  • Allow design creation in default Spring project. (#1899)
  • Multiple lines text node content is updated in paper. (#1934)
  • Allow text node editing inside template element. (#1964)
  • Show paper selection without modifying element. (#1690)


Released 2019-01-16

  • Do not open browser automatically for license dialog. (#1727)
  • Fix exception after project reset. (#1577)
  • Do not show internal Jetty exceptions to user. (#1981)
  • Handle project removing in Eclipse. (#1989)
  • Refresh companion file status in Eclipse after Maven update. (#1984)
  • Do not report errors related to PUSH and connection state. (#1988)
  • Fix exception during Outline view disposing in Eclipse. (#1985)
  • Fix companion file handling in Eclipse 2018-12. (#1987)


Released 2018-12-20

  • Introduced a setting for disabling the shared styles import. (#1869)
  • Fixed Grid companion file connect issue. (#1947)
  • Fixed "render channel is already closed" exception. (#1861)

Released 2018-11-29

  • Support Java 11. (#1906)
  • Update form layout if colspan was changed. (#1951)
  • Select newly added component in outline. (#1933)
  • Handle Eclipse button press in property editor as text change. (#1953)
  • Do not show Vaadin perspective popup for platform designs. (#1911)
  • Fix exception when Material or None theme is used in Eclipse. (#1939)


Released 2018-11-22

  • Allow setting the component theme for the project. (#1868)
  • Support adding new properties to elements. (#1716)
  • Improve Outline rendering speed. (#1940)
  • Fix issue with properties editing from the editor. (#1950)
  • Allow platform design creation is Java class already exists. (#1945)
  • Report unresolved import only when it's needed. (#1939)
  • Fix exception during change of the Grid ItemType property. (#1946)
  • Fix exception when closing design. (#1941)


Released 2018-11-7

  • New Outline, Palette and Properties are used by default. (#1926)
  • Support dragging snippets from Palette to Outline. (#1668)
  • Support reordering elements in Outline. (#1675)
  • Hide style element in Outline by default. (#1886)
  • Fixed missing connection icon for new element in Outline. (#1904)
  • Fixed Lumo theme doesn't render correctly. (#1920)


Released 2018-10-25

  • Outline support for the Java file connection. (#1669)
  • Text node editing improved. (#1718)


Released 2018-10-11

  • Editing support for property values.
  • Indicate missing snippet imports in palette.
  • Palette usability improvements.


Released 2018-09-26

  • Show project components separately in the palette. (#1828)
  • Add selection for the outline. (#1667)


Released 2018-09-12

  • Save the state of palette categories before and after filtering. (#1618)
  • Improve palette icons using predefined colors. (#1571)
  • Group component snippets according to their main web component. (#1829)


Released 2018-10-25

  • Fixed charts rendering problem. (#1876)
  • Fixed issue with templates opening in starter. (#1897)
  • Fixed problem with Eclipse external preview in Firefox. (#1885)
  • Flow editor support for keyboard shortcuts in Eclipse. (#1863)
  • License dialog UX improvements. (#1745)


Released 2018-10-11

  • Handle unresolved imports from project.
  • Reduce amount of license checking requests.


Released 2018-09-12

  • Double-clicking a Vaadin 11 palette item now adds a sibling instead of a child. (#1689)
  • Fixed a bug that made the licensing banner of pro components like Charts appear.
  • Correctly write Grid's item type to Vaadin 8 designs if the type is a static inner class. (#1847)
  • Don't associate Designer with Polymer 2 templates in non-Flow project anymore. (#1843)


Released 2018-08-28

  • Support different frontend folder locations in spring boot projects. (#1812)
  • Fix widgetset load issue while opening platform designs. (#1582)
  • New platform designs include styles by default. (#1835)


Released 2018-08-08

  • Added compatibility with Vaadin 11.
  • Eclipse Photon support. (#1804)
  • JxBrowser update to 6.21. (#1805)


Released 2018-07-25

  • Automatically refresh external preview. (#1741)
  • Add String as an argument for Flow generic types. (#1749)
  • Render dragged snippet with multiple imports correctly. (#1682)
  • Only refresh paper when editing a data binding. (#1801)
  • Support Gradle webjars dependencies. (#1811)
  • Stop editing properties whenever underlying table widget is reloaded. (#1780)
  • Change design file if root components have been rearranged. (#1799)


Released 2018-07-04

  • Remember paper size and position for multiple design openings. (#1713)
  • Fixed issue when edits were not saved to template text. (#1591)
  • Fixed issue when server address was already reserved in Eclipse. (#1665)
  • Colspan attribute change updates form layout automatically. (#1800)
  • Web components detection logic improved. (#1759)
  • Modify template text only when new content differs form the previous one. (#1649)
  • Icon set updated for better UX. (#1782)


Released 2018-06-20

  • Eclipse proposes correct directory for Flow template in "New design" wizard. (#1647)
  • Fixed issue when trying to create Flow template in Vaadin project. (#1688)
  • Support multiple roots in snippet. (#1788)


Released 2018-06-07

  • CSS media queries now work correctly when paper size changes.
  • Changing the 'id' property updates the corresponding @Id in the Java file. (#1604)
  • Lumo styles are properly applied in the editor. (#1683)
  • Palette was removed from Preview mode. (#1568)
  • Fixed issues in working with multiple open projects. (#1593)
  • Fixed an issue in companion file detection if it contained multiple @HtmlImports. (#1712)
  • Support Java 10 in Eclipse Designer. (#1757)
  • Fixed rendering of the custom wysiwyg element. (#1778)


Released 2018-05-24

  • Improve the Javadoc in newly created Java companion file. (#1779)
  • Allow dropping components in the paper empty space to add a new root. (#1777)
  • Generate id for component based on existing label property. (#1776)
  • Hide the current design in palette components. (#1770)
  • Fit the initial paper size to viewport size. (#1620)
  • External preview has the same styling as deployed Flow application. (#1617)
  • Show the warning dialog for Java 10 users in Eclipse instead of crashing.


Released 2018-05-09

  • Improvements to newly created designs and their Java companions. (#1646)
  • Support running Designer on Java 9. (#1744)
  • Stability improvements in Eclipse. (#1753)

Released 2018-04-26

  • External preview works in any browsers (#1671)
  • Dropped support for IntelliJ IDEA 15. Minimum supported version is IntelliJ IDEA 16. (#1664)
  • "Flow template" is renamed to "Vaadin 10 design" (#1637)
  • Fixed the bug when it was impossible to add new viewport size preset (#1719)
  • Fixed the palette focus issue for Vaadin 10 design in Eclipse with macOS (#1627)


Released 2018-04-12

  • Improve design loading speed on the first design opening
  • Use an embedded license dialog for Flow design


Released 2018-04-05

  • Shared styles fetched from wrong folder (#1654)


Released 2018-03-29

  • Apply new license checker using subscription based license key
  • Use the correct Polymer import after production mode build (#1606)


Released 2018-03-22

  • Fix the bug which sometimes makes the IDE frozen and unresponsive after closing a design (#1625)


Released 2018-03-15

  • Use correct prefix (context or frontend) for connected companion file
  • Java Companion file for flow template is generated with wrong path (#1602)


Released 2018-03-08

  • Use Lumo variables without explicit import
  • Never show data binding property name in preview mode
  • Bugfixes: #1599, #1594


Released 2018-03-06

  • New Polymer template syntax for designs
  • Write Javascript and CSS directly into to the design file
  • New Palette for web components and HTML elements
  • Use any Polymer web component from Bower or WebJars
  • Support for nested designs
  • Any Flow component can be used as a companion file
  • Companion files are not overwritten on update


Released 2017-08-14

List of enhacements and bug fixes in issue tracker

Bug fixes:

  • An expired license is not accepted after extending
  • Eclipse palette is not shown completely on design opening in Linux
  • Caption of component inside FormLayout is not removed when cleared through field properties
  • Impossible to retrieve java companion file location in IntelliJ
  • SelectionMode property of Grid is missing from properties table
  • Generated getters is parameterized based on itemType property


Released 2017-07-28

List of enhacements and bug fixes in issue tracker

Bug fixes:

  • Designer show file has changes and save does nothing bug Eclipse ide
  • Design file is marked as dirty after theme switching bug designfiles Eclipse themes
  • Saving doesn't work even though file is shown modified bug Eclipse ide
  • Setting empty string to Label's value property doesn't work after it has been erased once
  • Thread interrupted in LicenseDialogHandler bug Eclipse feedback licensing
  • "Updating preferences" task won't stop Eclipse feedback settings
  • Cannot set ComponentAlignment in IntelliJ bug feedback IntelliJ properties


Released 2017-07-13

List of enhacements and bug fixes in issue tracker

Bug fixes:

  • Properties table sets property value to wrong component
  • Changing SplitPosition property's value causes error dialog.
  • Using a Tabsheet in a design might break the design until IntelliJ is (force)restarted
  • Resource folder cannot be created in IntelliJ New Design Wizard
  • Changing split position on the editor doesn't update SplitPosition property's value


Released 2017-06-28

List of enhacements and bug fixes in issue tracker


  • Companion file getters
  • Delay theme recompilation until save (IntelliJ)

Bug fixes:

  • Designer css classes no more visible
  • Modal Vaadin Designer license windows blocks Eclipse
  • Getting background "Timeout on Read" errors


Released 2017-06-13

List of enhacements and bug fixes in issue tracker


  • Made opening designs in Eclipse faster
  • Create "~/.vaadin/designer/templates" if it does not exist

Bug fixes:

  • Templates in ~/.vaadin/designer/templates are not loaded
  • License dialog keeps showing with trial license


Released 2017-05-18

List of bug fixes and enhancement in issue tracker


  • Allow unlimited offline usage with any license

Bug fixes:

  • Failed to update companion file if intellij project configuration files are inside custom folder
  • Wrapping root component does not expand the new root
  • Project name is null in the external browser preview title in IntelliJ
  • Unable to set rows property for some components
  • Exception when inserting new design source with namespaces
  • Editor scaling issue with multi monitors configuration in macOS in IntelliJ
  • Can't scroll horizontally design in Windows
  • Missing icons for the Vaadin perspective in Eclipse
  • Designer crashing when design has empty user attributes
  • Proxy authorization header is not preserved on license check


Released 2017-05-04

List of bug fixes in issue tracker

  • Icon preview for property editor
  • Support themes in resource folder
  • Support SBT projects
  • Move palette mode buttons to tool window
  • Exception setting value after date field resolution was changed
  • Experimental Chromium browser for Eclipse


Released 2017-05-03

  • You can now set "PropertyId" in the properties panel for components, it will show up in java as @PropertyId on the field
  • You can now right-click on a layout in the outline, and choose "Replace with…" in the context menu, e.g to replace a Vertical layout with a Horizontal layout.


Released 2017-03-24

IntelliJ only.

List of bug fixes in issue tracker

  • Editing properties throws exception in IntelliJ 2017


Released 2017-03-20

List of bug fixes in issue tracker

  • Grid throws exception when item-type is not String


Released 2017-03-01

Vaadin Designer 2.0 for Vaadin 8. Requires Vaadin 8 and Java 8. Does not support Vaadin 7. You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.


Released 2017-02-27

Vaadin Designer 2.0 now supports the final version of Vaadin Framework 8.


Released 2017-02-09

Second beta version of Vaadin Designer 2.0 for Vaadin Framework 8 Beta. Contains bugfixes and improvements for working with Framework 8 projects.


Released 2017-01-03

First beta version of Vaadin Designer 2.0 for Vaadin Framework 8. Requires Vaadin Framework 8 and Java 8. Does not support Vaadin Framework 7. You can have both Designer 1 and 2 installed at the same time. Design files in Vaadin 7 project, will be opened in Designer 1.x and designs in Vaadin 8 project will be opened in Designer 2.x.