Allowing Users to Opt Out from your Registry

Users can increase their recruitment speed by focusing their efforts on respondents who are interested in participating in research studies. Teams can create and send out an Opt Out survey to allow respondents to self-select whether they want to be contacted for future studies. This allows Ripple users to filter their Registry and studies for more targeted recruitment campaigns. 


This process does not prevent automatically Emails or Texts from going to the respondent, nor does it remove the respondent from the Ripple Registry. Ripple users still need to filter the Registry or Study before sending recruitment campaign messages.

How to Allow Users to Opt Out from your Registry

Part 1: Create a Global Unsubscribe Variable

  1. Go to your Registry or Intake study
  2. Go to the Study Settings (red)
  3. Navigate to the Requirements page (green) opt_out_1_get_to_cvs.jpg
  4. Scroll down and click “Create a new Custom Variable” opt_out_2_create_new_cv.jpg
  5. Keep the Type as a Single Select variable and give your variable a Name
  6. In the “Options” box, type in the options you want respondents to choose from. Make sure to hit Enter between each option 
  7. Hit the “Save” button opt_out_3_make_the_opt_out_cv.jpg
  8. Click on the Global checkbox to make this a global variable opt_out_4_global_cv.jpg

Part 2: Create the Opt Out survey

  1. In the same study’s settings, go to the Survey Creator module (red) and click the “Add New Survey” button (green) opt_out_5_survey_creator.jpg
  2. Give your survey a Survey Name (red)
  3. Toggle “Participant Submissions marked as Global” switch ON (green) opt_out_6_survey_title_and_global_toggle.jpg
  4. Go to the Toolbox and create a Single Input question
  5. Go to the Properties of the question (red)
  6. Make the question Name say “globalId” (green)
  7. Toggle “Is visible?” OFF
  8. In the “Survey variable” dropdown, select “Global ID” (blue) opt_out_7_global_ID_question.jpg
  9. Go to the Toolbox and choose a Radiogroup question type
  10. Go into the Properties of the question
  11. Give your question a Name (red)
  12. Write your question about wanting to opt-out of the registry in the Title (green)
  13. In the “Survey variable” dropdown, select the Opt Out global variable you created (purple) opt_out_8_opt_out_question.jpg
  14. Go into the Properties of the First Name question
  15. Toggle “Is Visible?” OFF opt_out_9_first_and_last_name_invisible.jpg
  16. Repeat steps 14 and 15 to make the Last Name question invisible


    Do not modify the Name of the First Name or Last Name questions!

  17. Save your survey (red)
  18. Copy your survey URL (green) opt_out_10_save_survey_and_URL.jpg


Add your team’s logo, additional instructions, or a customized thank you message to further style and personalize your survey!

Part 3: Add the Opt Out text to your email templates

    1. In the same study’s settings, go to the Email and Text module (red) and click the “Add Template” button (green) opt_out_11_get_to_email.jpg
    2. Fill in the contents of the Email Template. At the end of the Email Message Editor, add a sentence to let respondents know they can opt out of the recruitment registry (red) opt_out_12_email_template_filled.jpg
    3. Highlight the words “click here” (red)
    4. Click on the paper clip icon (green)
    5. Paste your survey’s link in the “Link Target” box (purple)
    6. If you want the Opt Out survey to open up in a new browser window, check the “Open link in new window” box
    7. Click the “Add button” (blue) opt_out_13_add_link.jpg
    8. Uncheck the “Use Editor” box (red)
    9. Find your survey link in the box
    10. Add the following after your survey’s URL but before the quotations: “?globalId={{participant_global_id}}&firstName={{participant_first_name}}&lastName={{participant_last_name}}” (highlighted yellow)


      This part allows users to pre-fill the respondent’s first name, last name, and global ID to make sure the survey is connected to their participant profile card. It is very case-sensitive and must match the question Names from your survey!


    11. Recheck the “Use Editor” box
    12. Click the “Save” button at the bottom of the template


Users can copy and paste this Opt-Out sentence into other email templates as well.

Part 4: Add Respondents who Chose to Opt Out to a “Do Not Contact” Study

  1. Click “Add Study” (red)
  2. Respondents who opt-out will be held in this study. Give your study a name so users understand that they should not contact people in this study. (green)
  3. Click the “Submit” button opt_out_15_new_study.jpg
  4. Go to Registry (red)
  5. Click the “Add filter” button (green) opt_out_16_registry_and_filter.jpg
  6. Set your search criteria (red):
    1. In the top left dropdown, choose your “Custom - Opt-out” variable 
    2. In the top right dropdown, choose the “equal to” operator 
    3. In the bottom dropdown, choose the “yes” option
  7. Click the “Search” button (green) opt_out_17_make_filter_and_search.jpg
  8. Click on the checkbox next to the first participant’s name (red)
  9. When it appears, check the “Select all” checkbox (green)
  10. In the dropdown, choose “Add to Do not contact study” (purple)
  11. Click the “Apply” button (blue) opt_out_17_select_all_and_add_to_study.jpg
  12. Confirm that you want to add participants to the study
  13. If there are multiple pages of participants who meet this criterion, go through each page and repeat steps 8-12

Part 5: Filter your Registry to Find Respondents who Want to Participate in Future Studies

Even though respondents completed the survey to opt-out of future studies, their participant profile card will still exist in the Registry. Users need to filter their Registry to exclude these respondents before starting the recruitment campaign.

  1. Go to Registry
  2. Click the “Add filter” button 
  3. Filter out respondents who are in the Do not contact study (red):
    1. In the top left dropdown, choose “Studies”
    2. In the top right dropdown, choose the “not equal to” operator 
    3. In the bottom dropdown, choose the “Do not contact” option opt_out_19_select_all_and_add_to_study.jpg
  4. If there are additional study criteria, click “Add filter” and add the additional filters
  5. Click “Search”
  6. Add these participant profile cards to your new study
  7. Make sure that you’re periodically checking for new respondents who have chosen to Opt out. As each one comes in, add the respondent to the Do not contact study.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.