<h2>What&#39;s new in v3</h2>
<ul>
<li><p><strong>Padding:</strong> Adjusted to 8px for small text input and 16px for large.</p>
</li>
<li><p><strong>Error state:</strong></p>
<ul>
<li><strong>Error icon:</strong> Moved to be closer to the error message, leaving space for trailing icons such as dropdown.</li>
<li><strong>Error input:</strong> Color changed to text primary color.</li>
</ul>
</li>
<li><p><strong>Input with button:</strong> This combination is now a pattern.</p>
</li>
<li><p><strong>Design tokens:</strong> Provide a unified set of values for key properties, ensuring consistency across components and enabling easier customization. Learn more on the <a href="/getting-started/tokens">tokens page</a> and view the component’s token values in its <a href="?tab=Tokens">tokens tab</a>.</p>
</li>
</ul>
<h2>When to use</h2>
<p>Use a text input to let users enter or edit a single line of text.</p>
<p>Use a text input to:</p>
<ul>
<li>Enter short, free‑form text</li>
<li>Provide information such as names, emails, or codes</li>
</ul>
<p>Text input and text area components are not used for the same purpose. Consider the use case and the expected length of a user’s answer when choosing between them.</p>
<table>
<thead>
<tr>
<th>Component</th>
<th>Use case</th>
</tr>
</thead>
<tbody><tr>
<td>Text input</td>
<td>Use a text input for short, single‑line entries such as names, phone numbers, or email fields.</td>
</tr>
<tr>
<td><a href="/components/text-area/">Text area</a></td>
<td>Use a text area when input may extend beyond one line. The larger field provides space for longer responses and is commonly used for comments, descriptions, or open‑ended questions.</td>
</tr>
</tbody></table>
<h2>Anatomy</h2>
<p>You can find the default text input, the text input with a button, and the password input. Password inputs include a hide/show control and can’t contain a button.</p>
<h3>Default</h3>
<p>Default text input contains a label, modifiers to add placeholder text, an <a href="/foundations/icons/">icon</a>, helper text, and an error state. There is a variant that adds a button for inputs that may require independent entry submissions, such as coupon codes or search fields.</p>
<details data-name='image-block' data-images='[{"alt":"The anatomy of the text input component, labeled 1 through 5.","caption":"The default text input includes five main elements. \n\n1. Label: describes the purpose of the field.\n2. Icon (optional): appears before the text within the input field.\n3. Helper text (optional): informs the user how to format or enter text.\n4. Placeholder text (optional): offers contextual guidance.\n5. Text input: displays input field container.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-anatomy-default.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

<h3>Password input</h3>
<p>Password fields function identically to standards input fields, except for a show/hide control outside the field and not being able to have a button. The control alternately makes the password text visible or obscures it with dots.</p>
<details data-name='image-block' data-images='[{"alt":"The anatomy of the password text input, labeled 1 through 5.","caption":"There are five elements included in the anatomy of the password input:\n\n1. Label: describes the purpose of the field.\n2. Text: the password itself, in this view visible and unobscured.\n3. Helper text: describes the password’s format or guidelines.\n4. Input field: the container for the password field.\n5. Show/Hide control: obscures password or makes password visible. “Show” mode is on.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-anatomy-password.png"},{"alt":"The anatomy of the password text input with &#39;hide&#39; toggled on, which hides the password with dots.","caption":"Password input with “Hide” control on and password obscured with dots. This view emphasizes:\n\n1. Obscured password: dots that hide password text.\n2. Show/Hide control: obscures password or makes password visible. “Hide” mode is on.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-anatomy-password-hidden.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

<h2>Resources</h2>
<details data-name='card-collection' data-cards='[{"image":{"url":"","alt":""},"link":{"label":"Visit NN/g website","path":"https://www.nngroup.com/articles/mobile-input-checklist/","type":"External"},"title":"Checklist for mobile input fields","description":"Read the Nielsen Norman Group&#39;s article on input fields.","icon":"pop-up-arrow-corner"},{"image":{"url":"","alt":""},"link":{"label":"Visit NN/g website","path":"https://www.nngroup.com/articles/error-message-guidelines/","type":"External"},"title":"Error-message guidelines","description":"Read the Nielsen Norman Group&#39;s article on error messages.","icon":"pop-up-arrow-corner"},{"image":{"url":"","alt":""},"link":{"label":"View Chat Toolkit (Restricted)","path":"https://dell.sharepoint.com/sites/AIDesignCoE/SitePages/AI-Chat-Toolkit.aspx","type":"External"},"title":"AI Design COE Chat Toolkit","icon":"sparkles","description":"Enhance AI chatbot interaction, ensuring a seamless experience from welcome message to \"End Chat\"."}]' data-NumberOfColumns='3' data-NumberOfColumnsMedium='2' data-NumberOfColumnsSmall='1' data-hideWidget='false'></details>


figma

Figma UI Kit

dds__icon--metadata

Vanilla

angular

Angular

react

React

## Usage

Text inputs are commonly applied in [forms](/patterns/form/) to collect information from users. They are used to enter names, email address, addresses, passwords, phone numbers, and other types of plain text. It is extremely important for the user experience to correctly format the content and design for text inputs, following the instructions to provide clear labels and explanatory helper text.

The text input’s label should provide a clear, concise description of what you’re asking from the user. It is not recommended that you use placeholder text to provide instructions, examples, or formatting requirements, as it disappears once a user begins typing within the input. Anything considered critical information, or information that would help the user accurately enter a response into the input, should remain visible at all times (read [content guidelines](/components/text-input/?tab=Design#standards)).

It is also necessary to identify which inputs are required and which are optional. Required inputs are those which are mandatory for submission or completion of the form. The recommended method for indicating a required input is to include a red asterisk (Red 700) next to the label. Inputs that are not required should display “(optional)” within their label. Optional inputs are used to gather additional information or preferences, but should be limited to reduce cognitive load. For more information on required and optional fields, read about [visual indicators](/patterns/form/#visual-indicator) in the form pattern.

### Formatting inputs

Text input components can contain masking, which depending upon development or business requirements, will help prevent formatting issues for dates, addresses, currency, phone numbers, and around localization. Applying a mask will add a structure to the text field, like parentheses and hyphens to phone numbers, that will help users add information correctly. Adding a clear helper text together with the mask is always preferred.

#### Email addresses

Fields to enter an email address should appear in contact forms, user registration, subscriptions, or in cases where users might need confirmations or follow ups. Although email fields appear and function identically to default input fields, the ‘input type’ property should be set to ‘email’. This will display the appropriate virtual keyboard on supported devices such as phones and tablets.

#### Phone numbers

For phone number text inputs, there are two general functions that impact design: internationalization and localization. For localized forms with phone numbers, the recommended best practice is to use one field for the entire phone number, along with geolocation and input masking. As the user fills in the field, parentheses and hyphens are applied automatically. In this case, the helper text might say: “Enter a 10-digit phone number” or otherwise show an example of the expected format.

<details data-name='image-block' data-images='[{"alt":"Example of a text input using mask","caption":"Use masking when formatting the text would help users to enter a correctly formatted input and also improve readability.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-usage-phone.png"},{"alt":"Phone number added to the text input","caption":"An example of a phone number added to the input.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-usage-phone-input.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

Depending on localization or internationalization design requirements, product teams can choose whether to implement a separate [select](/components/select/) component for country code selection. If opting to support a separate country code selector, a select menu is required. The country selector will default to the page’s localization and validate against the country’s formatting guidelines. See [accessibility standards](/components/file-input/?tab=Design#standards) for more guidance on phone numbers.

### Manual validation

Use a text input with button for inputs that require independent entry submissions, where adding the information doesn’t automatically trigger an action. Such cases include applying coupon codes during checkout or search fields. Having a button next to the field gives the user a clear action to trigger. A text input with a button requires a text-only or icon-right button to avoid confusion when the warning icon appears in the input field. Display the button and input field flush together, in the same horizontal space.

<details data-name='image-block' data-images='[{"alt":"Example of a text input read only with a coupon code","caption":"Using the apply button, a customer can check if their coupon code is valid before submitting their order.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-usage-apply.png"}]' data-numberofcolumns='1' data-hideWidget='false'></details>

### Providing keys

Read only text inputs are used for auto-generated values, for when the user is not able to change the value for the input. Use a read only text input when providing a token, a product key, account ID, or any value within an application that the user might need to copy and paste it in a different digital environment. Note that unlike inactive inputs, read only inputs are submitted as part of forms even though their inputs cannot be changed (see [behavior and states](/components/text-input/?tab=Design#interaction)).

<details data-name='image-block' data-images='[{"alt":"An example of a read only input providing product keys","caption":"An example of a read only input providing product keys.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-usage-keys.png"}]' data-numberofcolumns='1' data-hideWidget='false'></details>

### Placeholder text

Use placeholder text only with helper text. Placeholder text alone creates accessibility issues because screen readers do not reliably announce it, and it disappears once the user begins typing.

If you use both, make sure they serve different purposes:

* Helper text can give instructions.
* Placeholder text can show a sample format.

### Character counter

Use a character counter for fields with limits. The counter appears above the text area and updates as the user types.

When the limit is exceeded, change the text and counter to the error state (Red 700).

### Required fields

Only mark fields as required when necessary, and reduce visual noise by leaving other fields unmarked.

Introduce forms with a statement such as: “All fields are required unless marked optional.”

Write optional labels as: Label (optional).

## Kinds

### Options

There are two optional additions to the default text input component: buttons and icons. Either of these types can be used to design text, email, password, and phone number inputs.

<details data-name='image-block' data-images='[{"alt":"Text input without button or icon","caption":"Example of a text input without button or icon.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-kinds-no-button.png"},{"alt":"Text input with button","caption":"Example of a text input with button.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-kinds-button.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

<details data-name='image-block' data-images='[{"alt":"Text input with icon","caption":"In the default text input, the icon is placed within the field.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-kinds-field-icon.png"},{"alt":"Text input with a button and an icon-right variant","caption":"In the text input with a button, choose a icon-right variant button, avoiding design conflicts and feedback confusion if the error state is activated and the icon appears on the field.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-kinds-button-icon.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

## Sizes

Text input component is available in two sizes: small or large. 

* **Small:** used with smaller screen sizes or when a compact layout better accommodates the content. The height is 32 pixels.
* **Large:** used with larger grid sizes, layouts that require more space for content, or for users who many need a larger input field. The height is 48 pixels.

Consider the experience as a whole to define the best size for the text input and keep component sizes consistent throughout the pattern. Note that sizes differentiate in their input heights, not width. Width of the component should be determined by the information length users are expected to enter into the field.

<details data-name='image-block' data-images='[{"alt":"Small text input.","caption":"Small text inputs can be used with smaller screen sizes or when a compact layout better accommodates the content. The height of the small text input is 32 pixels.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-sizes-small.png"},{"alt":"Large text input.","caption":"Large text inputs may be used with larger grid sizes, layouts that require more space for content, or for users who many need a larger input field. The height of the large text input is 48 pixels.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-sizes-large.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

## Layout

Text input should be left-aligned (or right-aligned for right-to-left languages) in the experience. This component contains a placeholder inside the field, a label above, and a helper text below it. The error message, when activated, appears in the same placement as the helper text.

### Field input width

The width of the text input helps guide the user’s text entry. It’s generally a good practice to size the field to the entry parameters, determining if the information is short or long. For example, a ZIP code field will be shorter than a street address field. Note that the field input width should match the forms or experience width itself.

<details data-name='image-block' data-images='[{"alt":"Appropriate field input width example","caption":"Appropriate field input width example.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-do.png"},{"alt":"Inappropriate field input width example","caption":"Inappropriate field input width example.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-dont.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

### Specifications

To group or stack text inputs, it is recommended to maintain a spacing of multiples of 4 pixels (read more about the [baseline grid](/foundations/grid/#baseline-grid) on the grid foundations page). To place them correctly, make sure padding is 8 pixels for small sizes and 16 pixels for large sizes inputs.

<details data-name='image-block' data-images='[{"alt":"A group of small text inputs with 8 pixels of padding","caption":"A group of small text inputs with 8 pixels of padding.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-spacing-horizontal-small.png"},{"alt":"A group of large text inputs with 16 pixels of padding","caption":"A group of large text inputs with 16 pixels of padding.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-spacing-horizontal-large.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

<details data-name='image-block' data-images='[{"alt":"A stack of small text inputs with 8 pixels of padding","caption":"A stack of small text inputs with 8 pixels of padding.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-spacing-vertical-small.png"},{"alt":"A stack of large text inputs with 16 pixels of padding","caption":"A stack of large text inputs with 16 pixels of padding.","url":"https://dds.dell.com/site/v3/components/text-input/text-input-layout-spacing-vertical-large.png"}]' data-numberofcolumns='2' data-hideWidget='false'></details>

## Interaction

### Behavior and states

The component will visually reflect the status of the user interaction. Text input communicates six states: rest, hover, focus, inactive, error, and read only. The states are represented by different colors or opacity.

<details data-name='image-block' data-images='[{"alt":"Behaviors and states of text input, displaying Rest, Inactive, Hover, Error, Active/Focus, and read only states.","caption":"","url":"https://dds.dell.com/site/v3/components/text-input/text-input-interaction.png"}]' data-numberofcolumns='1' data-hideWidget='false'></details>

| State     | Behavior                                                                                                                                                                                                                                                                                                          |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rest      | The rest state is the starting or ending state, indicating the text input is empty or filled.                                                                                                                                                                                                                     |
| Hover     | When a user hovers over a selection, a highlight appears, indicating the field is selectable.                                                                                                                                                                                                                     |
| Focus     | A blue outline appears around the text area when a user tabs or uses keyboard controls to navigate selections.                                                                                                                                                                                                    |
| Inactive  | Inactive text inputs should be used rarely and are displayed with 40% opacity, indicating the field exists but is not available to the user. Inactive inputs cannot be marked as required.                                                                                                                        |
| Error     | Errors appear when the input entry, or lack thereof, fails validation. A validation error appears in red text (Red 700) and displays an error icon within the field. Additionally, a red error message appears under the component, describing the error and how to fix it as clearly and succinctly as possible. |
| Read only | Read only text inputs should not be marked as required, as users cannot edit values with them. However, this state should be focusable, given that users can copy the value it if necessary.                                                                                                                      |

### Error state
This component supports two error types: required field errors and character limit errors.

When an error occurs, change the text color to Red 700, show a warning icon with an error message below the input. Do not show helper text and error messages at the same time.

## Standards

### Accessibility

**Make sure all labels are clear, concise, and unique**\
All users should know from the label exactly what information is needed to successfully complete the field.\
WCAG 2.2: [1.3.1 Info and Relationships](https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html)<br></br>\
\
**Avoid using placeholder text for conveying important information**\
Use helper text to relate this information instead, as instructions must be visible at all times. Placeholder text disappears as the user starts typing, requiring them to delete their entered text if they need to refer to that information again.\
WCAG 2.2: [1.3.1 Info and Relationships](https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html), [3.3.2 Labels or Instructions](https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions)<br></br>\
\
**Make sure all helper text and error messages provide meaningful assistance in helping users avoid or fix errors**\
Don’t provide unclear helper text, such as “Enter a valid email address.” Instead, make it clear how a valid email address should be formatted.\
WCAG 2.2: [3.3.2 Labels or Instructions](https://www.w3.org/WAI/WCAG22/Understanding/labels-or-instructions), [3.3.3 Error Suggestion](https://www.w3.org/WAI/WCAG22/Understanding/error-suggestion.html)<br></br>\
\
**Warn users in advance about fields that have masking and autoformatting requirements**\
If a field requires a specific kind of formatting, such as whole numbers, or a limited number of characters, communicate that in advance using helper text.<br></br>

### Content

**North American phone number format**\
For the US, Canada, and other North American Numbering Plan (NANP) countries, use hyphens in phone numbers. Do not use parentheses, periods, or spaces in place of hyphens.\
**Do**: 111-222-3333\
**Don’t**: 111.222.3333<br></br>\
\
**Non-NANP phone number format**\
Include the country and area codes for all non-NANP countries. Use spaces, rather than hyphens, to separate the groups of numbers. Country codes are preceded by a plus sign with no space following it. Note that the quantity of numbers in a phone number can vary depending on the country or region.\
**Do**: +19 777 555 5555\
**Don’t**: +19 (777) 555-5555<br></br>\
\
**Clear and concise labels**\
Every input field should have a label to identify and describe its purpose, providing guidance and assuring readability and accessibility. Label text should be left-aligned (or right-aligned for right-to-left languages) with the input. Write label text in sentence case and be clear, being as succinct as possible.\
**Do**: Email address\
**Don’t**: Email Address\
**Don’t**: Enter your email address<br></br>\
\
**Helper text**\
Helper text is an instructional text that helps the user fill out the relevant field. It usually guides the user to enter data in the appropriate format, providing field explanation, localization assistance, and help prevent errors. Keep the content concise, with as few words as possible to guide users and help them prevent errors. Helper text appears below the text field.\
**Example**: Passwords must be at least 8 characters<br></br>\
\
**Placeholder text**\
Using placeholder text on its own introduces accessibility problems as it’s not read by screen readers. It can be difficult for people to remember the information provided by the placeholder text because it disappears when the user begins entering text. It is recommended that if you plan to use placeholder text, pair it with helper text. When using placeholder text in conjunction with helper text, placeholder text should supplement the information in the helper text rather than replace it.

Design

## Tokens

Component tokens define the visual decisions used by this component. Use these tokens to adjust the component while preserving consistency and accessibility across the system.

The table below lists all tokens consumed by the component, explaining what each token controls, where it applies, and how it can be customized.

For more details about tokens and how they work across the system, see the [tokens documentation](/getting-started/tokens).

| Name                               | Collection | CSS var                                       | Preview  |
| ---------------------------------- | ---------- | --------------------------------------------- | -------- |
| spacing/xs                         | Semantic   | `var(--dds-spacing-xs)`                       | —        |
| label/gap                          | Component  | `var(--dds-label-gap)`                        | —        |
| input/gap/sm                       | Component  | `var(--dds-input-gap-sm)`                     | —        |
| input/padding-horizontal/sm        | Component  | `var(--dds-input-padding-horizontal-sm)`      | —        |
| input/height/sm                    | Component  | `var(--dds-input-height-sm)`                  | —        |
| border/radius/xs                   | Semantic   | `var(--dds-border-radius-xs)`                 | —        |
| border/width/xs                    | Semantic   | `var(--dds-border-width-xs)`                  | —        |
| color/background/SURFACE/neutral   | Semantic   | `var(--dds-color-background-surface-neutral)` | \#FFFFFF |
| color/border/NEUTRAL/pale          | Semantic   | `var(--dds-color-border-neutral-pale)`        | \#C5D4E3 |
| icon/size/xs                       | Component  | `var(--dds-icon-size-xs)`                     | —        |
| color/text/secondary               | Semantic   | `var(--dds-color-text-secondary)`             | \#293B4D |
| color/text/tertiary                | Semantic   | `var(--dds-color-text-tertiary)`              | \#5C6E7E |
| color/border/ERROR/base            | Semantic   | `var(--dds-color-border-error-base)`          | \#8C161F |
| helper-text/gap                    | Component  | `var(--dds-helper-text-gap)`                  | —        |
| helper-text/icon/height            | Internal   | `var(--dds-helper-text-icon-height)`          | —        |
| color/text/ERROR/rest              | Semantic   | `var(--dds-color-text-error-rest)`            | \#BB2A33 |
| input/gap/lg                       | Component  | `var(--dds-input-gap-lg)`                     | —        |
| input/padding-horizontal/lg        | Component  | `var(--dds-input-padding-horizontal-lg)`      | —        |
| input/height/lg                    | Component  | `var(--dds-input-height-lg)`                  | —        |
| icon/size/sm                       | Component  | `var(--dds-icon-size-sm)`                     | —        |
| color/border/BRAND/base            | Semantic   | `var(--dds-color-border-brand-base)`          | \#00468B |
| color/background/SURFACE/inactive  | Semantic   | `var(--dds-color-background-surface-inactive)`| \#E1E1E1 |
| color/border/INACTIVE/base         | Semantic   | `var(--dds-color-border-inactive-base)`       | \#7E7E7E |
| color/text/inactive                | Semantic   | `var(--dds-color-text-inactive)`              | \#B6B6B6 |
| color/background/SURFACE/secondary | Semantic   | `var(--dds-color-background-surface-secondary)` | \#EBF1F6 |
| color/text/primary                 | Semantic   | `var(--dds-color-text-primary)`               | \#1D2C3B |


To see other interactive examples of this component or for additional developer documentation, visit [Storybook](https://vanilla.delldesignsystem.com/?path=/docs/components-text-input--docs)
<details data-name='iframe-doc' data-link='https://vanilla.delldesignsystem.com/iframe.html?args=&id=components-text-input--docs&viewMode=docs&websiteFrame=true' data-hideWidget='false'></details>

Code

To see other interactive examples of this component or for additional developer documentation, visit [Storybook](https://angular.delldesignsystem.com/?path=/docs/components-text-input--docs)
<details data-name='iframe-doc' data-link='https://angular.delldesignsystem.com/iframe.html?args=&id=components-text-input--docs&viewMode=docs&websiteFrame=true' data-hideWidget='false'></details>

To see other interactive examples of this component or for additional developer documentation, visit [Storybook](https://react.delldesignsystem.com/?path=/docs/components-text-input--docs)
<details data-name='iframe-doc' data-link='https://react.delldesignsystem.com/iframe.html?args=&id=components-text-input--docs&viewMode=docs&websiteFrame=true' data-hideWidget='false'></details>

Text input is an interactive field that allows users to enter text and data. It’s commonly used in form patterns.

Text Input