Documentation

Consent Question

Article

Consent Question

When and Why to Use

Use this to ask for explicit consent before continuing with a survey. This is typically placed at the very start of the survey to meet legal or ethical requirements. If the user does not consent, the session ends.

Best for:

  • Complying with data protection laws (GDPR, CCPA)
  • Informing respondents about data usage
  • Making sure participation is voluntary
Chat Experience
  • The consent message is shown with the primary button options: Agree / Disagree.
  • If an image is provided, it's shown above the text.
  • The respondent cannot continue unless they agree.

392d5eda add0 4b07 b2db 1f9903f6cd19

Traditional Experience
  • The layout places the consent text to the right of the image (if space allows).
  • The button focus defaults to "Yes" on remote interfaces.
  • Respondents are terminated immediately if "Disagree" is selected.

abd9ce57 0faf 43e1 9eec 31d01040dad0

Configuration Options
OptionTypeRequiredDefaultDescription
consent_textstringnostandard templateCustom text to override the default MX8 Labs consent wording
topicstringno-Topic used in templated consent text
clientstringno-Client name used in templated consent text
imageMediaItemno-Optional image from the s.media collection
Example Code
s.get_consent()

With custom parameters:

s.get_consent( topic="electric vehicles", client="Acme Motors", image=s.media.client_logo )

With full override:

s.get_consent( consent_text="Before we begin, do you consent to participate in this study about car buying preferences?" )