DatumForms.
Join the panel Sign in Create a survey

DATUMFORMS DOCUMENTATION

Maintain a survey reference list

Update a list used by a questionnaire while keeping existing response history interpretable.

For researchers and administrators

Updated 15 November 2026

On this page

Before you start

Use this task when a questionnaire looks up a maintained list, such as locations, services or reference categories. Choose a stable identity question and a published ordinary collection for the list. Keep the question references used by your integration.

Update the list

  1. Export the current list with response IDs, revisions, identity values and question references.
  2. Prepare the approved incoming CSV. Match numeric question headers to the published list definition.
  3. Use upsert to add or update the supplied identities. Choose replace only when the file is the complete intended active list.
  4. Review the import’s insert, update and removal summary before applying its exact review token.
  5. Check representative lookups in the questionnaire after the import completes. If you created a new list collection, update the restricted lookup key and stable reference after verification.

Check the result

The active lookup resolves to the intended list. Existing survey answers retain the definition and values from their collection round.

Troubleshooting

Correct duplicate identities in the source file before applying. If the list changes after preview, request a fresh review. Keep imported reference coordinates separate from captured device locations.

Next steps

Upload supplementary data, review replacements or automate list imports.

Need help with this task? Contact DatumForms. Include the article URL and the step you reached.

Tracking preferences

Essential functions stay on. Choose whether to allow optional tracking on this website. You can change your choices in the footer at any time.

Read our privacy policy