Template guideUpdated October 14, 2026

eCRF completion guidelines template: what to write and a worked example

Completion guidelines tell site staff exactly how to fill in each form so two coordinators enter the same facts the same way. This guide gives you a structure to copy, field-level wording for a demo study, and a rollout plan that gets the document read.

  • Copy-ready section structure
  • Worked field examples
  • Rollout and version control

Free sandbox · No credit card · 21 CFR Part 11 aligned

Adverse event form with completion note (demo)
Subject 001-0042 · Visit 3 (Week 4)Draft

Adverse event

Adverse event term

AETERM

Diagnosis if known, else the symptom. One event per row.

Headache

Start date

AESTDTC

Partial dates allowed: unknown day as UNK.

12 Mar 2026

Severity

AESEV

Intensity, not seriousness.

MildModerateSevere

Serious

AESER
NoYes
Demo form. The guideline line under each field is what a completion guideline says; here it is shown as a hint.

What to take from this guide

  • What a CCG is: a document, often called CRF completion guidelines or eCRF completion guidelines, that explains how to enter data for each form, field by field, for a specific study.
  • It is not the protocol or the manual: it does not repeat clinical procedures. It resolves how a value is recorded when a site could reasonably do it two ways.
  • Keep it short: write instructions only for fields that cause errors or queries. A 60-page CCG nobody reads helps nobody.
  • Version it: when a form or convention changes, the CCG changes, with a version number and a date, and sites confirm they have the new one.
  • Write it from the queries: the best CCG is updated from what the first ten participants actually produced.

Purpose

Why completion guidelines save more time than they cost

Every free-text field and every judgement call invites inconsistency. Is a "headache" that lasts all week one adverse event or seven? Do you enter a drug by brand or generic name? What does a coordinator record when a participant refuses a blood draw: blank, zero or "not done"? Without a shared convention, each site answers differently, and the data manager discovers it as a flood of queries or, worse, as unusable data at analysis. A completion guideline pays for itself the first time it prevents a query that would have taken three emails to close.

It also helps people who are new. Site staff change, sub-investigators join and coordinators cover each other's leave. A concise guide with examples is faster to learn from than the protocol and the data management plan together. And it supports inspection: it shows that you told sites how data should be recorded and when you changed your mind. The related data management plan template normally references the completion guidelines as one of its controlled documents.

This page is different from guidance on how to design the form itself (how to design an eCRF) and from paper CRF to eCRF conversion. Those are about building the form. The CCG is about using it correctly once it exists.

Template

A copy-ready structure for the document

SectionWhat goes in itLength
1. Document controlStudy ID, protocol version, CCG version and date, author, approver, change historyHalf a page
2. Purpose and how to useWhat the document is for, how it relates to the protocol and the data management plan, who to askA few lines
3. General conventionsDates (format and partial dates), times, units, decimals, "not done" versus "not applicable" versus "unknown", rounding, corrections and reasons for changeOne page
4. Visit and form mapTable of visits and forms, which are repeating, and which are completed by whomOne page
5. Form-by-form instructionsFor each form: purpose, when to complete, field-level notes for fields that need themBulk of document
6. Adverse events and medicationsSeverity versus seriousness, relationship, onset and end conventions, naming drugs, recording changesOne to two pages
7. Queries and correctionsHow queries are raised, how to answer, what a reason for change should say, response timesHalf a page
8. Contacts and appendicesWho to contact, abbreviations, example completed formsAs needed

Keep section 5 to fields that need a rule. Self-evident fields (height, weight) need no entry.

Worked example

Field-level wording for a demo study

These examples are for an invented study, DEMO-WALK-01, a walking programme trial with two sites. They show the tone: direct, one rule per field, an example where it helps. Adapt them to your own protocol and conventions.

General conventions

Dates: enter as day, month, year. If the day is unknown enter UNK, for example UNK Mar 2026; never guess. Not done vs not applicable: if an assessment was planned but not performed, mark "not done" and give the reason; if it did not apply to the participant, mark "not applicable". Never leave a required field blank without one of the two. Corrections: change the value and give a reason for change (for example "transcription error"). Do not overwrite without a reason.

Vital signs form

Blood pressure: enter the second of two seated readings taken after five minutes of rest, in mmHg, to the nearest whole number. If only one reading was taken, enter it and note in the comment. Weight: kilograms, one decimal, without shoes and with light clothing. BMI is calculated automatically; do not enter it.

Adverse events form

Event term: record a diagnosis if known; otherwise the main symptom. One event per row. Severity: intensity (mild, moderate, severe); this is not the same as seriousness. Serious: select Yes only if the event meets a seriousness criterion in the protocol; then notify the sponsor within the protocol timeline and see the adverse event reporting page for how that connects. Changes in severity: follow the protocol convention. Here, record a new row when severity increases.

Concomitant medications form

Name: generic name where known; if only a brand name is known record it as written and the data manager will code it. Dose and unit: as prescribed, not as taken. Start and stop: use UNK for unknown parts of the date; use "ongoing" only if still taken at the visit.

Visit window

If a visit falls outside the window, still enter the data on the visit form and record a protocol deviation; do not alter the date to fit.

Build the forms the guideline describes

Create your forms from templates in the free sandbox, add edit checks for the rules you wrote, and test them before sites do. Free, every feature, no credit card.

Build the forms free

Writing rules

How to write an instruction people will follow

A completion note is a tiny piece of user guidance. Apply the same discipline you would to a label on a medicine pack.

One rule per sentence

Start with the action: "Enter", "Select", "Leave blank", "Do not".

Give an example

Show a correct entry and, for tricky fields, a wrong one.

Say what to do when unknown

Every field that may be unknown needs a convention (UNK, not done, not applicable).

Use the protocol's words

Match terms in the protocol and the form so site staff are not translating.

Do not duplicate the protocol

Point to the section rather than copying. Copies drift out of date.

Back instructions with edit checks

If a rule can be tested (a range, a date order), add an edit check. See edit checks.

Review with a site coordinator

Someone who will use it should read it before it is released.

Rollout

How to get the guidelines to sites and keep them current

  1. 1

    Approve and number the document

    Version 1.0 approved by the data manager and the study lead, linked to a protocol version.

  2. 2

    Release with the forms

    Send the CCG with the blank eCRF PDF export, which prints every approved form empty with a form index and visit-by-form matrix, so sites can read the instruction beside the form.

  3. 3

    Train and record it

    Walk site staff through the key conventions at the initiation visit or a short call. Keep the attendance and the version they received. Add staff to the delegation log.

  4. 4

    File it in the site binder

    Capture is the data system; keep the signed CCG in your investigator site file or study document system, not in the EDC.

  5. 5

    Update from queries

    After the first ten participants, review the most frequent queries and add or sharpen instructions. Issue a new version and ask sites to confirm receipt.

  6. 6

    Align with form changes

    When a protocol amendment changes a form, update the CCG in the same change. See eCRF versioning mid-study.

Where Capture helps

Put the rule where the data is entered

Documents get filed; fields get filled. The most reliable completion guideline is the one built into the form: clear question wording, units, required flags and rules that raise a query the moment a value is wrong.

  • Ten question types plus table sections, with units and precision on numeric fields.
  • Edit checks raise auto-queries with your own message text and priority.
  • Calculated fields fill read-only, so staff do not enter BMI or QTc by hand.
  • Blank eCRF PDF export with cover page, form index and visit-by-form matrix to accompany the guideline.
Capture eCRF builder

Blank eCRF · no subject data

Visit by form matrix

FormSCRD1W2W4W8EOS
DemographicsX
Vital signsXXXXXX
LaboratoryXXX
ECGXX

3. Was the ECG performed?

☐ Yes☐ No

If No, complete question 4.

Protocol CAP-001 · v1.0Page 3 of 24

FAQ

Questions teams ask before they switch

Something not covered here? Ask us directly.

What are eCRF completion guidelines?

A study-specific document that tells site staff how to fill in each form, including conventions for dates, unknown or missing data, units, adverse events and corrections.

Are they required?

GCP expects data to be recorded consistently and accurately; a completion guideline is a common way to achieve that, though the format is yours. Your sponsor or CRO may have an SOP that requires one.

How long should they be?

As short as possible. Cover general conventions and only the fields that cause confusion or queries, with examples.

Does Capture host the completion guidelines?

Capture is the data system, not a document library. Distribute the CCG with the blank eCRF PDF export and file it in your investigator site file.

Who writes and approves them?

Usually the data manager, with input from the study lead and a site coordinator, approved by the data manager and the study lead. Your SOPs define roles.

How are they different from the data management plan?

The data management plan describes the data process for the study team. The completion guidelines are site-facing instructions for entering data.

Build the forms and test the rules free

Free sandbox with every feature. No credit card, and you pay only when you go live with real participants.

Build the forms free