From d9b823977da81fc1db3e329a6d4b204d8735d488 Mon Sep 17 00:00:00 2001 From: Gareth Bowen Date: Tue, 28 Jul 2026 17:11:48 +1200 Subject: [PATCH 1/3] add section for default parameters --- docs/central-submissions.rst | 7 +++++++ docs/web-forms-intro.rst | 1 - 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/central-submissions.rst b/docs/central-submissions.rst index 5c3023084..bf3d1cde6 100644 --- a/docs/central-submissions.rst +++ b/docs/central-submissions.rst @@ -75,6 +75,13 @@ Once a Link is created, it will appear in the table, along with a web address yo You cannot yet edit any of the details of a Public Link. +.. _central-submissions-link-default-parameters: + +Default Parameters +^^^^^^^^^^^^^^^^^^ + +You can add parameters to the public link URL to set values when the form is opened. This can be useful to prefill the form with data that's available on the page where the link is clicked. Parameters must be in the format :code:`d[{xpath}]={value}`, where xpath is the ref of the element you want to set, and value is the string value. For example, :code:`d[/root/name]=odk` will set the string "odk" into the name element. You can set values on multiple elements by including more parameters. + .. _central-submissions-link-revoke: Revoking a Link diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e03afed3a..6580dff71 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -32,7 +32,6 @@ We've extensively tested ODK Web Forms and consider it ready for production use For users who have been using web forms in Central prior to v2026.2.0, here is functionality in Enketo that's coming to Web Forms, in rough order of priority: * One question per page -* Query parameter defaults * Jump to first error * Last-saved * Satellite basemaps From c03390764037944204af1d064a5ac95f320e6489 Mon Sep 17 00:00:00 2001 From: Gareth Bowen Date: Wed, 29 Jul 2026 13:46:58 +1200 Subject: [PATCH 2/3] fix spelling 'mistakes' --- docs/central-submissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/central-submissions.rst b/docs/central-submissions.rst index bf3d1cde6..6921ab4d4 100644 --- a/docs/central-submissions.rst +++ b/docs/central-submissions.rst @@ -80,7 +80,7 @@ You cannot yet edit any of the details of a Public Link. Default Parameters ^^^^^^^^^^^^^^^^^^ -You can add parameters to the public link URL to set values when the form is opened. This can be useful to prefill the form with data that's available on the page where the link is clicked. Parameters must be in the format :code:`d[{xpath}]={value}`, where xpath is the ref of the element you want to set, and value is the string value. For example, :code:`d[/root/name]=odk` will set the string "odk" into the name element. You can set values on multiple elements by including more parameters. +You can add parameters to the public link URL to set values when the form is opened. This can be useful to fill the form with data that's available on the page where the link is clicked. Parameters must be in the format :code:`d[{xpath}]={value}`, where "xpath" is the ref of the element you want to set, and value is the string value. For example, :code:`d[/root/name]=odk` will set the string "odk" into the name element. You can set values on multiple elements by including more parameters. .. _central-submissions-link-revoke: From 31f671d20064b2bf108ad6b88e1d537fa7cb460d Mon Sep 17 00:00:00 2001 From: Gareth Bowen Date: Wed, 29 Jul 2026 15:44:32 +1200 Subject: [PATCH 3/3] one more mistake --- docs/central-submissions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/central-submissions.rst b/docs/central-submissions.rst index 6921ab4d4..3adb2445e 100644 --- a/docs/central-submissions.rst +++ b/docs/central-submissions.rst @@ -80,7 +80,7 @@ You cannot yet edit any of the details of a Public Link. Default Parameters ^^^^^^^^^^^^^^^^^^ -You can add parameters to the public link URL to set values when the form is opened. This can be useful to fill the form with data that's available on the page where the link is clicked. Parameters must be in the format :code:`d[{xpath}]={value}`, where "xpath" is the ref of the element you want to set, and value is the string value. For example, :code:`d[/root/name]=odk` will set the string "odk" into the name element. You can set values on multiple elements by including more parameters. +You can add parameters to the public link URL to set values when the form is opened. This can be useful to fill the form with data that's available on the page where the link is clicked. Parameters must be in the format :code:`d[{XPath}]={value}`, where XPath is the ref of the element you want to set, and value is the string value. For example, :code:`d[/root/name]=odk` will set the string "odk" into the name element. You can set values on multiple elements by including more parameters. .. _central-submissions-link-revoke: