Skip to main content

Prepare your randomization import file

If your allocation sequence was generated outside Datacapt, by a statistician or a sponsor, you can import it and have Datacapt follow it exactly as provided. Getting the file format right is most of the work.


Import your list

🛠️ Step by step guide

  1. Download the template from the study settings. Always start from this file rather than building your own.

  2. Fill it in from your randomization plan, using Excel, Numbers or Google Sheets.

  3. Upload it back into Datacapt.


What each column expects

Column

Format

Notes

treatment_arm_code

Integer

As defined in your randomization configuration.

center_abbreviation

String

If your abbreviation is a number, check it is still stored as text and has not been converted to an integer.

$VARIABLEXXX

String

Only needed if you stratify by labels. Holds the option labels of your variables, with one column per stratification variable.

$PAYLOAD

String

Optional.

⚠️ Warning: spreadsheet editors change your data without telling you. Excel on the desktop and Numbers on Mac both convert formats automatically, and the classic failure is a center abbreviation such as 01 being silently turned into the number 1.

Check the format of every column against the table above immediately before you save and upload, not when you first fill the file in.


👉🏻 Next step

Did this answer your question?