Skip to main content
Version: 11.3.0

Affirm Studio

Affirm Studio is the surface for customizing what the requester and approver see during a HYPR Affirm verification flow. Administrators build per-workflow customization kits that override default content (titles, descriptions, instructions, button labels) and visual styling (typography, button colors, layout). An administrator assigns each kit to verification flows, and the requester and approver see the customizations as soon as they enter the flow.

This page describes what end users see with Affirm Studio customizations: what gets branded, which screens are customizable and which visual properties can change. For the administrator walkthrough on creating kits, see Configuring End User Screen Customizations.

Affirm Studio kit editing session with the Screen Navigator, a preview of the Instructions screen and the Content Editor showing Card Header and Card Footer fields

An Affirm Studio editing session previewing a customized verification screen. The kit's content and styling appear to the requester exactly as they do in the preview.

What End Users See​

When a workflow has an Affirm Studio kit assigned, the customizations appear on its verification screens right away. A requester completing a verification sees the following:

  • The organization's logo and background from Custom Branding, when its Affirm toggle is on
  • Per-step screen content (titles, descriptions, instructions, button labels) replaced with the kit's values where the administrator has overridden them
  • Per-step visual styling (typography, button colors, progress indicators, input fields) replaced with the kit's values where the administrator has configured them

The approver review surface uses the same kit when the approver reviews a verification.

The document and biometric capture screens come from HYPR's document verification provider. A kit changes their fonts and colors but not their wording. For the default text of every Affirm screen, see Requester Screen Text by Step and What the Approver Sees.

Desktop and Mobile​

Affirm verification screens render on desktop and mobile. The Affirm Studio kit applies to both, so the requester sees the same branding, content and styling on any device.

Affirm Studio preview with Desktop selected, showing the Instructions screen in a desktop frame Affirm Studio preview with Mobile selected, showing the same Instructions screen in a phone frame

Desktop and mobile preview of the same customized screen.

Customizable Screens​

A kit can customize the following verification step screens. The requester sees only the screens for steps the workflow includes. A kit can still hold customizations for other steps, which apply if the workflow is updated later to include them.

  • Instructions: gives high-level guidance about what the requester is about to do
  • Consent: presents the terms, privacy and consent text the requester accepts before continuing
  • Login Identifier: collects the username or email that identifies the requester
  • Extended Information: collects additional requester details, such as date of birth
  • Phone Number / Email Verification: covers the Phone Number or Email screen (channel entry) and the OTP screen (one-time passcode verification)
  • Location: collects or confirms location details used in the verification flow
  • Verified Credential: prompts the requester to verify a credential, for example by scanning a QR code with an external wallet such as Microsoft Authenticator, and confirms when the credential is validated
  • Document and Biometric Verification: covers the Identity Verification screen, the Await screen (verification in progress) and the Report Card screen (summary)
  • Photo ID and Liveness Capture: guides the requester through capturing ID images and liveness checks
  • Final Await: tells the requester that the overall verification decision is still pending, then shows the final verification result
  • Approver Attestation: covers the Approver Pre Verify, Approver Attestation Results and Approver Attest screens, which the approver sees when reviewing a verification

What Content Can Be Customized per Screen​

Each screen offers some or all of the content sections in the following table.

ElementWhat it controls
Card Header → TitleMain screen title
Card Header → DescriptionScreen description text
Card Footer → Caption 1Primary footer text
Card Footer → Caption 2Secondary footer text
Button LabelsCustomizable button text for all interactive elements
Error MessagesError text the screen can show
Success MessagesConfirmation text the screen can show
Field Related ContentField text, such as placeholders
Screen Specific ContentOther text that belongs to that screen
Text AssetsLonger text blocks, such as consent language, when the customizable consent screen is enabled for your tenant

An administrator can override any of these in a kit. Elements without an override show the HYPR default text.

What Visual Styling Can Be Customized​

Style customizations apply across all screens in the kit. The following table lists the groups of style controls.

GroupWhat it controls
GeneralLayout-wide options such as full-screen experience and header background color
LogoDimensions used to render the tenant logo in the header and, where applicable, in video experiences
TypographyBody and heading colors and font sizes used across cards, captions, and inline messages
ProgressColors for the progress track and progress indicator at the top of multi-step flows
Primary Button / Secondary Button / Tertiary ButtonBackground, text, hover, focus, border, and disabled-state styles for the main action buttons, secondary actions, and tertiary links or outline buttons
InputBackground, content (text) color, and border settings for text boxes, dropdowns, and other input fields
VideoVisual properties specific to video-based steps, such as logo sizing and heading styles used around live-capture or document-and-video experiences