Skip to main content
Symmetry I-9 supports custom theming for embedded experiences, allowing you to apply your branding to the user interfaces embedded within your platform. Theming applies to both embedded modules included with Symmetry I-9:
  • Employee embedded experience: the interface end users complete to submit Form I-9
  • Administrator embedded experience: the interface you use to review submissions and take action on E-Verify cases
Custom theming enables you to deliver a branded, cohesive experience across these embedded modules while preserving established UI behavior and accessibility standards.

​
Theming scope and inheritance model

Symmetry I-9 supports a two-tier theming model that lets you manage branding at either the account (service provider) level or the employer level.

​
Account-level themes

An account-level theme acts as the default theme for your account.
  • When applied, the theme cascades to all employers under your account
  • Updates and deletions at this level affect all employers
  • Account-level GET operations return the theme from the first available employer domain
Use account-level theming when you want a consistent brand experience across all employers you manage.

​
Employer-level themes

An employer-level theme applies only to a specific employer.
  • Employer-level themes override any account-level theme for that employer
  • Updates affect only the specified employer
  • Other employers continue to use the account-level theme (if present) or their own employer-level theme
Use employer-level theming when you need employer-specific branding.

​
How it works

Custom themes use a JSON configuration format that automatically translates into CSS variables applied globally across all application pages. The system uses nested JSON structures to organize style properties logically, making theme management straightforward and maintainable.
Supported customizationTo ensure usability and visual consistency, only a defined set of styling properties can be modified.Unsupported values may still be processed as CSS variables but do not affect rendered UI elements.

​
Supported elements

Theming allows you to customize specific visual elements across six categories. These settings apply consistently across both embedded experiences.

​
Body text and typography

Controls the default text styling body used throughout the embedded interfaces: Defines how links (link) appear and respond to user interaction:

​
Headings (H1–H6)

Provides consistent styling for all heading levels in the headings object (h1, h2, h3, h4, h5, h6):
Themed heading levels rendered in the embedded experience

​
Alerts & notifications

Customizes alerts and notifications using variant-based styling:
The primary, danger, info, warning, and success alert variants

​
Buttons & interactive elements

Controls the appearance of buttons across variants and states:
Themed button variants and their active states

​
Form controls & inputs

Ensures consistent styling for user input formControl elements: