1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181
|
---
id: 'Helper text'
section: components
---## Examples
### Helper text on a form
```html
<form class="pf-v6-c-form" novalidate>
<div class="pf-v6-c-form__group">
<div class="pf-v6-c-form__group-label"><label class="pf-v6-c-form__label" for="helper-text-form-name">
<span class="pf-v6-c-form__label-text">Name</span> <span class="pf-v6-c-form__label-required" aria-hidden="true">*</span></label>
</div>
<div class="pf-v6-c-form__group-control">
<span class="pf-v6-c-form-control pf-m-required">
<input
required
type="text"
id="helper-text-form-name"
name="helper-text-form-name"
aria-describedby="helper-text-form-name-helper"
/>
</span>
<div
class="pf-v6-c-form__helper-text"
aria-live="polite"
id="helper-text-form-name-helper"
>
<div class="pf-v6-c-helper-text">
<div class="pf-v6-c-helper-text__item">
<span
class="pf-v6-c-helper-text__item-text"
>This is helper text on a form field.</span>
</div>
</div>
</div>
</div>
</div>
<div class="pf-v6-c-form__group">
<div class="pf-v6-c-form__group-label"><label class="pf-v6-c-form__label" for="helper-text-form-email">
<span class="pf-v6-c-form__label-text">E-mail</span> <span class="pf-v6-c-form__label-required" aria-hidden="true">*</span></label>
</div>
<div class="pf-v6-c-form__group-control">
<span class="pf-v6-c-form-control pf-m-required pf-m-warning">
<input
required
type="text"
id="helper-text-form-email"
name="helper-text-form-email"
aria-describedby="helper-text-form-email-helper"
/>
<span class="pf-v6-c-form-control__utilities">
<span class="pf-v6-c-form-control__icon pf-m-status">
<i class="fas fa-exclamation-triangle" aria-hidden="true"></i>
</span>
</span>
</span>
<div
class="pf-v6-c-form__helper-text"
aria-live="polite"
id="helper-text-form-email-helper"
>
<div class="pf-v6-c-helper-text">
<div class="pf-v6-c-helper-text__item pf-m-warning">
<span class="pf-v6-c-helper-text__item-icon">
<i class="fas fa-fw fa-exclamation-triangle" aria-hidden="true"></i>
</span>
<span class="pf-v6-c-helper-text__item-text">
<span class="pf-v6-screen-reader">Warning:</span>
This is helper text for a warning.
</span>
</div>
</div>
</div>
</div>
</div>
<div class="pf-v6-c-form__group">
<div class="pf-v6-c-form__group-label"><label class="pf-v6-c-form__label" for="helper-text-form-address">
<span class="pf-v6-c-form__label-text">Address</span> <span class="pf-v6-c-form__label-required" aria-hidden="true">*</span></label>
</div>
<div class="pf-v6-c-form__group-control">
<span class="pf-v6-c-form-control pf-m-required pf-m-error">
<input
required
type="text"
id="helper-text-form-address"
name="helper-text-form-address"
aria-invalid="true"
aria-describedby="helper-text-form-address-helper"
/>
<span class="pf-v6-c-form-control__utilities">
<span class="pf-v6-c-form-control__icon pf-m-status">
<i class="fas fa-exclamation-circle" aria-hidden="true"></i>
</span>
</span>
</span>
<div
class="pf-v6-c-form__helper-text"
aria-live="polite"
id="helper-text-form-address-helper"
>
<ul class="pf-v6-c-helper-text" role="list">
<li class="pf-v6-c-helper-text__item pf-m-success pf-m-dynamic">
<span class="pf-v6-c-helper-text__item-icon">
<i class="fas fa-fw fa-check-circle" aria-hidden="true"></i>
</span>
<span class="pf-v6-c-helper-text__item-text">
<span class="pf-v6-screen-reader">Success:</span>
This criteria has been met.
</span>
</li>
<li class="pf-v6-c-helper-text__item pf-m-error pf-m-dynamic">
<span class="pf-v6-c-helper-text__item-icon">
<i class="fas fa-fw fa-exclamation-circle" aria-hidden="true"></i>
</span>
<span class="pf-v6-c-helper-text__item-text">
<span class="pf-v6-screen-reader">Error:</span>
This criteria has not been met.
</span>
</li>
<li class="pf-v6-c-helper-text__item pf-m-success pf-m-dynamic">
<span class="pf-v6-c-helper-text__item-icon">
<i class="fas fa-fw fa-check-circle" aria-hidden="true"></i>
</span>
<span class="pf-v6-c-helper-text__item-text">
<span class="pf-v6-screen-reader">Success:</span>
This criteria has been met.
</span>
</li>
</ul>
</div>
</div>
</div>
<div class="pf-v6-c-form__group">
<div class="pf-v6-c-form__group-label"><label class="pf-v6-c-form__label" for="helper-text-form-comment">
<span class="pf-v6-c-form__label-text">Comment</span></label>
</div>
<div class="pf-v6-c-form__group-control">
<span class="pf-v6-c-form-control pf-m-success">
<input
value="This is a valid comment"
type="text"
id="helper-text-form-comment"
name="helper-text-form-comment"
aria-describedby="helper-text-form-comment-helper"
/>
<span class="pf-v6-c-form-control__utilities">
<span class="pf-v6-c-form-control__icon pf-m-status">
<i class="fas fa-check-circle" aria-hidden="true"></i>
</span>
</span>
</span>
<div
class="pf-v6-c-form__helper-text"
aria-live="polite"
id="helper-text-form-comment-helper"
>
<div class="pf-v6-c-helper-text">
<div class="pf-v6-c-helper-text__item pf-m-success pf-m-dynamic">
<span class="pf-v6-c-helper-text__item-icon">
<i class="fas fa-fw fa-check-circle" aria-hidden="true"></i>
</span>
<span class="pf-v6-c-helper-text__item-text">
<span class="pf-v6-screen-reader">Success:</span>
This is dynamic helper text with an icon showing success.
</span>
</div>
</div>
</div>
</div>
</div>
</form>
```
## Documentation
When adding helper text to a form field, place it within the form helper text element.
|