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
Portrait 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.
Landscape 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.
Configuration Options
Option | Type | Required | Default | Description |
|
| no | standard template | Custom text to override the default MX8 consent wording |
|
| no | - | Topic used in templated consent text |
|
| no | - | Client name used in templated consent text |
|
| no | - | Optional image from the |
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?" )