---
title: "Secret Form Field Widget"
slug: "secret-form-field-widget"
updated: 2026-04-16T21:06:33Z
published: 2026-04-16T21:06:33Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.technolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Secret Form Field Widget

The **Secret** form field widget lets users enter sensitive data, like a Student ID Number (but not a Social Security Number—[see below](/v1/docs/secret-form-field-widget#the-secret-form-field-is-not-the-same-as-the-ssn-field)), on a form and ensure the values are hidden.

[![Secret_Widget.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15713176476059.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15713176476059.png)

## Adding the Secret widget to a form

To use the Secret form field widget:

1. Select **Forms** from the main navigation.
2. Select a form you'd like to edit, or click **New Form**.
3. Click **Edit Form.**
4. Select the **Secret widget.**
5. Configure the field as desired.
  - **Label:**Add a descriptive label for the form submitter.
  - **System Field:**Map the secret to an existing system field.
  - **Masking Character:**Enter the character that will replace the text entered by the submitter.
  - **Show Last # Characters**: Enter a number. This represents the number of characters, counting back from the end of the string, that will be unmasked.

[![Secret_Form_Field_Widget.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15712950017051.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15712950017051.png)

1. Test the form. The submitted string in this example should display asterisks until the final two characters, which are unmasked:

[![Secret_Data___Masked_Form_Submission_Data.png](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15713303508763.png)](https://cdn.us.document360.io/cd8ea7a6-07f3-4846-a554-627ac016d3e3/Images/Documentation/15713303508763.png)

## The Secret form field is not the same as the SSN field

The Secret form field is distinct from the SSN field, which requires the [exclusive permission SSN Unmask](/docs/exclusive-permissions#ssn-unmask) to access unmasked in queries and on the person record.

The **Record → SSN** field does not adhere to the masking settings set on a Secret Form Field Widget.

While SSN data are saved upon submission, the form response will not render the SSN value (masked or otherwise) when viewed

- on the Timeline
- in the Form Registration list
- when editing existing form responses for which a value was submitted