LizPack Field documentation

There are two ways into LizPack Field: your LizPack Field account and its password, or your LizPack account, through « Continue with my LizPack account ».

Go to the home page https://field.lizpack.com: with no active session you are sent to the sign-in screen (https://field.lizpack.com/login).

1. On the sign-in screen (https://field.lizpack.com/login), click « Sign up » at the very bottom, after « Don't have an account yet? »: the page https://field.lizpack.com/signup opens.
2. Enter your address, a password of at least 8 characters and its confirmation, then tick the box accepting the privacy policy. The eye-shaped button of each field shows or hides what you typed. Errors are reported field by field.
3. Click « Create my account ». A « Check your email » screen appears with your username, which is assigned automatically: open the message you received and click its button; the « Address confirmed » page of LizPack Field opens, then sign in with your address. If the address already has a LizPack account, the « This address already has a LizPack account » screen appears: click « Continue with my LizPack account », sign in to LizPack as usual (password or Google, plus a verification code if your account asks for one); you come back to LizPack Field, signed in, with an account linked to your LizPack account. « Use another address » takes you back to the form. If the address already has a LizPack Field account, the « You already have an account » screen appears: an address gives only one account, click « Sign in ».
4. On your first sign-in, the « Personal information » window asks for your first name, last name and country. That information appears on your invoices and on your account.

1. With your LizPack Field account: on https://field.lizpack.com/login, enter your e-mail (or your username) and the password of your LizPack Field account, then click « Sign in ». Your LizPack Field account and your LizPack account with the same address share one and the same password: your LizPack password works here, including for a LizPack Field account created through « Continue with my LizPack account ». After a change, in LizPack, in the LizPack Field settings or through « Forgot your password? », the new password applies on both sides and the old one no longer works.
2. With your LizPack account: below « or », click « Continue with my LizPack account ». If a LizPack session is open, you get in without typing a password again; otherwise sign in to LizPack as usual (password or Google, plus a verification code if your account asks for one), then you come back to LizPack Field, signed in to the account linked to your LizPack account. If you do not have one yet, it is created and linked at that moment; if the privacy policy has never been accepted on your LizPack account, tick it on the screen that appears, then click « Create my LizPack Field account ». If the account cannot be created at that moment, a message says so: the team is notified automatically, try again later.

On the sign-in screen, click « Forgot your password? » (https://field.lizpack.com/forgot-password), enter your address, then click « Send the link ». The next screen is the same whether or not the address has an account. The message you receive opens the « New password » page of LizPack Field: enter the new password and its confirmation, then click « Save the password ». This new password also applies to your LizPack account with the same address. The link works only once and for a limited time: after that, the page shows « Link expired or already used » and offers « Ask for a new link ». When you sign out, the session is closed on the server, then your local token and the LizPack session cookies are cleared; your other sessions (QField on your phone, another browser) and your API tokens remain valid; if your session expires while you are working, the address you were on is remembered so you are brought back to it after signing in again.

Once you are signed in, the application is built around a permanent navigation sidebar and a main content area. The sidebar adapts to the screen: collapsed or expanded on a computer, laid over the page on mobile. This documentation, for its part, can also be read without an account, at https://field.lizpack.com/documentation.

At the bottom of the sidebar are the « LizPack Field plan » block (plan name, storage gauge, « See plans » button) and your account (initials, username, e-mail, sign-out button). Whether the sidebar is expanded or collapsed is remembered from one visit to the next.

The application is available in French, English, Spanish and Portuguese. At the top of the page, the language list, at the globe (FR, EN, ES or PT), comes before your account menu, at your initials, the same as in LizPack: « My profile », « My projects », « Organizations », « Community », « Settings » and « Sign out ». As in LizPack, the « Based on QField » note disappears on a tablet, and on a phone the application name and the language list leave the header to make room for the buttons: the language is then chosen in « Settings », on the « Profile » page. The choice applies at once and is saved to your account: you find it on any device, and it changes neither when you refresh nor when you go from LizPack to LizPack Field. A link coming from the lizpack.com website opens the sign-in page in the website's language; once you are signed in, your account's language applies. The grid « Apps », next to the search, groups the LizPack applications: LizPack, LizPack Field, LizPack Viewer (an empty map, to build with the layers of your projects), « Databases », GeoServer, Marketplace, « LizPack documentation » and « Field documentation ». On your organization's server, it lists the portal applications opened by the license (« Portal », « Lizmap sites », « Databases », « Map catalog », GeoServer, « Portal help »), then LizPack Field, LizPack Viewer and « Field documentation »; the portal checks your rights when each one opens. Between the search and this grid, two buttons stay within reach on every page: « New map » opens LizPack Viewer on an empty map, « Create a project » opens project creation. On a narrower screen, they show only their icon, with their name on hover; on a phone, they move into your account menu.

The « Search » field, at the top of every page, finds in one go a page of the application, one of your projects, one of your organizations or a passage of this documentation. Ctrl+K (Cmd+K on a Mac) or the / key opens it from any screen; the arrow keys pick a result, Enter opens it, Esc closes the search. Capitals and accents do not matter: « settings » finds « Settings ».

Name a project then a tab to go straight there: « cotonou map » opens the project's map, « cotonou files » its « Files » tab. Only the projects and pages your account can open appear. On a phone or a tablet, a magnifying glass replaces the field and opens the search across the full width of the screen.

The web application adapts to small screens: on a phone or a tablet, the sidebar collapses behind a menu button and opens over the page, the list of projects moves to a single column and the map takes the full width. You can therefore manage your projects from a phone, alongside the QField app used in the field.

The dashboard is the first page after you sign in, at https://field.lizpack.com/dashboard. It gathers the figures of your account: projects, storage, field collection, jobs, maps, team, subscription and databases. The list of your projects is on the « My projects » page.

The « My projects » page lists your projects. A project gathers a QGIS project, its layers, its files, its collaborators and all the data collected.

1. Click « Create a project », at the top of the « My projects » page or in the header of every page (except on phones), then name the project: letters, digits, dots, hyphens and underscores only. The description is optional.
2. Choose the owner: yourself or an organization you are a member of.
3. Set the « Public », « Overwrite conflicts » and « Restrict project files » options if needed (the latter reserves .qgs/.qgz/.qgd files for managers and administrators).
4. Under « Initial content (optional) », attach a .qgs/.qgz file or a complete folder, then click « Create the project ». Everything else is added afterwards from the Files tab.

The « Import a folder » button on the list of projects creates a project from a folder on your computer, keeping its subfolders. The files are sent in parallel, with a progress bar.

Opening a project gives you a space organized in seven tabs. Each tab has its own address: a link can open the LizPack Viewer or Files tab directly, and the browser's Back button returns to the previous tab. The information refreshes automatically every few seconds, without flicker, and the refresh pauses when the browser tab goes to the background.

The Files tab lists everything in the project, with the QGIS project first. Each line shows an icon for the file type, its name, its role (« QGIS project », « Data » or « Attachment » for example), its size, its modification date and its versions; the icons at the end of the line download or delete it, after confirmation. « Upload » adds files or a whole folder, subfolders included, and you can also drag them straight onto the list. « Download all » exports a ZIP archive, and « Prepare for QField » rebuilds the package that QField downloads to the phone: the job can be followed in the Jobs tab. Clicking the number of versions unfolds the file's history; each version kept by the server can be downloaded separately.

The QGIS project (.qgs, .qgz) holds the connection strings of its layers, database passwords included. The « Protect the QGIS project » switch, in the « Edit project » card of the Settings tab, prevents it from being downloaded, for everyone, the owner included: from the application as well as through the API or an API token. QFieldSync, in QGIS, and QField still receive it: they need it to synchronize. Then click « Save ». Still possible: uploading or replacing the project, preparing it for QField and syncing the phones. The project map still shows its layer tree: the platform reads the project itself and never sends out the file.

A new project is protected as soon as it is created. A project created before this option existed is not: the Settings tab offers to turn it on. Only the project owner and the administrators of the organization that owns it can change this setting; for everyone else, the switch is grayed out.

On a Pro plan, the « Database » card of the Settings tab links the project to a PostGIS database: that of a Lizmap instance, or an external one. Enter the host, port, database name, user and password, or fill in the form with « Import a QGIS .xml », then click « Test & connect »: the connection is tested, then stored encrypted. The database's spatial layers then appear on the project's map, where you can correct attributes (see « LizPack Viewer »). « Unlink » removes the link.

The « Download the QGIS connection (.xml) » button produces a connection file to import into QGIS (Manage connections, then Load). For field collection to write into this database, the QGIS project must contain PostGIS layers pointing to it: one database then feeds both the field collection and the map publication. The « Collection compatibility » card checks that the database is ready and, if not, offers « Make the database compatible ».

A project's map opens on its own page, in the content area of the application. It shows the project's layers over a basemap; the surveys sent from the field appear on it at each synchronization, without reloading the page. This chapter describes each tool, in the order you come across it.

1. Open the project from « My projects ».
2. Click the « LizPack Viewer » tab: the map opens on its own page, with its own address, which you can bookmark or send to a collaborator.
3. On loading, the map frames the widest layer; as soon as you move it, it no longer reframes itself.

1. Open the application launcher in the header and choose « LizPack Viewer »: the application opens full screen on an empty map, centered on the whole planet, with all the map tools and an empty « Layers » panel. The launcher, the language and your account stay at the top of the page, and the launcher takes you back to LizPack Field. In LizPack, the same entry opens LizPack Viewer in a new tab, without entering your password again.
2. Click « Add layers »: the panel lists the projects you have access to. The « Projects », « Databases » and « By URL » sections are closed when the panel opens: a click on their title expands them, and a search opens them all. « By URL » opens the « Add a layer from a URL » panel (an online service or a file by its address). Expand a project to see its layers (expanding another one collapses the first), then click « Add » next to a layer, or « Add the whole project ». A GeoPackage can be expanded in turn: choose its layers one by one, or add it whole. Under « Databases », the panel also lists the databases of your account (ordered databases and the database of each instance; on your organization's server, those of the portal): expand one to see its tables with geometry, then « Add ». These layers are read-only, up to 5,000 features, read again within the displayed extent when the table has more; on a shared map, only an account with access to the database sees them. The « Search for a project or a layer » field finds a project by its name or owner, and a layer by the name of its file or of a GeoPackage table, across all your projects: projects found through their layers open on those layers only.
3. The layers are listed in « Layers », under the name of their project: one map can combine layers from several projects, and layers added « By URL » (WMS, WFS, GeoJSON…).
4. « Remove » takes a layer off the map without changing the project. The menu of a layer (the three dots on its row, in « Layers ») also offers « Remove from map », after confirmation. Until it is saved, the map is a draft specific to this tab: reloading it shows the same map, but reopening LizPack Viewer starts from an empty map. With no layer, the map goes back to the whole planet.
5. The icon next to a project, « Open the project map », opens that project's map with its saved styling.

1. Click « Save map », give it a name, then click « Save »: the map joins « My maps », on the server, and follows you on all your devices. Its layers are then saved each time you add or remove one; its styling with « Save map styling », as on a project map. Two of your maps cannot have the same name, ignoring capitals and extra spaces: a name already taken is refused, with a message under the field.
2. « My maps » lists your saved maps: click a name to open it, « New map » (here or in the header of every page, except on phones) to start again from an empty map, or the trash can to delete a map, after confirmation. Deleting a map does not affect any project. The « Maps » page, in the LizPack Field sidebar, also lists your maps: who can open them, their layers, projects and modification date. Clicking a row opens the map; its buttons copy the link, share or delete the map. A map open to anyone with the link shows its private projects there, hidden without an account. « Search for a map » and the « All maps » list filter the page.
3. On a saved map, « Share » (at the top of the page or in the left bar) opens the « Share the map » panel, with the same settings as sharing a project map: who can open it (« Only me », « LizPack Field accounts with the link » or « Anyone with the link »), the « Name », « Allow downloads », « Share the dashboards », the header (color, logo, author, « Description »), the visible layers and fields, and the embed code of a map open to everyone. « Save » applies the settings to the link, which never changes; « Preview » shows the map as people with the link see it.
4. The map is shared, not the data: everyone only sees the layers of projects they can access, minus those you removed from sharing, with only the checked fields. Without an account, only the layers of public projects are shown: on opening, a window offers to « Sign in » to see the others, or to « Continue without an account », and a message gives the number of hidden layers. Layers added by URL are always shared. When the map is open to « Anyone with the link » and some layers come from private projects, « Save » opens « Share the layers with everyone? », which lists these projects and their layers: « Make this project public » (« Make these projects public » when there are several) opens them to everyone, in full, then saves; « Save without sharing them » keeps the projects private. Only the owner or an administrator of a project can make it public.
5. For others, a shared map opens in « Read only »: they adjust the display for themselves, without saving it. « Save a copy » creates a new map from yours, to change without altering the original. The copy takes a free name: « Copy of … », then « Copy of … (2) » if that name is already taken.

« Layers » lists the project's layers as a tree: groups and subgroups expand with a click on their arrow. A group's eye shows or hides the whole group (dimmed when only part of it is shown), and a click on its name collapses or expands it. Under a layer's name, a discreet line gives its number of features and, when it distinguishes the layer, its type (WMS, CSV…); the drag handle and the table button appear on hover; « Hide all » or « Show all », at the top of the panel, acts on every layer. The number to the right of a layer is its number of features; a format tag (GPKG, POSTGIS…) only appears when the layer does not have the most common format of the project.

1. Click « By URL » in the left-hand bar: the « Add a layer from a URL » panel opens.
2. Paste the « URL » of the service or file. Leave « Service type » on « Automatic », or choose « WMS », « WMTS », « XYZ tiles », « WFS », « GeoJSON » or « CSV ». On « Automatic », the address of an Opendatasoft dataset (opendata.paris.fr, data.grandlyon.com…, « records » API, dataset page) or of an ArcGIS layer (…/FeatureServer/0) is read as GeoJSON, filters included; another address is accepted if its content is GeoJSON.
3. Click « Read URL »: the panel shows what the service offers, then the settings for that type.
4. Check the « Layer name » and click « Add to map »: the layer joins the « Layers » panel and the « Added layers » list, and the « URL » field empties for the next address.

A WMS, WMTS or XYZ layer is an image: its only setting, in « Style », is « Opacity », with the service's « Legend » when it provides one, and the « Source ». A WFS, GeoJSON or CSV layer is a feature layer like any other: style, labels, details, table, filter, statistics and analyses apply to it. In « Added layers », each layer has five buttons: edit it, its information, zoom to it, reload it (service back, data updated) and remove it. The pencil reloads the layer into the form, with its address and options: change them, then « Save » replaces it in place, visibility and opacity kept. In the layer list of a WMS, a « Group » draws all its layers for each image: it is much slower than a single layer. When the service is read, all its layers are checked by default (up to ten; beyond that, only the first) and their folder opens in « Layers » after they are added. Each checked layer becomes a map layer, filed according to the groups of the service (otherwise in a folder named after it); checking a group checks all its layers, and a group checked with its sublayers is not drawn a second time. A WMS layer is an image: in « Statistics », « Load its data (WFS) » adds its features when the service also publishes them as WFS, and the table, statistics and dashboards apply to them. The information unfolds under the layer: service type, address (clickable), direct access or through the relay, chosen layers or feature type, format, version, style and grid, loaded features, extent and the service legend. If a service refuses to be read from the browser, LizPack Field goes through its relay, and the list shows « through the relay ».

« Basemaps » opens the « Basemaps » panel: a preview of each basemap, to choose from « Map » (OpenStreetMap), « Satellite », « Topographic », « Light », « Dark », « Streets » or « Humanitarian », or « No basemap » to keep only your layers. The chosen basemap is checked and applies at once; it is part of the styling you can save.

« Legend » shows the symbol and name of each displayed layer, with its group, and recalls the basemap at the bottom of the panel. A hidden layer is not listed. A layer drawn by an attribute (see « Style and labels ») shows the attribute name, then each type or class with its color and number of features; the circles of « Counts and amounts (size) », the ramp of a « Heat map » and the « Group of points (count) » bubble are shown too; with « Hexagons », the statistic of the bins (for example « Points per hexagon ») and their classes, which change with the zoom. A hidden category does not appear. The same legend is used for printing and can be downloaded from « Export » (see « Downloading »).

Choose a layer in « Layers », then click « Properties » in the right-hand bar. The panel gives « Name », « Alias », « Source » (the file or table), « Format », « Geometry », « Features », « Fields and types » (each field with its type read from the values: « Number », « Date », « Yes/No », « Text » or « Empty »; the list is collapsed at first, a click on the number of fields expands or collapses it), « Group » and « Visibility », then actions: « Hide layer », « Zoom to layer », « Open attribute table », « Edit style », « Configure feature details » and « Filter ». Below, « Download » saves the layer and « Symbol » its symbol (see « Downloading »). « Alias » gives the layer a display name, used in the layer list, the legend, the table, the statistics, printing and the shared map; left empty, the layer name is shown. Save the styling to keep it.

1. Choose the layer, then click « Style » in the right-hand bar (or the color symbol on its row).
2. At the top of the panel, choose the « Drawing style » then, if it needs one, the « Attribute » that drives it.
3. Expand the following sections as needed: « Appearance », « Clustering » (point layers), « Labels » and « Visible range ».
4. Settings apply at once to the map and the legend. « Reset style », at the bottom of the panel, returns to the original style.

With « Types (unique values) », choose a « Palette » (several are readable by people with color blindness). Each value is listed with its color and its number of features: a click on the color changes it, the eye hides the value on the map and in the legend. Features without a value form the « No value » row. Under « Advanced options », « Sort by » orders the list by « Count » or « Alphabetical order », and « Categories shown » sets how many values are listed: the rest are grouped in « Other ».

With « Counts and amounts (color) », choose the classification « Method »: « Natural breaks (Jenks) », « Equal intervals », « Quantiles », « Standard deviation » or « Manual ». Set the « Number of classes » and the « Color ramp », which « Reverse the color ramp » flips. « Distribution of values » shows the attribute's histogram and the class breaks. With « Manual », type each break under « Class breaks »; « Add a break » creates one more. « Normalize by », under « Advanced options », divides the attribute by another numeric field, for example a population by an area.

With « Counts and amounts (size) », set « Minimum size » and « Maximum size » (« Minimum width » and « Maximum width » for a line); « Minimum value » and « Maximum value » set the values they match, otherwise those of the data. With « Heat map », set « Weighting », « Radius », « Intensity », « Opacity » and « Color ramp ».

For a point layer, check « Group nearby points » in the « Clustering » section: neighboring points gather into bubbles that show their number. « Clustering radius » sets the grouping distance, « Group up to zoom » the level beyond which each point shows again; « Show the number of points » and « Size by number of points » can be unchecked. A click on a bubble zooms in on it; at the closest zoom, it lists the bubble's features, and a click on one opens its details. Clustering does not apply to a « Heat map ».

1. Choose a point layer, open « Style » and choose « Hexagons » as the « Drawing style »: a grid of hexagons replaces the points.
2. Under « Statistic », keep « Number of points », or choose « Sum », « Average », « Minimum » or « Maximum » and the numeric « Attribute » it applies to.
3. « Bin size »: « Automatic » adapts the grid to the zoom; « In meters » sets the « Bin width (m) ». The size and the number of bins show below.
4. Set the classes as for « Counts and amounts (color) »: « Method », « Number of classes », « Color ramp ». The number shown for each class is a number of bins.
5. Under « Outline and opacity », choose the « Outline » (« White », « Gray », « Teal » or « None »), its « Outline width » and the « Opacity ».

A click on a bin opens its « Hexagon » card: the number of « Points », the chosen statistic and the bin's « Width ». Bins only count the points shown: a filter or the time slider recalculates them. With hexagons, the layer has neither labels nor clustering.

1. In the « Labels » section, under « Text », choose a field, « Text and fields » to compose a text with the fields in curly braces, for example {nom} ({code}), which « Insert a field » adds for you, or « Expression » to calculate the text with the expression language (see « The expression language »), with a « Preview » on the layer's features. « No label » removes them.
2. Set « Text size », « Text color », « Halo color » and « Halo width », then the « Position » relative to the feature.
3. « Shown from zoom » and « Shown up to zoom » limit labels to a range of scales; « Avoid overlaps » drops those that overlap.

The « Visible range » section limits the whole layer to a zoom range: « Visible from zoom » and « Visible up to zoom ». Outside it, the layer disappears from the map. « Visible at all zoom levels » removes the limit.

1. Choose the layer, then click « Filter » in the right-hand bar.
2. Choose a « Field », an « Operator » (equal to, not equal to, contains, greater than, greater than or equal, less than, less than or equal, is empty, is not empty) and, if the operator needs one, a « Value ».
3. The number of features kept is shown before applying. Click « Apply the filter ».
4. The map and the attribute table now only show the features kept; the table says so with « Filtered », the layer row with a funnel. « Remove the filter » brings back every feature.

The filter does not change the data and is not saved: it disappears when the page is reloaded. A filtered layer only downloads the features kept.

« Search » looks for a value in the attributes of the loaded layers: type at least two characters in « Attribute value », and if needed limit the search to one layer instead of « All layers ». Each result gives the layer, the field and the value found; a click zooms to the feature, selects it and opens its details. Only the first 100 results are shown: refine the search if there are more. Address search is not offered.

1. Click « Identify », at the top left of the map (under « Tools » on a phone or tablet): the button stays pressed. Only the layer chosen in « Layers » responds; with no layer chosen, all visible layers do.
2. Click a feature: its details open at the top right of the map (at the bottom of the screen on a phone), a marker shows the point clicked, and the map frames the feature, in the part the card leaves visible, then makes it blink.
3. The details give the layer and the feature's attributes, in the order and under the labels set for the layer (see « Configuring the details »). « Zoom » frames the map on the feature, which blinks on arrival; while the panel is open, the feature stays yellow; « Copy attributes » puts them on the clipboard, ready to paste into a spreadsheet. On a computer, the details move by dragging their header and keep their place from one feature to the next; a double-click on the header puts them back. A value that is a web address opens with a click, even if the address contains spaces.
4. A click on an empty spot or the cross closes the details; choosing « Identify » again in the list leaves the tool.

A photo taken in QField shows in the details and opens full size in a tab; another project file referenced by an attribute (document, sound) downloads with one click. A web address (http or https) becomes a link, in the details as in the attribute table; it opens in a new tab.

1. Choose the layer, then click « Details » in the right-hand bar (or « Configure feature details » in « Properties »).
2. « Details title » chooses the field whose value titles the details; by default, « Layer name ».
3. Under « Displayed fields », each field is listed with its type, like the calculated fields. Uncheck a field to remove it from the details; « Show all » and « Hide all » act on all of them. The arrows change the order of the fields.
4. The pencil of a displayed field unfolds its settings (one at a time): « Displayed label » replaces its name in the details. For a number, choose the number of decimals (« Decimals as stored » by default) and keep or not the « Thousands separator »; for a date, choose « Short date », « Long date », « Date and time » or « Raw value ».
5. « Reset feature details » returns to all the fields, under their names.

The configured details are part of the map styling: save it to find them on your other devices (see « Saving the map styling »). For a PostGIS layer, the correction form keeps the field names and values.

1. In the « Details » panel, under « Calculated fields », click « Add a calculated field ».
2. Give a « Field name », different from the layer's fields, and write the « Expression » (see « The expression language »). « Insert a field » and « Insert a function » write it for you; an error shows at once, with its line and column.
3. The « Preview » shows the result on a feature of the layer; its arrows move to the previous or next feature. Then choose the format of the result, as for a field of the details: decimals, thousands separator or date format.
4. Under « Charts », click « Add a chart »: choose the « Type » (« Columns », « Bars », « Pie » or « Line »), a « Title », the « Numeric fields » to plot, calculated fields included, and keep or not « Show values ».

The details show the calculated fields after the other fields, then the charts. Calculated fields also appear in the attribute table, as read-only columns marked with the Σ icon, and in « Statistics ». A calculated field can reuse those placed before it. Nothing is written to the data: calculated fields are neither in the layer nor in its downloads. 20 calculated fields and 5 charts at most per layer.

Calculated fields, labels in « Expression » and calculated columns of the table are written in LizScript, the expression language of LizPack Field, close to Arcade (ArcGIS). Its full guide has its own chapter, with autocompletion, scripts (variables, conditions, loops), layer aggregates and all the functions: https://field.lizpack.com/documentation/lizscript.

When a project is linked to a PostGIS database (see « The Settings tab »), the layers coming from that database can be corrected straight from the map. With the « Identify » tool, click a feature of a PostGIS layer: the details open read-only, then the « Edit » button turns them into a form where every attribute can be changed. Change the values you want, then click « Save »: the correction is written into the PostGIS database at once and reflected on the map; « Cancel » gives up. Only attributes can be changed: the geometry and the internal identifier (fid) are preserved.

1. Click « Select », at the top left of the map (under « Tools » on a phone or tablet): the « Select » card opens.
2. Choose the shape of the area: « Rectangle » (drag on the map), « Polygon » (one click per vertex), « Circle » (one click at the center, a second one for the radius, shown while drawing) or « Freehand » (drag around the features).
3. For a polygon, close the area with a double-click, a click on the first vertex or « Finish ». « Undo » (or the Backspace key) removes the last vertex; Esc abandons the drawing.
4. Expand « Options » if needed: « Operation » chooses to « Replace » the selection, « Add » features to it or « Remove » them from it; « Layers concerned » limits the selection to « Visible layers » or to the « Chosen layer ».
5. The features kept turn yellow. Their number shows with the map tools, which offer « Zoom » and « Clear ».

A point is kept if it is inside the area, a line or a polygon if it touches it. On the keyboard, Shift adds to the selection and Ctrl (Cmd on a Mac) removes from it, whatever operation is chosen. On a tablet or a phone, each tap places a vertex. The selection shows in the attribute table, and the other way round.

« Table », in the left-hand bar, opens the chosen layer's table under the map; the table icon on a layer row opens that layer's table. Each open table has its tab. The handle at the top sets the table's height (from the keyboard, up and down arrows; a double-click restores the default height), and the map shrinks accordingly. By touch, on a phone or a tablet, grab the grey bar above the table and drag it. « Full screen », at the right of the table bar, stretches it over the whole window; « Exit full screen » or the Esc key puts it back under the map.

« Statistics », under « More actions », replaces the rows with figures, in two views. « By field » gives the figures of a field: choose the field, then the scope, « Rows shown » (the table's filter and search included) or « Selection ». For any field: « Filled in », « Empty » and « Distinct values ». For a number, also: « Sum », « Average », « Median », « Minimum », « Maximum », « Standard deviation » and the « Distribution of values » histogram. For a date: « First date » and « Last date ». For a text, « Most frequent values » gives each value with its number of features; a click on a value selects its features. Calculated fields are offered too, without this selection by value. « Dashboard » gathers the indicators and charts you build for the layer, computed on the rows shown: « Suggest a dashboard » creates one from the layer's fields, « Add an indicator » and « Add a chart » add to it. An indicator computes the « Number of features », a « Sum », an « Average », a « Median », a « Minimum », a « Maximum », the « Distinct values » or the « Share of features (%) », with an optional « Unit », « Decimals » and « Target ». With a target, « Display » shows the progress as a « Progress bar » or a « Gauge »; « Trend » picks a date field and adds under the value its curve by « Period » (the last twelve), with the change on the previous period. A chart (« Columns », « Bars », « Stacked columns », « Pie », « Donut », « Line », « Area », « Histogram », « Table » or « Scatter plot ») groups the features by a field (« Group by », by « Period » for a date), computes a value per group and, as stacked columns, splits each group by a second field (« Split by »). « Table » lists the groups as rows, with their share of the total, or a cross table with « Columns by ». « Scatter plot » places one feature per point along two numeric fields, « Horizontal axis » and « Vertical axis », colored if needed by a third (« Color by »), and gives their correlation. « Add a condition » limits an indicator or a chart to the features meeting all its conditions. A click on an indicator, a bar or a slice selects its features; indicators form a strip at the top, charts a grid below. Drag a card by its handle, or use « Move earlier » and « Move later », to change the order; « Full width » stretches a chart across the whole row. « Colors », in a chart's window, picks its colors among palettes (« Okabe-Ito », colorblind safe, « Dark2 », « Tableau 10 »…) or ramps (« Greens », « Blues », « Viridis »…); « Default » uses the dashboard colors. The pencil edits, the bin removes. On hover, a tooltip gives the value of each bar, slice or point. The dashboard is part of the styling: save it to keep and share it. « Features visible on the map » makes the figures and the dashboard dynamic: only the features visible in the view are counted, and everything is recalculated after each map move. The same dashboard also opens next to the map through « Statistics », in the left-hand bar: choose the « Layer »; the dynamic view is on there by default. With « All layers », an « In view » band opens the panel: one card per layer gives its number of features in the view, out of how many, the share of the layer the view shows as a bar, and its area or length with the share of the total; a click opens the layer's dashboard. With the dynamic view off, the band is called « All features » and counts the whole layer. « Back to rows », in the same place, brings the table back.

1. Click « Distance » or « Area », at the top left of the map (under « Tools » on a phone or tablet).
2. Click the map to place each point; the measurement updates at each point. An area needs at least three vertices.
3. Double-click or click « Finish » to stop drawing.

The length is shown in meters or kilometers; the area in m², hectares or km², with its perimeter. While drawing, « Undo » removes the last point; « Clear » starts the measurement again. The cross on the card leaves the tool.

« Coordinates », at the top left of the map, gives for the point clicked the latitude and longitude in « WGS 84 (latitude, longitude) » and in « Degrees, minutes, seconds », then, if the QGIS project is in another system (for example a UTM zone), the coordinates in that system. The copy button of each row puts it on the clipboard. On a computer, the cursor coordinates are also always shown at the bottom of the map.

The same card offers « Go to »: type a latitude and a longitude in degrees, separated by a comma (for example 14.6937, -17.4441), or, if the project is in a projected system, X and Y in that system, then click « Go »: the map centers on that point. « Cursor coordinates » chooses the format shown at the bottom of the map: « Decimal degrees », « DMS » or, for a projected project, « Project projection ».

« Bookmarks » keeps views of the map. Type a name in « Bookmark name » (optional), then click « Add the current view »; a click on a bookmark brings the map back to that view. Bookmarks are part of the project's map styling: save it to find them on your other devices (see « Saving the map styling »). In read-only mode and on a shared map, they stay in this browser.

1. Click « Sketch » in the left-hand bar: the « Draw on the map » panel opens.
2. Under « Draw », choose « Point », « Line », « Area » or « Text ». A « Sketch » card opens on the map: it lets you change the shape, choose the « Color » (« Petrol », « Green », « Red », « Gray » or « White ») and the « Thickness » (« Thin », « Medium » or « Thick »).
3. For a point, click the map. For a text, type it in « Text to place », then click where you want it.
4. For a line or an area, click to place each vertex: the length, or the area and perimeter, show while you draw. Double-click, press Enter or click « Finish » to end; an area also closes with a click on its first vertex. « Remove » takes off the last vertex, « Cancel drawing » starts again.
5. The card's cross, or Escape when no drawing is in progress, stops drawing.

Sketches are printed with the map and appear in « Map image (high-resolution PNG) ». Like bookmarks, they are part of the project's map styling: save it to find them on your other devices. In read-only mode and on a shared map, they stay in this browser.

1. Click « Analysis » in the left-hand bar: the « Spatial analysis » panel opens on « Buffer ».
2. Under « Around », choose « Selection » (the selected features) or « Chosen layer » (the displayed features of the layer chosen in « Layers »).
3. Type the « Distance », in m or km (100 km maximum), and keep or not « Merge overlapping areas ».
4. Click « Create buffer »: a new layer is added to the map and to the « Layers » panel.

The calculation runs in the browser, on 5,000 features at most. The layers created are listed under « Temporary layers », with four buttons: select the features of the other layers inside the area, zoom, open its table and remove the layer. They disappear when the page is reloaded: to keep a buffer, download it from the menu of its row in « Layers ».

1. In the « Spatial analysis » panel, under « Summarize within areas », choose the « Areas »: a polygon layer, or « Sketches (areas) » for the areas you drew.
2. Choose the « Features to summarize »: another layer, of points, lines or polygons.
3. If needed, check numeric fields under « Field statistics », the « Statistics » you want (« Sum », « Average », « Minimum », « Maximum »), and a field under « Group by ».
4. Click « Summarize »: the progress shows, « Cancel » stops the calculation. A « Summary of … within … » layer is added to the map, colored by the number of features in each area.

Each area receives the « Count » of features inside it (for lines, also their length inside the area; for polygons, the shared area), the requested statistics and, with « Group by », a count per value: 20 values at most, the others gathered in « Count other values ». Only the features shown count, filter and time slider included. 5,000 areas at most. Like a buffer, the result layer is temporary: it is listed under « Temporary layers » and disappears when the page is reloaded; download it to keep it. On a shared map, only the fields left visible by the link are offered and copied.

« Show overview map », among the buttons at the bottom right of the map, opens a small map at a smaller scale where a frame shows the displayed area. It follows each move; a click on it recenters the main map at that spot. The same button, « Hide overview map », closes it. This choice is remembered in this browser.

1. Click « Compare » in the left-hand bar: the « Swipe to compare » panel opens and a divider splits the map in two.
2. Under « Compare », choose « Two basemaps » (one basemap « Left », another « Right ») or « Layers »: for each layer, « Left », « Both » or « Right ».
3. Drag the divider's handle, or reach it with Tab and use the arrows (with Shift, in bigger steps). « Divider » chooses « Vertical » or « Horizontal »; when horizontal, the sides become « Top » and « Bottom ».
4. « Stop comparing », in the panel or under the handle, closes the comparison.

A label at the top of each side recalls what it shows. Both sides follow moves, styles, filters and the time slider. The comparison is not saved: it closes when the page is reloaded.

1. Click « Time » in the left-hand bar: a bar opens at the bottom of the map. The button stays grayed out if no layer has a date field.
2. « Slider settings » chooses the « Layer », the « Time field », the « Display » (« Interval »: a period between two handles; « Instant »: a single step), the « Step », for example « Day » or « Month », and the playback « Speed ».
3. Drag the handles, or use « Previous step » and « Next step ». « Play » runs through the steps in a loop, « Pause » stops it, « Full extent » returns to the whole period.
4. « Turn off the time slider », the cross of the bar, brings back all the features.

The bar gives the period shown and the number of features kept. Only the chosen layer is affected: on the map, in the attribute table, statistics, hexagons, summarize within areas and downloads, it keeps only the features of the period, as with a filter. A field counts as a date when most of its values read as dates. The setting is part of the map styling, except during playback. On a shared map, the slider works without saving anything and only offers the fields left visible.

1. Frame the map on the area to print: the page uses the visible extent.
2. Click « Print » in the left-hand bar, or the printer icon at the top of the page: the « Print the map » panel opens.
3. Type the « Title » (the project name by default), choose the « Format » A4 or A3, the « Orientation » « Landscape » or « Portrait », and check « Include the legend » or not.
4. Click « Download the PDF ».

The page also carries the scale, the north arrow, the date and the basemap attribution. The printed map uses each layer's style, the labels and the sketches; the legend details types, classes and clustering like the « Legend » panel. « High-resolution image (PNG) » saves the same layout as an image, at 200 dots per inch. When checked, the legend is always complete: it spreads over columns, beside the map in landscape or below it in portrait, then continues if needed on « Legend (continued) » pages (stacked under the first one in the PNG image); long names wrap. « Map image (high-resolution PNG) », in « Export », produces this image in A4 landscape with the legend.

Your display settings (styles, labels, layer visibility, basemap, configured details with their calculated fields and charts, bookmarks, sketches, layers added from a URL and the time slider) are kept automatically in this browser. As soon as you change them, the « Save map styling » button appears at the top of the page (on a narrow screen, only its floppy disk icon): it saves them on the server, so you find them again on another device, then shows « Styling saved ». In read-only mode, this button does not appear: the settings stay in this browser. The filter, the swipe comparison and temporary layers are not saved.

« Share », at the top of the page, opens the « Share the map » page: the link, the displayed title, the visible layers and fields, the preview and the embed code. The link carries the styles and the basemap of the map shown; the calculated fields and charts of the saved details are included too, layers added from a URL are not. Everything is described in the « Public sharing » chapter. The button only appears for the project owner and its managers.

On a tablet or a small screen, panels open over the map instead of shrinking it, one at a time, attribute table included. On a phone, opening a panel closes the one that was open, including the attribute table. The table keeps a minimum height so its controls and rows remain visible; drag its top handle to make it taller. The side bars give way to a bar at the bottom of the screen: « Layers », « Legend », « Search », « Table », which opens or closes the attribute table, and « More », which gives access to the other tools (« Basemaps », « Sketch », « Bookmarks », « Analysis », « Compare », « By URL », « Time », « Print », « Properties », « Style », « Filter » and « Details »). Panels then slide up from the bottom of the screen, and the bar at the top of a panel, dragged with a finger, sets its height; a feature's details open at the bottom. At the top, « Share », « Export » and help shrink to their icons; on the map, each tap places a measurement point or a selection vertex. The basemap credits fold under the « i » button, and the page has no footer: the map and its table take the full height.

Hover over « Read only », at the top of the page, to read the details of your role. Correcting PostGIS attributes also depends on the owner's plan and on the rights granted on the project (see « Correcting an attribute (PostGIS layers) »).

1. 1PrepareWeb · QGIS
2. 2SynchronizeQField
3. 3CollectOffline, in the field
4. 4Send backDeltas
5. 5UseMap and table

1. Prepare: in QGIS and on the web, the project is put together (layers, capture forms, files).
2. Synchronize onto mobile: QField downloads the project onto the device, for offline use.
3. Collect in the field: the surveyor captures points, lines, polygons and attributes, even with no network.
4. Send the surveys back: once back in coverage, QField pushes the changes to the platform.
5. Use them: the changes appear in the Changes tab and then, once applied, on the map and in the attribute table.

Every change coming from the field is recorded as a delta: an atomic operation (adding, updating or deleting a feature). That log gives complete traceability (who changed what, and when) before the data is finally applied.

You can filter the log by identifier or by status. The « Apply deltas » button processes the pending changes.

A change marked « Not applied » or « Error » is not replayed automatically. The « Replay failures » button puts those changes back to pending and relaunches their application, which is useful once you have fixed the cause of the failure (an adjustment on the PostGIS side, for instance). Changes already applied are not affected.

The Jobs tab follows the server's background tasks: preparation for QField, reading the project, applying the changes. The list gives the status and the timestamps of each job; the eye-shaped button, or the identifier, opens its page. Layers that could not be packaged are flagged there: they will be missing in the field, even if the job is marked « Finished ».

Each job has its own page, with an address you can share with support. It shows the type of job, its status, its creation, start and end dates, its duration and the QGIS version used. The steps follow in order (starting QGIS, downloading the files, reading the layers, preparing for QField...), each with its state; reading the layers details every layer: geometry, source, coordinate system and validity. As long as the job is pending or running, the page updates itself.

When a job fails, the cause shows at the top of the page and the failed step is marked in red. The full server feedback and the execution log remain available, collapsed, under « Technical detail » and « Log »: « Copy » puts them in the clipboard, « Download » saves them to a file to attach to a support request. « Back to jobs » returns to the list.

LizScript is the expression language of LizPack Field. It computes a value from the attributes of a feature, its geometry and its whole layer: calculated fields of the details, labels, calculated columns of the table. Its syntax is close to Arcade (ArcGIS): a one-line expression works as is, and a short script can declare variables, test conditions and loop over lists.

A number is written 12 or 2.5; a text between double or single quotes, with \n for a line break. true and false are the booleans, null the empty value. A list is written [1, 2, 3]; a date is created with Date, Now or Today, or read from a field.

Sum($layer, "field"), Mean, Average, Median, Min, Max, Stdev and Variance compute a statistic of the field over all loaded features of the layer; Count($layer) counts them. The field name is written in quotes. Empty and non-numeric values are ignored; a calculated field of the details placed earlier in the list is aggregated like a layer field, for example Sum($layer, "double"). The result is computed once for the whole layer, then reused for each feature. On a shared map, only shared features count.

// Share of the total area of the layer, in %
var total = Sum($layer, "area_km2");
Round($feature.area_km2 / total * 100, 1)

To synchronize a project in the field, the QField app (mobile) and QGIS (through the QFieldSync plugin) must point at the LizPack Field server, not at the public QFieldCloud. This is set once only: the address is remembered afterwards.

1. Open QField and go to the QFieldCloud sign-in screen.
2. Double-tap the QFieldCloud logo (the « Nyuki » icon, the little bee): a « server URL » field appears.
3. Enter the address https://field.lizpack.com in that field.
4. Sign in with your LizPack Field credentials. The URL is remembered for the next sessions.

1. Install the QFieldSync plugin in QGIS (Plugins menu, then Manage and Install Plugins).
2. Open the plugin's QFieldCloud connection.
3. Double-click the QFieldCloud logo to bring up the server URL field.
4. Enter https://field.lizpack.com, then sign in with your LizPack Field credentials.

LizPack Field is built for teamwork: sharing projects between several people, grouping them within organizations, and discovering public projects.

An organization gathers users and projects under one entity, with its members (Admin or Member role) and its own quota. The Pro plan allows up to 2 organizations; the free plan allows none. In « Organizations », click « Create an organization », then add members by their username. The owner of an organization can delete it: « Delete the organization » button (trash can) on its row, then confirm; its projects and their data are lost.

The « Community » area shows, read-only, the projects other users have made public: search by name, author or description, sorting by date of change, name or author, with the number of public projects and authors. Your own projects are not listed there.

A project's map can be shared read-only, for anyone to consult without an account, or embedded in another site. The map's « Share » button opens the « Share the map » page: the settings on the left, the public map preview on the right. Only the project owner and its managers can open it; « Back to the map » returns to the map.

The plan determines the storage, the number of projects and collaborators, and access to organizations and advanced features. Everything is managed from « Subscription », which opens four pages: « LizPack Field plans », « My subscription », « Invoices » and « Backups ».

Prices, quotas (storage, projects, collaborators) and any trial period are the ones shown on the « LizPack Field plans » page. The number of projects is enforced at creation: beyond your plan's number, creation is refused, from the browser as well as from QFieldSync or the API. Each plan lists its features there, and « Your plan » marks yours. Prices can be viewed « Monthly » or « Yearly ». Click a plan: the « Summary » shows the plan, the period, the amount and the payment method. Tick the acceptance of the terms of use and the billing policy, then click « Upgrade to Pro ». On a phone or a tablet, only the chosen plan unfolds its features, and the amount, the payment method, the acceptance and the button stay at the bottom of the screen. « I have a license key » activates a plan with a key; for Enterprise, the button is « Contact us ». While your account is on the free plan, a « Upgrade to LizPack Field Pro » banner appears at the top of « My projects »: « See the plans » opens this page. It stays displayed as long as the account has no paid plan. With Pro, it becomes « Upgrade to LizPack Field Enterprise »: « Contact us » opens the help center for a quotation request. It no longer appears with Enterprise.

A Pro subscription paid monthly by card switches to yearly without waiting for the renewal date: click « Switch to yearly » in « My subscription », or in the summary of the plans page. The « Switch to yearly billing » window shows the « Yearly price », the « Credit for the current month », calculated in proportion to the time left, the amount « Due today » and the « New renewal date », one year later. The payment button charges this amount to the card on file; if the payment is declined, nothing changes. The invoice for the payment is added to « Invoices ». A subscription that is not charged automatically (Mobile Money, license key) stays monthly until its renewal date: the year is then paid from the plans page.

« My subscription » shows your subscription and its renewal. « Manage » unfolds its details: « Payment method », « Billing period », the invoice of the « Last payment » and « Change plan ». « Cancel » stops the renewal, after you confirm with your account password: nothing more is charged, the subscription stays active until its renewal date, then the account returns to Free. As long as that date has not passed, « Reactivate » undoes the cancellation. « Invoices » keeps the history of your payments: each invoice can be downloaded as a PDF and carries the billing details from your profile. On an Enterprise instance installed on your premises, these pages are replaced by a message: the license and the billing are handled outside the platform.

« Backups », in « Subscription », opens the « Project backups » page. This paid option is taken for the account: it covers your projects and those of the organizations you own, with the Free and Pro plans. Choose a « Frequency », from « Once a week » to « Every hour », then a « History », the length of time archives are kept. The price follows your plan's maximum storage, whatever the number of projects.

The « Summary », on the right (below on a narrow screen), shows the chosen option. Choose « Monthly » or « Yearly », then « Bank card » or « Mobile Money », tick the acceptance of the terms of use and the billing policy and click the payment button, which shows the amount. The card opens the secure payment page, then brings you back to this page; Mobile Money opens the payment window over the page, in CFA francs, with no automatic renewal. Once the option is paid, « Current option » describes it, with its renewal or end date. Changing it is paid right away, and the time left on the current one is added in days to the new one. Paid by card, the option stops with « Cancel », after confirmation with your account password: the remaining time is refunded to the card. Its invoices are added to « Invoices », with the type « Backups ».

Below the choice of option, « Covered projects » lists your projects with their « Last backup »: each row opens the project's « Backups » tab.

A project page has a « Backups » tab, reserved for the owner of the project or of the organization that owns it. It recalls the current option and offers « Back up now »: at most one backup per period, scheduled or manual; when the period is already covered, the date of the next possible one is shown. Without an option, « Turn on backups » opens the option page; with an option, « Change option » leads there. The « Archives » table gives, for each backup, its date, its origin (« Scheduled », « Manual » or « Before restore »), its size, its number of files and its status; a search field filters the list. A successful archive is downloaded with « Download » or restored with « Restore »; a last backup that failed is started again with « Retry ». The tab updates itself while an operation is in progress.

Keeping surveys confidential, and keeping control of who reaches them, is at the center of how LizPack Field is built.

The « Settings » page gathers the « Profile » (avatar, first name, last name, country, language), « Organizations », « Security » (password and « API tokens »), « Notifications » (preferences not available yet) and « Shared projects » cards. The name and the country are synchronized with your LizPack account, which remains the reference for your identity; the avatar is the one of your Field account. Below the cards, « About » shows the server version and the API address. Each card opens a page with its own address (for example https://field.lizpack.com/settings/security).