Skip to content

QGIS plugin to export your project to an OpenLayers or Leaflet webmap. No server-side software required.


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

GitHub version Donate



QGIS plugin to export your project to an OpenLayers or Leaflet webmap.
It replicates as many aspects of the project as it can, including layers, extent and styles (including categorized and graduated).
No server-side software required.


  • In QGIS, select Plugins > Manage and Install Plugins...


  • Download and unzip this repo to your QGIS plugins directory


Prepare your map as far as possible in QGIS, as you want it to appear in your webmap. Specific tasks you can carry out to improve your webmap include:

  • Set your project title, and background and highlight colours in Project > Project Properties...
  • Give your layers human-friendly names in the Layers Panel
  • Give your layer columns human friendly names via Layer > Properties > Fields > Alias
  • Hide the columns you don't want to appear in your popups by changing their Edit widget to "Hidden"
  • If any of your fields contain image filenames, change their Edit widget to "Photo" to have the images appear in popups
  • Style your layers, and set their scale-dependent visibility, if required

Run qgis2web from the Web menu, or via its icon. If required, choose a basemap from the list below the preview pane, and click "Update preview". CTRL/CMD-click for multiple basemaps or to deselect a basemap.

The top-left pane lets you set options for each layer in your map. The bottom-left pane sets overall options for your project. All options are written to your QGIS project, so save your project if you want to keep these settings.


Read documentation on the WIKI


qgis2web is among the winners of the OSGeo:UK 2023 competition via GoFundGeo
os geo uk


We are thrilled to see how widely our project is being used and appreciated around the world. The development and maintenance require significant time and effort, and we want to continue improving and adding new features.

Please consider a small donation; even a modest "virtual coffee" can help support our commitment to providing quality software.

🎁 As a token of our gratitude, donors will receive as a gift qgis2opengis (a plugin enhancing OpenLayers export of qgis2web).🎁

Thank you for your support!
Happy mapping!🗺️


qgis2web's author is Tom Chadwin (@tomchadwin), in charge as official developer from April 2015 to November 2023, from this date Andrea Ordonselli (@andreaordonselli) took over.

The list of all other contributing developers is available at this link

For qgis2web enthusiasts we recommend reading this splendid article written by Tom which describes the birth and growth of qgis2web:

In short words:

qgis2web is fundamentally a merge of Victor Olaya's qgis-ol3 and Riccardo Klinger's qgis2leaf. It would not exist without their work. Thank you, gentlemen. Thanks are also very much due to Paolo Cavallini, who suggested and supported the merge.

  • @volaya
  • @riccardoklinger
  • @pcav

Obviously, qgis2web could not exist without the following monumental software:

  • QGIS
  • OpenLayers
  • Leaflet

Thanks are also due for major code contributions to:

  • @akbargumbira
  • @lucacasagrande
  • @walkermatt
  • @boesiii
  • @ThomasG77
  • @NathanW2
  • @nyalldawson (FTP export for Faunalia/ENEL)
  • @perliedman
  • @olakov

In addition, the following libraries have been used: