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...
or:
- 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.
More info on the WIKI
qgis2web is among the winners of the OSGeo:UK 2023 competition via GoFundGeo
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!🗺️
QGIS, OpenLayers, and Leaflet are all different mapping technologies. This means that their respective functionality differs in many ways. qgis2web does its best to interpret a QGIS project and to export HTML, Javascript, and CSS to create a web map as close to the QGIS project as possible.
However, many elements of a QGIS project cannot be reproduced, and many are only possible in either OpenLayers or Leaflet. qgis2web tries its best to produce a publish-ready map, but you can always manually edit the output code to achieve what qgis2web cannot.
- in OL3 maps, only single rendered points cluster, not categorized or graduated
- line style (dashed/dotted) does not appear in OL3 preview, but works in export
- only a single 2.5d layer will render per map
- 2.5d layers only appear when zoomed in to building scales
- attribute filters and abstract export only works in leaflet based webmaps
Please report any problems you have with qgis2web. Without this feedback, I am often completely unaware that a problem exists. To ensure no time or effort is wasted in bug reporting, please follow these steps:
- Make sure you are using the latest release of qgis2web
- Check the issues on Github to see whether the bug has already been reported, and if so, read through all the comments on the issue, and add any additional information from your experience of the bug
- Make sure you can reproduce the bug reliably
- Reduce the complexity of your bug conditions as far as you can, especially by reducing the number of layers, ideally to one
- Raise a Github issue, including:
- only one bug per Github issue
- the qgis2web version (or make it clear you are using Github master branch)
- any Python error text/stack trace which occurs
- browser JS console errors - press F12 in qgis2web to open the developer toolbar and find the console
- screenshot of your settings
- screenshot of the output
- a link to the data you used, if possible
The stability of qgis2web relies on your bug reports, so please keep them coming.
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:
- ol3-layerswitcher, by @walkermatt
- Autolinker.js, by @gregjacobs
- requestAnimationFrame polyfill, by @paulirish
- Function.prototype.bind polyfill, by @mozilla
- Leaflet.label, by @jacobtoye
- Leaflet.Locate, by @domoritz
- Leaflet.markercluster, by @danzel
- leaflet-measure, by @ljagis
- leaflet-hash, by @mlevans
- Proj4js, by @madair, @calvinmetcalf, and other
- Proj4Leaflet, by @kartena
- Leaflet.search, by @stefanocudini
- ol3-search-layer, by @ThomasG77
- Leaflet.heat, by @mourner
- OSMBuildings, by @kekscom
- multi-style-layer, by @perliedman
- Leaflet.SvgShapeMarkers, by @rowanwins
- rbush, by @mourner
- Labelgun, by @JamesMilnerUK
- Leaflet.pattern, by @teastman
- Leaflet.VectorGrid, by @IvanSanchez