Study Link Builder

A study link opens the online form. Fill in the required parts, then press "Make the link". The Study Link Builder keeps nothing you type. Opening a study link on either page puts its setup, or its setup file's address, in GitHub Pages' logs. See the online collection tutorial.

Instruments

Choose one to three. The online form gives them one after another, and the responses hold their item columns, in this order. At most one PID-5 form. At most one HiTOP-SR, whole or as a module. How several instruments work.

Study name Written into every saved file and every row. Required.

Where responses go A file goes to the participant's downloads. A Google Sheet, or another web address, gets one JSON row per participant, and a Supabase table one row, a column per item. Set up a sheet or a table.

Participants and recruiting site Not used

Participant Leave it empty for a link shared with many participants. The online form then asks each one for an identifier. Recruiting site A site that passes each participant's identifier in the study link's address. Leave the participant field empty. How each site works.

The online form reads each participant's Prolific ID from the address. Paste the link, placeholders included, as the study URL. If Prolific's URL-parameters option adds them again, it reads the filled ones. The responses gain prolific_study and prolific_session columns.

Paste the link, ending in id=%SURVEY_CODE%, as SONA's Study URL. There, each participant's survey code becomes their identifier. As the "Completion URL", give SONA's client-side URL with {participant} for XXXX. Its credit token is readable in the study link.

The online form reads each participant's Connect ID from the participantId parameter as their identifier. Give the link as the project URL in Connect, and Connect's completion redirect URL as the completion URL.

Item order Not used

Show the items in a random order Each participant sees a new order, in place of a module's printed order. The responses still list the items in the instrument's order, and an item_order column records the order that participant saw.

Consent Not used

Consent text Your consent text, as your review board approved it. The online form shows it as plain text on its own screen before the form, with "I agree" and "I do not agree". Up to 20,000 characters. How it is shown. Declined text Only beside consent text, up to 2,000 characters. Shown after "I do not agree". Left empty: "You chose not to take part.", plus "You can close this page." with no decline URL. A decline sends and saves nothing. Completion URL after a decline Only beside consent text. The https:// address "Yes, I do not agree" leads to. Any {participant} goes after its ? or #. It is empty unless the link or a recruiting site gives it. For Prolific, your no-consent completion URL.

When the participant finishes Not used

Completion URL An https:// address the online form sends the participant to after showing their responses arrived, and links to after a saved file. For Prolific, the study page's completion URL. {participant} after its ? or # becomes the identifier. Completion URLs. Completion URL after a saved file Only beside a completion URL. A file is saved when responses go to a file or a send is not confirmed. The saved-file screen links here. Arrived responses still use the completion URL. For Prolific, your saved-file code's URL.

Your own questions Not used

Questions of your own, asked on a screen before or after the form. Each answer goes in a column named q_ plus the question's name, after the item columns. As many as the setup's size allows. How answers are written.

You can also write the questions in a spreadsheet. "Download a template" saves a CSV file with one example of each type. "Download these questions" saves the questions above.

Load questions from a file A CSV file saved as "CSV UTF-8", one question per row. Its questions replace the questions above. This browser reads the file and sends it nowhere. The file's columns.

Where the setup is kept

The study link can carry the whole setup, or name a JSON file you host, such as a file in a public GitHub repository. A file keeps the link short. How a setup file works.

In the study link In a file I host

Study Link Builder

Your study link