Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
0b796cd
forms structure
alex-cit May 20, 2025
27638df
restructure forms
alex-cit May 21, 2025
7d0c776
extra variables
alex-cit May 21, 2025
57e04ac
form widgets
alex-cit May 21, 2025
71a8f7c
form widgets
alex-cit May 21, 2025
865bcc5
form widgets
alex-cit May 30, 2025
4f273dd
Merge pull request #626 from MerginMaps/configure-forms-structure-rev…
tomasMizera Jul 22, 2025
085fcea
Merge branch 'main' into forms-refactoring
tomasMizera Oct 3, 2025
9dec11a
sidebar formatting
alex-cit Oct 3, 2025
8e5d63e
sidebar formatting (#690)
tomasMizera Oct 10, 2025
8d56fd5
configure forms overview page
alex-cit Oct 14, 2025
3893d39
remove best-practice, content to overview and project preparation
alex-cit Oct 14, 2025
5b8a6f8
widgets
alex-cit Oct 14, 2025
15c20e4
text
alex-cit Oct 14, 2025
f7e2d85
text
alex-cit Oct 14, 2025
4a14671
date and time
alex-cit Oct 14, 2025
ec76861
numbers
alex-cit Oct 14, 2025
378054d
checkbox
alex-cit Oct 14, 2025
ff8b50d
qr code
alex-cit Oct 14, 2025
8f32c33
value select
alex-cit Oct 14, 2025
a4d1a70
fix missing picture, add gallery to text and date/time
alex-cit Oct 14, 2025
3892205
checks fix
alex-cit Oct 14, 2025
fbbbe2f
checks fix
alex-cit Oct 14, 2025
7cf2fe1
checks fix
alex-cit Oct 14, 2025
8782287
forms widget relations
alex-cit Oct 17, 2025
15b5632
relations cleanup
alex-cit Oct 19, 2025
eb94af6
fix checks
alex-cit Oct 19, 2025
b51162a
Merge pull request #692 from MerginMaps/fr-widgets
tomasMizera Oct 20, 2025
13eea86
forms refactoring - attributes form layout
alex-cit Oct 31, 2025
c882b04
Form widgets - Photos, Info widgets (#696)
alex-cit Nov 7, 2025
0f333bc
forms refactoring - attributes form layout (#697)
tomasMizera Nov 7, 2025
3bf960f
forms refactoring - use cases
alex-cit Oct 31, 2025
2ccabeb
html and text widgets link, possible duplicate content
alex-cit Oct 31, 2025
77c2b61
Forms - first feedback round (#700)
alex-cit Dec 11, 2025
b679043
Merge branch 'main' into forms-refactoring
tomasMizera Dec 11, 2025
c605311
Forms refactoring - fix redirects (#706)
alex-cit Dec 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 19 additions & 13 deletions REDIRECTS
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ https://help.cloudmergin.com/plugin-installation https://merginmaps.com/docs/set
https://help.cloudmergin.com/plugin-logs https://merginmaps.com/docs/misc/troubleshoot/
https://help.cloudmergin.com/plugin-new-project https://merginmaps.com/docs/manage/create-project/
https://help.cloudmergin.com/plugin-sync-project https://merginmaps.com/docs/manage/plugin/
https://help.cloudmergin.com/plugin-variables https://merginmaps.com/docs/layer/plugin-variables/
https://help.cloudmergin.com/plugin-variables https://merginmaps.com/docs/layer/variables/
https://help.cloudmergin.com/project-advanced https://merginmaps.com/docs/manage/project-advanced/
https://help.cloudmergin.com/project-details https://merginmaps.com/docs/manage/project-history/
https://help.cloudmergin.com/quick-start https://merginmaps.com/docs/tutorials/capturing-first-data/
Expand Down Expand Up @@ -62,7 +62,7 @@ https://help.inputapp.io/howto/exif_metadata https://merginmaps.com/docs/layer/e
https://help.inputapp.io/howto/external_gps https://merginmaps.com/docs/field/external_gps/
https://help.inputapp.io/howto/gps_accuracy https://merginmaps.com/docs/field/gps_accuracy/
https://help.inputapp.io/howto/package_qgis_project https://merginmaps.com/docs/manage/create-project/
https://help.inputapp.io/howto/position_variables https://merginmaps.com/docs/layer/position_variables/
https://help.inputapp.io/howto/position_variables https://merginmaps.com/docs/layer/variables/
https://help.inputapp.io/howto/proj https://merginmaps.com/docs/gis/proj/
https://help.inputapp.io/howto/project_config https://merginmaps.com/docs/gis/features/
https://help.inputapp.io/howto/registration https://merginmaps.com/docs/setup/sign-up-to-mergin-maps/
Expand All @@ -75,11 +75,11 @@ https://help.inputapp.io/howto/settingup_background_map https://merginmaps.com/d
https://help.inputapp.io/howto/settingup_background_map_rastertile https://merginmaps.com/docs/gis/settingup_background_map/
https://help.inputapp.io/howto/settingup_background_map_vectortile https://merginmaps.com/docs/gis/settingup_background_map/
https://help.inputapp.io/howto/settingup_forms https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/settingup_forms_cascade https://merginmaps.com/docs/layer/form-configuration/
https://help.inputapp.io/howto/settingup_forms_cascade https://merginmaps.com/docs/layer/value-select/
https://help.inputapp.io/howto/settingup_forms_checkbox https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/settingup_forms_constraints https://merginmaps.com/docs/layer/form-configuration/
https://help.inputapp.io/howto/settingup_forms_constraints https://merginmaps.com/docs/layer//constraints/
https://help.inputapp.io/howto/settingup_forms_datetime https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/settingup_forms_defaults https://merginmaps.com/docs/layer/form-configuration/
https://help.inputapp.io/howto/settingup_forms_defaults https://merginmaps.com/docs/layer/default-values/
https://help.inputapp.io/howto/settingup_forms_layout https://merginmaps.com/docs/layer/form-layout/
https://help.inputapp.io/howto/settingup_forms_number https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/settingup_forms_one-to-many https://merginmaps.com/docs/layer/one-to-n-relations/
Expand All @@ -90,7 +90,7 @@ https://help.inputapp.io/howto/settingup_forms_text https://merginmaps.com/docs/
https://help.inputapp.io/howto/settingup_forms_valuemap https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/settingup_forms_valuerelation https://merginmaps.com/docs/layer/form-widgets/
https://help.inputapp.io/howto/setup_themes https://merginmaps.com/docs/gis/setup_themes/
https://help.inputapp.io/howto/working_with_nonspatial_data https://merginmaps.com/docs/layer/non-spatial-data/
https://help.inputapp.io/howto/working_with_nonspatial_data https://merginmaps.com/docs/layer/overview/
https://help.inputapp.io/input_ui https://merginmaps.com/docs/field/mobile-app-ui/
https://help.inputapp.io/licensing https://merginmaps.com/docs/misc/licensing/
https://help.inputapp.io/privacy N/A -- handled by https://merginmaps.com/privacy-policy/
Expand Down Expand Up @@ -120,7 +120,7 @@ https://merginmaps.com/docs/fieldwork/gps_accuracy/ https://merginmaps.com/docs/
https://merginmaps.com/docs/field/input_features/ https://merginmaps.com/docs/field/mobile-features/
https://merginmaps.com/docs/field/input_ui/ https://merginmaps.com/docs/field/mobile-app-ui/
https://merginmaps.com/docs/gis/enable_browsing/ https://merginmaps.com/docs/gis/search_data/
https://merginmaps.com/docs/howto/attach-multiple-photos-to-features/ https://merginmaps.com/docs/layer/attach-multiple-photos-to-features/
https://merginmaps.com/docs/howto/attach-multiple-photos-to-features/ https://merginmaps.com/docs/layer/photos/#how-to-attach-multiple-photos-to-one-feature/
https://merginmaps.com/docs/howto/contribute/ https://merginmaps.com/docs/misc/get-involved/
https://merginmaps.com/docs/howto/create-an-organization/ https://merginmaps.com/docs/manage/workspaces/
https://merginmaps.com/docs/howto/create-project/ https://merginmaps.com/docs/manage/create-project/
Expand All @@ -140,7 +140,7 @@ https://merginmaps.com/docs/howto/manage/plugin/install/ https://merginmaps.com/
https://merginmaps.com/docs/howto/manage/plugin/plugin-delete-project/ https://merginmaps.com/docs/manage/project-advanced/
https://merginmaps.com/docs/howto/manage/plugin/plugin-new-project/ https://merginmaps.com/docs/manage/create-project/
https://merginmaps.com/docs/howto/manage/plugin/plugin-sync-project/ https://merginmaps.com/docs/manage/plugin/
https://merginmaps.com/docs/howto/manage/plugin/plugin-variables/ https://merginmaps.com/docs/layer/plugin-variables/
https://merginmaps.com/docs/howto/manage/plugin/plugin-variables/ https://merginmaps.com/docs/layer/variables/
https://merginmaps.com/docs/howto/manage/troubleshoot/ https://merginmaps.com/docs/misc/troubleshoot/
https://merginmaps.com/docs/howto/manage/web/dashboard/ https://merginmaps.com/docs/manage/dashboard/
https://merginmaps.com/docs/howto/manage/web/project-advanced/ https://merginmaps.com/docs/manage/project-advanced/
Expand All @@ -151,7 +151,7 @@ https://merginmaps.com/docs/howto/manage/web/web-create-project/ https://merginm
https://merginmaps.com/docs/howto/manage/web/working-with-organisations/ https://merginmaps.com/docs/manage/workspaces/
https://merginmaps.com/docs/howto/mergince/ https://merginmaps.com/docs/server/
https://merginmaps.com/docs/howto/mergin-tour/ https://merginmaps.com/docs/tutorials/creating-a-project-in-qgis/
https://merginmaps.com/docs/howto/position_variables/ https://merginmaps.com/docs/layer/position_variables/
https://merginmaps.com/docs/howto/position_variables/ https://merginmaps.com/docs/layer/variables/
https://merginmaps.com/docs/howto/proj/ https://merginmaps.com/docs/gis/proj/
https://merginmaps.com/docs/howto/project/enable_browsing/ https://merginmaps.com/docs/gis/search_data/
https://merginmaps.com/docs/howto/project/enable_digitising/ https://merginmaps.com/docs/gis/enable_digitising/
Expand All @@ -162,17 +162,23 @@ https://merginmaps.com/docs/howto/project/selective_sync/ https://merginmaps.com
https://merginmaps.com/docs/howto/project/settingup_background_map/ https://merginmaps.com/docs/gis/settingup_background_map/
https://merginmaps.com/docs/howto/project/settingup_forms/ https://merginmaps.com/docs/layer/form-widgets/
https://merginmaps.com/docs/howto/project/settingup_forms_photo/ https://merginmaps.com/docs/layer/photos/
https://merginmaps.com/docs/howto/project/settingup_forms_settings/ https://merginmaps.com/docs/layer/form-configuration/
https://merginmaps.com/docs/howto/project/settingup_forms_settings/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/howto/project/setup_themes/ https://merginmaps.com/docs/gis/setup_themes/
https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/non-spatial-data/
https://merginmaps.com/docs/howto/project/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/howto/quick-start/ https://merginmaps.com/docs/tutorials/capturing-first-data/
https://merginmaps.com/docs/howto/reuse_last_values/ https://merginmaps.com/docs/field/reuse-last-values/
https://merginmaps.com/docs/howto/sign-up-to-mergin-maps/ https://merginmaps.com/docs/setup/sign-up-to-mergin-maps/
https://merginmaps.com/docs/layer/attach-multiple-photos-to-features/ https://merginmaps.com/docs/layer/photos/#how-to-attach-multiple-photos-to-one-feature/
https://merginmaps.com/docs/layer/best-practice/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/layer/exif_metadata/ https://merginmaps.com/docs/layer/exif/
https://merginmaps.com/docs/layer/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/non-spatial-data/
https://merginmaps.com/docs/layer/form-configuration/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/layer/non-spatial-data/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/layer/position_variables/ https://merginmaps.com/docs/layer/variables/
https://merginmaps.com/docs/layer/plugin-variables/ https://merginmaps.com/docs/layer/variables/
https://merginmaps.com/docs/layer/settingup_forms/ https://merginmaps.com/docs/layer/form-widgets/
https://merginmaps.com/docs/layer/settingup_forms_photo/ https://merginmaps.com/docs/layer/photos/
https://merginmaps.com/docs/layer/settingup_forms_settings/ https://merginmaps.com/docs/layer/form-configuration/
https://merginmaps.com/docs/layer/settingup_forms_settings/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/layer/working_with_nonspatial_data/ https://merginmaps.com/docs/layer/overview/
https://merginmaps.com/docs/manage/data_sync/ https://merginmaps.com/docs/manage/plugin/
https://merginmaps.com/docs/manage/project-details/ https://merginmaps.com/docs/manage/project-history/
https://merginmaps.com/docs/manage/plugin-multi-server-use/ https://merginmaps.com/docs/server/plugin-mobile-app/
Expand Down
1 change: 1 addition & 0 deletions scripts/wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@ Geomax
GEOS
GeoPackage
GeoPackages
Geotagging
GeoTIFF
GeoPDF
Gimp
Expand Down
81 changes: 47 additions & 34 deletions src/.vitepress/sidebar/en.js
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,7 @@ export default {
{ text: 'Using Mergin Maps Mobile App', link: '/tutorials/mobile/' },
{ text: 'Further Project Customisation', link: '/tutorials/further-project-customisation/' },
{ text: 'Working Collaboratively', link: '/tutorials/working-collaboratively/' }
]
},
] },
{
text: 'Install & Sign Up', // required
collapsed: true,
Expand All @@ -20,8 +19,7 @@ export default {
{ text: 'How to Sign Up to Mergin Maps', link: '/setup/sign-up-to-mergin-maps/' },
{ text: 'How to Install QGIS', link: '/setup/install-qgis/' },
{ text: 'How to Install Mergin Maps Plugin for QGIS', link: '/setup/install-mergin-maps-plugin-for-qgis/' }
]
},
] },
{
text: 'Manage Account & Project', // required
collapsed: true,
Expand All @@ -43,8 +41,7 @@ export default {
{ text: 'Webmaps', link: '/manage/dashboard-maps/' },
{ text: 'Project History and Versions', link: '/manage/project-history/' },
{ text: 'Selective Synchronisation', link: '/manage/selective_sync/' }
]
},
] },
{
text: 'Setup GIS Project', // required
collapsed: true,
Expand All @@ -59,26 +56,47 @@ export default {
{ text: 'How to Avoid Polygons Overlap', link: '/gis/avoid-overlap/' },
{ text: 'Custom Projections', link: '/gis/proj/' },
{ text: 'Supported Formats', link: '/gis/supported_formats/' }
]
},
] },
{
text: 'Configure Survey Layer', // required
text: 'Configure Forms', // required
collapsed: true,
items: [
{ text: 'Best Practice Tips for Layers and Forms', link: '/layer/best-practice/' },
{ text: 'Setting Up Widgets in Attributes Form', link: '/layer/form-widgets/' },
{ text: 'Attributes Form Configuration', link: '/layer/form-configuration/' },
{ text: 'Attributes Form Layout', link: '/layer/form-layout/' },
{ text: 'Capturing Photos', link: '/layer/photos/' },
{ text: 'How to Attach Multiple Photos to Features', link: '/layer/attach-multiple-photos-to-features/' },
{ text: 'How to Link Multiple Records to One Feature (1-N Relations)', link: '/layer/one-to-n-relations/' },
{ text: 'Exif Metadata', link: '/layer/exif/' },
{ text: 'How to Use Hyperlinks', link: '/layer/external-link/' },
{ text: 'Working with Non-Spatial Tables', link: '/layer/non-spatial-data/' },
{ text: 'Extra Position Variables', link: '/layer/position_variables/' },
{ text: 'Extra QGIS Variables', link: '/layer/plugin-variables/' }
]
},
{ text: 'Overview', link: '/layer/overview/' },
{ text: 'Widgets', link: '/layer/form-widgets/',
items: [
{ text: 'Text', link: '/layer/text/' },
{ text: 'Date and Time', link: '/layer/date-time/' },
{ text: 'Relations', link: '/layer/relations/' },
{ text: 'Numbers', link: '/layer/numbers/' },
{ text: 'Checkbox', link: '/layer/checkbox/' },
{ text: 'QR Code', link: '/layer/qr-code/' },
{ text: 'Selecting Single or Multiple Values', link: '/layer/value-select/' },
{ text: 'Photos', link: '/layer/photos/' },
{ text: 'Informational Widgets', link: '/layer/info-widgets/' },
] },
{ text: 'Default Values', link: '/layer/default-values/',
collapsed: true,
items: [
{ text: 'Geotagging', link: '/layer/exif/' },
{ text: 'Variables', link: '/layer/variables/' }
] },
{ text: 'Constraints', link: '/layer/constraints/' },
{ text: 'Layout', link: '/layer/form-layout/',
collapsed: true,
items: [
{ text: 'Tabs and Groups', link: '/layer/tabs-and-groups/' },
{ text: 'Conditional Visibility', link: '/layer/conditional-visibility/' },
] },
{ text: 'Use Cases', link: '/layer/use-cases/',
collapsed: true,
items: [
{ text: 'How to Open a File', link: '/layer/open-file/' },
{ text: 'How to Use Hyperlinks', link: '/layer/external-link/' },
{ text: 'How to Open a Link to a Navigation App', link: '/layer/link-to-navigation/' },
{ text: 'How to Link Multiple Records to One Feature (1-N Relations)', link: '/layer/one-to-n-relations/' },
{ text: 'How to Embed an Image', link: '/layer/embed-image/' },
] },
] },
{
text: 'Fieldwork Tips', // required
collapsed: true,
Expand All @@ -97,8 +115,7 @@ export default {
{ text: 'How to Reuse Last Entered Values', link: '/field/reuse-last-values/' },
{ text: 'How to Stake Out Points', link: '/field/stake-out/' },
{ text: 'How to Fix a Broken Project', link: '/field/broken-project/' }
]
},
] },
{
text: 'For Developers', // required
collapsed: true,
Expand All @@ -110,8 +127,7 @@ export default {
{ text: 'Media Sync', link: '/dev/media-sync/' },
{ text: 'Work Packages', link: '/dev/work-packages/' },
{ text: 'Geodiff Library', link: '/dev/geodiff/' }
]
},
] },
{
text: 'Custom Server', // required
collapsed: true,
Expand All @@ -125,17 +141,15 @@ export default {
{ text: 'Administration Panel', link: '/server/dashboard/' },
{ text: 'Troubleshoot Custom Servers', link: '/server/troubleshoot/' },
{ text: 'Using Mergin Maps Mobile App and QGIS Plugin with a Custom Server', link: '/server/plugin-mobile-app/' }
]
},
] },
{
text: 'Migrate to Mergin Maps', // required
collapsed: true,
items: [
{ text: 'Migrate from QField', link: '/migrate/qfield/' },
{ text: 'Migrate from ArcGIS', link: '/migrate/arcgis/' },
{ text: 'Migrate from FulcrumApp', link: '/migrate/fulcrumapp/' },
]
},
] },
{
text: 'Support & Legal', // required
collapsed: true,
Expand All @@ -145,9 +159,8 @@ export default {
{ text: 'Troubleshoot', link: '/misc/troubleshoot/',
collapsed:true,
items: [
{ text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' },
]
},
{ text: 'Project fails to sync', link: '/misc/troubleshoot/not_syncing/' },
] },
{ text: 'Write Documentation', link: '/misc/write-docs/' }
]
}
Expand Down
4 changes: 2 additions & 2 deletions src/field/external_gps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: External GPS receivers can be connected to your mobile device via B

External GPS receivers can be connected to your mobile device via Bluetooth and used in <MobileAppName /> to achieve higher [GPS accuracy](../gps_accuracy/).

There are several [extra position variables](../../layer/position_variables/) that can be useful to record when doing the survey with external GPS, such as the GPS antenna height, GPS device name as well as metrics like horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).
There are several [extra position variables](../../layer/variables/#position-variables) that can be useful to record when doing the survey with external GPS, such as the GPS antenna height, GPS device name as well as metrics like horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).

Note that external GPS devices usually return orthometric heights (ellipsoid with the geoid separation applied).

Expand All @@ -33,7 +33,7 @@ If GPS antenna height is set to a non-zero value, it is also displayed next to t
![GPS antenna height setup in Mergin Maps mobile app](./mobile-app-gps-antenna-height.jpg "GPS antenna height setup in Mergin Maps mobile app")

:::tip
GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/position_variables/) `@position_gps_antenna_height` as a [default value](../../layer/form-configuration/#default-values).
GPS antenna height can be recorded during the survey by using the [extra position variable](../../layer/variables/#position-variables) `@position_gps_antenna_height` as a [default value](../../layer/default-values/).
:::

## External GPS on Android
Expand Down
2 changes: 1 addition & 1 deletion src/field/gps_accuracy/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Tapping the GPS button opens the [GPS info panel](../mobile-app-ui/#current-posi

If you'd like to have higher accuracy, you can wait for your device to acquire a better GPS signal. For precise measurements, you may need to connect your device to an [external GPS](../external_gps/).

When assessing the overall quality of the survey, it may be beneficial to record some [extra position variables](../../layer/position_variables/), such as type and name of the used GPS device, the horizontal and vertical accuracy or the horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).
When assessing the overall quality of the survey, it may be beneficial to record some [position variables](../../layer/variables/#position-variables), such as type and name of the used GPS device, the horizontal and vertical accuracy or the horizontal, vertical or position dilution of precision (HDOP, VDOP, PDOP).


:::tip
Expand Down
2 changes: 1 addition & 1 deletion src/field/layers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ The **Layers** button is located in the bottom navigation panel.

It provides the overview of layers and features in your <MainPlatformNameLink /> project in <MobileAppName />, as well as the option to turn the visibility of specific layers on/off or to see a layer's legend.

![Layers in Mergin Maps mobile app](../../layer/non-spatial-data/mobile-app-non-spatial-layers.jpg "Layers in Mergin Maps mobile app")
![Layers in Mergin Maps mobile app](./mobile-app-non-spatial-layers.jpg "Layers in Mergin Maps mobile app")

## Layers visibility

Expand Down
Loading
Loading