Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Components

Statement of Truth

use: deployed Web
The Statement of Truth allows users to certify that the information they have provided in form is correct and true to the best of their knowledge and belief.

Examples

Default

View va-statement-of-truth in Storybook

With Input Error

View va-statement-of-truth in Storybook

With Custom heading

View va-statement-of-truth in Storybook

With Prefilling

View va-statement-of-truth in Storybook

Usage

When to use Statement of Truth

  • To collect a signature.: This component collects a digital signature from the user to certify their submission. This component is used in the Ask users for a signature pattern.

How this component works

The component works by asking the user to populate the text-input field with their name. That name must match the name entered earlier into the form on a previous step. If the name does not match, an error message is returned.

Behavior

  • When using this pattern, do not add the privacy policy checkbox at the end of the form. The user does not need to check another checkbox for privacy policy.

Placement

  • Place the component underneath the accordions on the review page. Do not hide this component inside an accordion.

Instances of this component in production

Code usage

Content considerations

Error message templates

When a user doesn’t enter the name they entered previously in the form

Your signature must match your first and last name as previously entered.

When a user doesn’t check the checkbox for certification

Must certify by checking box

Component checklist

Web Platform

66%

8 of 12 complete

Maturity

Guidance

Web

Examples, usage, code usage, content considerations, and accessibility considerations are all complete.

Research

Web

VFS team conducted research on this component which is linked from this page.

Stability

Web

Component has been in production for more than 3 months with no significant issues found.

Adoption

Web

Multiple teams have adopted this component.

Accessibility

Accessibility testing

This component has been tested using the VA Accessibility Test Library.

Code assets

Variations

Web

Storybook includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component depicted in all responsive breakpoints.

Interactive states

Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Internationalization

Web

Describes i18n attributes.

Visual assets

Variations

Web

Figma library includes all variations (style, size, orientation, optional iconography, selection, error state, etc.)

Responsive

Web

Component designed to work in all responsive breakpoints.

Interactive states

Web

Includes all interactive states that are applicable (hover, active, focus, keyboard focus, disabled).

Tokens

N/A Web

All design attributes (color, typography, layout, etc.) are available as tokens.

Legend:

  • Complete
  • Incomplete
  • N/A Not applicable

Provide feedback

Share your feedback, report issues, or suggest improvements for the Statement of Truth component. Your input helps us make the design system better for everyone.

Edit this page in GitHub (Permissions required)
Last updated: Apr 22, 2026