Skip to content

Edit a survey

Surveys that your organisation owns live in organisation settings. Admins can open that editor from the survey itself, instead of going through Organisation config.

  1. Open Sustainability & Monitoring → Surveys.
  2. Open the survey you want.
  3. Open the Survey config tab. It sits after Planning.

You see the same editor as Organisation config → Surveys for that survey. Change sections, questions or settings, then save.

On General, three switches choose the channel. Each channel has one switch.

  • Active in Field App — collected in the field app. Turn it off to hide the survey from the field app and its review queues.
  • Web — collected through the web survey link. Turn it off to hide the web review queue.
  • Telegram / WhatsApp — farmers answer in Telegram and WhatsApp. This switch appears when the farmer bot is set up.

Active in Dashboard is separate. It only controls whether the survey appears in the dashboard.

In Organisation config → Surveys, every tab of the survey editor has its own link: General, Setup, Sections, Custom Surveys, Scoring, Dashboard, Advanced, Labels, Versions and Raw JSON. Open the tab you mean, then click Copy link (or copy the address bar) and send it. Whoever opens it lands on that survey and that tab, for example straight on its Raw JSON. Raw JSON is shown to organisation superadmins. Anyone else who opens such a link lands on General. On Import Definition, an organisation superadmin can replace an existing survey when the file uses that survey’s name.

The same goes for the Active, Archived and From SDK lists, for the tabs of Organisation config → Services, and for the tabs on the Licensing, Offline Maps and User Organisations configuration pages. The Survey config tab on the survey page does not keep the tab in its link.

When you edit a question:

  • Hint is the short help shown under that question on the web and in WhatsApp. It is not a second question.
  • Saves answer to copies the answer onto the supplier record when the survey is submitted. Choose Survey answer only to keep it as a survey answer. The list only offers fields that match the question type, such as contact first name, contact last name, contact gender, contact phone, contact email, contact date of birth, supplier name, supplier area, plot name, and plot area.
  • On a Yes / No question, Supplier name = contact first + last name (when Yes) names the supplier after the contact when the answer is Yes. Ask the first and last name in the same survey. To ask for a different name when the answer is No, add a supplier name question that depends on this one and is shown only for No. A typed supplier name always wins.

To check every question at once, open the survey’s Questions tab. The Saves answer to column shows where each answer goes: the field it fills, Survey answer only, or Standard field for the survey’s built-in fields such as the location and the plot boundary. The Plot boundary and details section always lists the plot boundary, which is walked, pinned or drawn on a map, followed by any plot questions.

Standard sections (Plots, Personal details, and the others) already have their own fields. Open Manage fields on that section. Each included field has a help line per language.

  • The text is shown under that field in the field app, on the web, and in WhatsApp.
  • Leave it empty to keep the wording the field already has.
  • The survey JSON stores the text under the survey’s labels, and lists the field on that section.

Personal details, Location, Farm details, Plots and Documents can each start with a short intro. Open Manage fields on the section and write the intro at the top, one box per language.

  • In WhatsApp and Telegram, the intro is sent as its own message just before the first question of that section, once per survey.
  • On the web, it is shown at the top of the section.
  • In the field app, it is shown under the step name.
  • Leave every box empty for no intro.
  • The Location section has an Address field for the supplier: how to get there, in the farmer’s own words. It is saved on the supplier and shown on the supplier page.
  • The Plots section has an Address field for each plot: directions or a landmark near the plot. It is saved on the plot and shown on the plot page.
  • Both are off by default, so existing surveys do not change. To use one, tick Address in Manage fields on that section. The farmer can still leave it empty.

The Plots section has two more fields that are off until you tick them in Manage fields:

  • Land ownership - one choice per plot: owned with a title deed, owned without a deed, leased, communal, or borrowed / family land.
  • Certification schemes - every scheme the plot holds, for example Organic, Fairtrade or Rainforest Alliance, or None.

Both are saved on the plot and can be changed later on the plot page. In WhatsApp and Telegram the farmer can answer by name, and can list several certifications separated by commas.

When the Plots section keeps the plot Name field, the bot asks the farmer to name each plot after they finish walking it. When the survey leaves the name out, the bot names plots P1, P2 and so on. The web form does the same for a plot left without a name.

Surveys ask for a Season on their first screen. To stop asking, open the Setup tab and turn off Ask for season. Surveys saved after that have no season, so they don’t appear under a season in season filters and reports. The field app hides the question once phones load the updated organisation settings.

Every survey ends with a Notes question. When the farmer answers it in WhatsApp, Telegram or the web form, the survey review shows the answer under Additional questions, before the plots. Nothing shows there when Notes was left empty.

Remote boundary detection in WhatsApp and Telegram

Section titled “Remote boundary detection in WhatsApp and Telegram”

Turn on Remote boundary detection (chat bot) in the Plots section’s settings to stop asking farmers to walk every corner of a plot.

  • The bot asks whether the plot is bigger than Minimum plot size (ha) (4 ha by default, the EUDR line).
  • Smaller plots: the farmer shares one location pin and the plot is saved as a point.
  • Bigger plots: the farmer shares a pin in the middle of the plot. The bot looks at satellite images and sends back a picture of the boundary it found. The farmer taps Yes, No, fix it (opens a map link with the boundary ready to adjust; the bot carries on when they submit), or Walk the corners.
  • A boundary the farmer accepts is saved with the source Satellite detection. Results below Review below confidence, boundaries the farmer had to fix, and plots where nothing was found are flagged for the office to check.

When a reviewer sends a survey back for changes, the officer fixes it and submits it again. The farmer and inspector signatures from the first submission are kept, so nobody has to go back to the farm to sign again.

  • In the field app, the Complete step shows a note in place of each signature pad that is already signed.
  • The saved survey keeps the original signatures.
  • To ask for new signatures instead, open the Complete section and turn on Ask for signatures again when sent back. It is off by default.

The tab is only there when all of these are true:

  • you are an organisation admin
  • the survey is stored in your organisation (copied or created in Organisation config), not a built-in template

If you do not see Survey config, either this survey is a built-in template, or your role cannot change organisation settings.