Customization, Branding, and Copy

Learn how to customize the Capture App UI in your Predictive Document Verification (DocV) Native or Web SDK to match your organization’s style and branding.

How it works

RiskOS™ supports two types of configuration for Capture App flows:

1. Flow configuration (per environment)

Create or edit Capture App flows—Document Verification, Secondary Document, Selfie Intelligence, or Selfie Reverification—inside the environment where they will run (Sandbox or Production).

For flow configuration instructions, see Capture App Flow Setup.

2. Customization, Branding, and Copy

Make branding, theme, and copy changes in Sandbox first. Once finalized, publish them and then replicate the same configuration in Production.


Flow configuration (per environment)

To create and deploy a customized Capture App flow, complete the following steps:

📘

Language & document support:

Socure can support additional languages and document formats. If you need something not yet available, contact your Account Manager or Socure Support.


  1. Author your Capture App flow in Sandbox

    In the RiskOS™ Dashboard Sandbox environment:

    1. Go to Settings > DocV App.

    2. Use the Branding, Configuration and Copy tabs to style your flow.

    3. Click Save Draft, then Publish. In the Publish Updates dialog, click Confirm.


    Screenshot showing DocV App settings

  2. Promote your Capture App flow in Production

    To publish your flow to the Production environmen:

    1. Go to Settings > DocV App in the RiskOS™ Dashboard Production environment.

    2. At the bottom right of the screen, you will see there are one or more unpublished changes. Click Publish.




    3. On the Publish Updates dialog, click Confirm to go live.

  3. Create additional flows (optional)

    If you require additional Capture App flows for specific identity verification scenarios, you can create up to 12 flows.


    These flows can be created, published, then passed to the Evaluation API to override the default flow. See Capture App Flow Setup for more details.



Branding options

You can customize the Capture App's logo and branding on the Branding tab. The sections below list the different customization options for the Capture App.


Global Theme Settings

The Global Theme Settings tab allows you to style text and buttons across your Capture App flow.


FieldDescriptionProperties
Font ColorThe color of the font of the text displayed throughout the flow.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
ButtonThe button to start the verification flow and select the ID type.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
  • Font weight: 10 characters max. Must be a number value.
  • Button border radius: 10 characters max. Must be a number value in px or pt.
Secondary ButtonThe button to access on screen help during the image capture process and to retry the image capture.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
  • Font weight: 10 characters max. Must be a number value.
  • Button border radius: 10 characters max. Must be a number value in px or pt.
  • Button border width: 10 characters max. Must be a number value in px or pt.

Custom Fonts

The Custom Fonts tab allows you to upload and apply custom fonts to your Capture App flow. To use a custom font, provide URLs for each desired font weight and format. At least one format per weight is recommended.


Font WeightSupported Formats
300 LightWOFF2, OTF, TTF
400 RegularWOFF2, OTF, TTF
500 MediumWOFF2, OTF, TTF
700 BoldWOFF2, OTF, TTF
800 HeavyWOFF2, OTF, TTF

Splash Screen

The Splash Screen is the first screen the consumer sees when they are redirected to the Capture App flow. Use these settings to update the logo, header text, body text, and button label.


FieldDescriptionProperties
LogoThe logo displayed on the header. Note that the logo size cannot be changed.
  • Image requirements: Image must be on white background. File must be in PNG format. File size must be under 200 KB.
Privacy Notice Setting

The footer text on the Splash screen. Use the toggle switch to show or hide the text.

Toggle show/hide.

Copy

The header and body text displayed on the Splash screen.

  • Header:100 characters max
  • Body: 250 characters max
  • Button: 25 characters max

Handoff (Web SDK)

For DocV Web SDK integrations, the handoff component redirects a consumer from their desktop browser to their mobile device using an SMS or QR code. If the consumer is already on a mobile browser, they will tap an Open button to open the Capture App in a new tab.


The following table lists the text character limits for each field:

FieldDescriptionProperties
Header TextPrimary heading.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
Sub Header TextSupporting heading.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
Body TextDescriptive copy.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.
ButtonHandoff button label.
  • Font size limit: 40px or 30pt max. Value must be px or pt.
  • Color requirements: Accepts hex color codes, RGBA values, or HSLA values.

FieldCharacter LimitCharacter Type
Header100

Text characters may include English letters, numbers, spaces, and the following symbols: * . : , # ? ' % ! .

Sub Header250
Description250
ID Label250
Smartphone Label250

Upload & Status (Web SDK)

For DocV Web SDK integrations, the Upload & Status allows you to configure the text on the handoff component and the SMS text message.


The following tabs list the text character limit for each field:

FieldDescriptionProperties
Header250

Text characters may include English letters, numbers, spaces, and the following symbols: * . : , # ? ' % ! .

Sub Header250
SMS Not Received100
QR Code Description250

Configuration (advanced)

SectionDescription
Progress BarShow/hide a visual progress indicator in the flow.
Redirect SettingsEnter a valid HTTPS URL in the Redirect URL field to redirect a consumer when the document verification flow is completed or cancelled. In the Redirect Delay field, enter an integer between 0 and 10,000 to set the number of milliseconds between when the verification flow is completed or cancelled and when the redirect URL loads.
Custom DomainCustomize the Capture App domain name by entering a valid HTTPS URL in the Capture Host URL field. This will allow you to send traffic to a custom URL domain that is branded for your organization. Note that the Capture App's default domain is verify.socure.comc

Copy

Customize copy for Selected ID Type, Confirmation, and Error messages.

FieldCharacter LimitCharacter Type
Header100

Text characters may include English letters, numbers, spaces, and the following symbols: * . : , # ? ' % ! .