Please note that the consent survey building process has changed. This article should only be used for legacy consents, created prior to 22-Dec-2021.
Please refer to Creating a Consent Document and Consent Surveys for the current consent survey building process.
Each project requires a “Consent” survey to be configured before participants can join - this can be used to inform the participant about how their data may be used, assess eligibility, collect initial data, or any other things which you might want the participant to see or do before joining.
Unlike standard surveys, participants are prompted to complete the consent survey when joining a project, and must complete it before joining. For more information on consent, refer to ResearchKit's Informed Consent.
Creating a Consent Survey
Consent surveys can either be created from scratch, same as creating a standard survey, or you can download the Sample Consent from the survey store. To download the survey, click the download icon on the homepage, enter a survey name, and click Import, as shown below.
Using Consent Documents
Once you have downloaded or created your consent survey, you will need to update or add a consent document. A consent document is a multi-part document describing the terms and conditions of your project. Typical sections include:
- Overview
- Data Gathering
- Privacy
- Data Use
- Time Commitment
- Study Survey
- Study Tasks
- Withdrawing
Adding a Consent Document
On the left side of the survey editor, below the list of steps, is a header for consent documents. Select the “+” button next to the header to add a new consent document.
Consent Document Properties
There are global properties to a consent document that you can modify:
| PROPERTY | FUNCTION | EXAMPLES |
|---|---|---|
| Title | The title of the consent document. Displayed at the top of a consent review step. | “Distinguished University: Consent to Participate in mHealth Study” |
| Signature Page Title | The title to be rendered on the signature page of the generated PDF | “Signatures”, “Consent” |
| Signature Page Content | The content to be rendered below the title on the signature page of the generated PDF | “I agree to participate in the mHealth Study” |
Consent Document Sections
A consent document is made up of various sections, accessible via the “Sections” tab when you are editing a consent document.
When adding a new section, you can modify the following properties:
| PROPERTY | FUNCTION | EXAMPLES |
|---|---|---|
| Title | The title of the consent section. Displayed during both visual consent and consent review. | “Overview”, “Data Sharing” |
| Formal Title | An optional formal title that is used in place of the title in the generated PDF | “Overview”, “Data Use and Sharing” |
| Type | The type of the section. Determines the icon which is rendered for the section in the visual consent step. The “Custom” type will display no icon. | Data Gathering, Privacy, Custom |
| Summary | A short summary of the section displayed only during visual consent. | “This study will collect data from Apple Health” |
| Content | The longer HTML content of the section, displayed during visual consent if the participant selects “Learn More”, and during consent review. | “<p>Lorem ipsum dolor sit amet</p>” |
Signatures
To record an electronic signature with a Consent Review step, you must configure a signature for your consent document. These are visible via the “Signatures” tab when editing a consent document.
| PROPERTY | FUNCTION | EXAMPLES |
|---|---|---|
| Identifier | The identifier of the signature. | “PARTICIPANT”, “INVESTIGATOR” |
| Title | The title of the signatory | “Participant”, “Investigator” |
| Requires Name | Whether name entry is required for the Consent Review Step | Yes/No |
| Requires Signature | Whether the participant is required to sign during the Consent Review Step | Yes/No |
| Given Name | A pre-filled given name for the signature | “John” |
| Family Name | A pre-filled family name for the signature | “Doe” |
If you download the Sample Consent survey and update the consent document title or signature identifier, you will need to update the Visual Consent and Consent Review steps to point to the new title and identifier names.
Adding Consent Survey Steps
The consent can contain as many steps as you want. For example, you may add an instruction step or an eligibility question step with validation rules to prevent a participant from joining your project unless they state that they meet the necessary criteria. There are two steps, however, that are specific to consents: the Visual Consent Step and Consent Review Step.
Using the Visual Consent Step
The Visual Consent survey step presents these sections to the user in a nice, graphical manner in accordance with the ResearchKit visual consent model.
To use a Visual Consent step, simply add one to your consent survey and select the consent document it’s associated with.
Using the Consent Review Step
The Consent Review step lets the user review the entire consent document on a single screen and then acknowledge it. It can also be used to capture electronic signatures.
To use a Consent Review step, simply add one to your consent survey and select the consent document it’s associated with. If you want to capture an electronic signature, select one of the consent document’s signatures. You can also configure consent review to require the user to scroll all the way to the bottom before acknowledging.
Although the consent document can have multiple electronic signatures, each consent review step can only capture one.
When using the Consent Review Step, it is necessary to add validation rules using the "Validation" tab. The configuration below prevents users from moving forward if they click "Disagree" to the consent review. 
If you do not add validation rules to this step, participants will be able to enroll even if they disagree to the consent.
Adding the Consent to the Project
Finally, once you have published your consent survey, navigate to the enrollment settings screen and select it as your consent survey. Click Save at the bottom of the settings page to save your changes.