Skip to content

Workshop Lizmap#


This workshop is designed for Lizmap users, half day.

  • FTP Client (WinSCP for Windows, Filezilla for MacOS/Linux)
    • qgis/topic_workshop : for the workshop
    • qgis/topic_workshop/media/metadata.pdf : a PDF file
  • QGIS 3.22
  • Lizmap plugin on QGIS Desktop
  • QGIS project attached in the email
    • The QGIS project contains layers from the PostgreSQL database


Presentations talking about QGIS Server and Lizmap during this FOSS4G from 3Liz :


First quick map#

  • Open the project
  • Set the extent on the map canvas to have all islands visible
  • In the Project Properties :
    • Project menu ➑ Properties
    • Relations tab, add all relations automatically with Discover Relations and select them all with ctrl
    • QGIS Server tab,
      • Enable Service capabilities
        • set a title such as Lizmap training NAME and an abstract about the purpose of the project. You can fill the author, organization, phone, email as well if you want.
        • You are free to use the text you want for these fields.
        • You can set keywords if needed. You will be to search your project with keywords in the landing page.
      • WMS capabilities
        • use the current canvas extent for the advertised extent
      • WFS capabilities
        • Use the checkbox published for all layers
    • Press Ok
  • Open the Lizmap plugin
  • Check the content of the Information panel
  • Only one time, add a server with your instance home page URL
    • Example
    • We don't need user and password.
    • Adding a login and password is not required and QGIS will ask you to set up a master password if you haven't done it before.
  • Close the Lizmap plugin (it's creating the Lizmap file when closing the window).
  • Transfert the project (.qgs et .cfg) in the folder qgis/topic_workshop on the FTP
  • Visit your Lizmap instance in the web browser


Bonus if you have a small PNG picture called name_of_project.qgs.png to replace the default project thumbnail. It works as well with jpg, jpeg files.

Quick overview of the Lizmap web interface#

  • The map
  • Lizmap folders
  • Administration panel


  • Add some groups in the legend
    • Editing with persons and observations
    • Data with municipalities
    • hidden, with small h, with species and you can add OSM base layer (from the QGIS Browser, XYZ Tiles)
  • Reorder layers to put them inside these groups according to the screenshot below
  • Rename layers with a more human-readable
    • Except for the OSM layer, in the group hidden, the name must be osm-mapnik



Lizmap is using QGIS Server in the background, the legend is, therefore, the same as in QGIS Desktop.

Some settings in the QGIS project or in the Lizmap plugin can have effects in the web interface.


Starting from now, often send the QGS file and the CFG file on the server to check the result online.

  • Make a quick symbology on a point layer :
    • on persons, change the default symbol using a single symbol.
    • On observations, we can try Categorized using the field fk_id_specie. You can use the QML already made (Vector layer properties ➑ Styles at the bottom ➑ Load styles).
  • Add labels on the municipalities layer and add a scale based visibility for these labels (1:300 000)
    • name field for the source
    • Rendering tab, scale based visibility minimum set to 1:300 000
  • Go in the Lizmap plugin, Layers tab :
    • Enable the municipalities layer by default
    • Add some links on two layers:
      • PDF for the persons layer : media/metadata.pdf, a PDF link, stored in the folder media (you can see it in the FTP client)
      • HTML for the municipalities :
    • Go in Baselayers tag and add the OpenStreetMap Mapnik background.

Lizmap layer properties

Attribute table#

  • From the plugin, enable the attribute table for the municipalities layer.
    • In the Attribute table tab, add a new layer

Lizmap attribute table


We can improve our attribute table by adding some alias on the fields :

  • Properties on the vector layer ➑ Form attributes ➑ Alias for all fields


Two new tools appeared in Lizmap Web Client : Attribute table as expected, but also Selection. Let's have a look.

Let's identify the feature by clicking#

  • In the Lizmap plugin, layers tab, enable some popups on the layer municipalities with automatic mode and check the results by clicking on a municipality.


The automatic popup will use alias if available on the layer.

  • Let's get back in the Lizmap plugin Let's switch to a popup with QGIS HTML Maptip mode on the same layer
  • Click on the Generate an HTML table
  • In the communes vector layer properties, rendering tab, then HTML Maptip, check the generated HTML.
  • Tip : QGIS ➑ View ➑ Show Map Tips to display maptip straight in QGIS Desktop. You need to select the maptip tool in the toolbar as well.

These QGIS popups are powerful with the use of QGIS expressions. πŸš€

With some expressions inside#

You can use expressions :

  • to display with capital letters
  • to display in red if the population is less than 20 000 inhabitants
Display solutions
  • The first one about capital letters, replace
    [% "name" %]
    [% upper("name") %]
  • The second one about the population in red, replace
        [% "population" %]
        <font color="[% if( "population" > 20000, 'black', 'red') %]">[% "population" %]</font>

Editing capabilities on a layer#

We want now to enable editing capabilities on a layer in the Lizmap interface, to let some users add some observations.

  • In QGIS, try to add a point and check how the default form is displayed on the layer observations. You need to toggle editing mode first with the yellow pen.
  • Improve the form in QGIS :
    • Layer Properties ➑ Attributes Form -> Drag&Drop layout form
    • Remove the field id
    • Make two groups : Required and Optional

Drag/drop form

  • Field configuration :
    • fk_id_person :
      • Alias Watcher
      • Relation reference with name
    • fk_id_specie :
      • Alias Species
      • Value relation layer species, key column id and value es_nom_commun
    • date :
      • Alias Date
      • Date/Time by default
    • photo :
      • Alias Photo
      • Attachment
    • gender :
      • Alias Gender
      • Value map and add some values in the table Male, Female

Form values

  • As soon as you have your form ready in QGIS (more or less πŸ™‚), add the layer in the editing panel in Lizmap


We can use QGIS Expressions in the form (visibility, conditions, default value etc.). Read the documentation.

PDF Print#

Extent chosen by the user#

  • In the given QGIS project, there is already a layout Landscape A4.
  • Enable print in your Lizmap plugin, map options tab.
  • Customize the title from Lizmap web interface in the PDF :
    • Click on the title Example workshop
    • In the properties, look for Object identifier and set title


In this case, the user is choosing the area of interest

From a popup, extent defined by the feature#

  • In the QGIS layout manager, duplicate the existing layout and let's transform it to an atlas
    • Project menu, Layout manager, Duplicate, name PDF sheet
    • Edit this new layout
    • Enable atlas on the municipalities layer
    • Change the title to display the name of the municipality
    • Enable the map to "follow" the current feature
  • Check in the result in Lizmap


While in this situation, the PDF is linked to a feature.


Bar chart#

  • Add bar chart in the Lizmap plugin about population in municipalities (and not a histogram).
    • Layer : Municipalities
    • X Field : Name
    • No aggregation
    • Trace :
      • field population
      • color blue

Dataviz population

Pie chart#

  • On "persons" layer, add a pie chart about each "watcher" :
    • Add a virtual field in "persons" called count, integer :
  • Add pie chart in the Lizmap plugin
    • Title
    • Description
    • Layer : Persons
    • X Field : Name
    • Aggregation sum
    • Trace : count

Dataviz pie

Advanced filtered plot#

For now, it's only charts at the layer level. It's possible to make charts for a given feature, for instance for a given "watcher", to know his own observations. You can watch the animated GIF at the bottom to understand the expected output, in the "Final result".

Dataviz filtered pie


Watch the video tutorial about the filtered plot.

  • Add a virtual field label_species (text) in the observations layer to have the name :
attribute(get_feature('species_aa247cf3_58c8_4852_8ada_1d707a593cfe', 'id', "fk_id_specie"),'es_nom_commun')
  • Add a pie chart on the persons layer :

    • Pie
    • Title : Species
    • Layer : Observations
    • X Field : label_species
    • Aggregation Count
    • Traces : id
    • Checkbox Display filtered plot in popups of parent layer
    • Checkbox Only show in child popup

Dataviz filtered pie

Final result

Dataviz filtered pie

Thanks 😎