Skip to content

Styling a Survey

Accessible Surveys provides a robust styling engine that allows you to customize the look and feel of your survey to match your brand while maintaining strict accessibility standards.

Because respondents can switch between high-contrast, dark, and light modes via the accessibility menu, the styling tools are designed to adapt automatically. This ensures your survey remains beautiful and legible regardless of the active accessibility mode.

Step 1: Navigate to the Style Tab

To access the styling options, you need to open the survey builder's Behavior section.

  1. Go to the Behavior view in the sidebar.
  2. Click the Style tab at the top of the interface.
Navigate to the Style tab
Click the Style tab to access the visual customization tools.

Step 2: Configure Scaling Factors

TIP

Design Standards Default styling tokens respect Material Design 3 specifications. If you choose to deviate from these defaults, ensure you test your design across multiple screen sizes (mobile, tablet, desktop) to maintain a high-quality respondent experience.

The most efficient way to adjust your survey's density and readability is through Scaling Factors. These act as global multipliers for all spacing and typography tokens.

  1. Font Scale (Default: 1): Increase or decrease the size of all text across the survey.
  2. Spacing Scale (Default: 1): Adjust the "breathability" of the layout. Lower values (e.g., 0.8) create a more compact design, while higher values (e.g., 1.2) add more white space.
  3. Small Font Scale (Default: 1): Fine-tune the size of secondary text elements (like helper text and populated labels) independently of the main font scale (e.g., use 1.2 to increase the size of secondary text).
Arrange styling options
Use Scaling Factors for quick, global adjustments to look and feel.

Step 3: Advanced Styling (Optional)

For more granular control, you can enable Advanced Mode in the application settings. This reveals individual tokens for:

  • Margins and Paddings: Fine-tune spacing at the page, section, and field levels.
  • Typography Details: Set specific font sizes for labels, inputs, and options.

Size tokens accept values in px, em, rem, or %. However, typography tokens must use rem units to ensure they scale correctly with accessibility settings.

TIP

Accessibility First When you select a primary color, the platform automatically calculates appropriate contrast ratios for text and backgrounds to ensure compliance with WCAG standards. This means your survey will remain accessible even if respondents switch to dark or high-contrast themes.

Responsive Overrides

You can also provide specific styling overrides for different contexts:

  • Mobile Overrides: Adjust the layout specifically for screens smaller than 600px.
  • One Question At A Time: Customize the appearance when using the focused presentation mode.

How Theming Works

By default, the styles applied to a survey inherit their baseline properties from your overarching Customer Theme. When you adjust styling options here in the survey builder, you are defining survey-specific overrides that take precedence over the customer-wide settings. This hierarchical approach ensures brand consistency by default, while still giving you the flexibility to customize individual surveys as needed.

Previewing Your Styles

Always switch to the Test view to see how your styles look in a real environment. We strongly recommend using the Test view's accessibility menu to preview your survey in Dark Mode and High Contrast Mode to ensure your styling choices work well across all themes.

References

For more detailed technical information on how styling properties are managed and applied behind the scenes, please refer to: