docs/Power features/LimeSurvey
connect your survey tool

LimeSurvey.

Map each Samply parameter under Panel integration, then redirect via the End URL using {PASSTHRU:…}.

1 · Pass the Samply IDs into the survey

"Panel integration" (Survey menu → Panel integration → Add URL parameter), each parameter mapped to a Target question so it is saved into the response and export.

  1. For each Samply parameter, first add a free-text question to hold it — type "Sort text" (Short free text) or "Multiple texts" — with a clear code such as samply_msg; optionally hide it.
  2. Go to Survey menu → Panel integration and click "Add URL parameter".
  3. In "Parameter" type the exact GET key from the start link (e.g. msg), and in "Target question" select the matching free-text question. Repeat per parameter.
  4. Always set a Target question — without one the value lives only in the session and is NOT written to the export.
Example start link
https://<your-limesurvey>/index.php/<surveyID>?msg=%MESSAGE_ID%&pid=%SAMPLY_ID%&code=%PARTICIPANT_CODE%

2 · Register completion

The End URL (Survey text elements) with the {PASSTHRU:msg} placeholder, plus "automatically load the end URL" enabled in Presentation so it redirects on completion.

  1. Make sure %MESSAGE_ID% is defined as a Panel integration parameter (e.g. named msg) so {PASSTHRU:msg} is available.
  2. Survey settings → Text elements → set End URL to: https://samply.uni-konstanz.de/studies/<study-slug>/done/{PASSTHRU:msg}
  3. Survey settings → Presentation → enable automatically loading the End URL on completion, so the participant is redirected (not just shown a link).
  4. Activate and test: {PASSTHRU:msg} resolves to the value LimeSurvey received in the start link.
Example completion redirect
https://samply.uni-konstanz.de/studies/<study-slug>/done/{PASSTHRU:msg}

Reserved parameters & gotchas

Do not reuse LimeSurvey-reserved start-URL keys: sid, lang, token, newtest. Use names like msg, pid, code. {PASSTHRU:name} only works if name was first defined under Panel integration.

Things to watch out for

  • The exact wording of the Presentation toggle that auto-loads the End URL varies across LimeSurvey 3.x/5.x/6.x — confirm it in your installed version.

Sources

These steps were verified against the platform's official documentation.