Skip to content

Text fields ​

Text fields let users enter text into a UI. They typically appear in forms and dialogs.

Overview · Specs · Guidelines · Accessibility

Tokens & specs ​

Browse the component elements, attributes, tokens, and their values. Learn about design tokens

Design tokens

Token table

Machine-readable relationship table

Text fields tokens · 2 token sets · 173 tokens · live token table · DSDB TOKEN_TABLE.60990dd98dea0998

  • Default context: Theme: Light · Platform: Android · Audience: 3P · Font: Static · Contrast: Default · iOS dark theme elevation: None · iOS weight setting: Default
  • Not configurable here (group default used): Motion scheme: Standard · Language height: Small
  • Other contexts: Theme: Dark · Contrast: Medium contrast, High contrast. "Other contexts" lists values that differ from the default when only that one context changes.
  • Reference chain: aliases from the token to its source value (token → alias → … → value). "—" means the token holds a literal value.

Text field - Filled · md.comp.filled-text-field · 89 tokens

For filled text fields.

GroupTokenTypeReference chainResolved valueOther contexts
Enabled › Containermd.comp.filled-text-field.container.colorColormd.sys.color.surface-container-highest → md.ref.palette.neutral90#E6E0E9Dark: #36343B via md.ref.palette.neutral22
Enabled › Containermd.comp.filled-text-field.container.height (deprecated)Length—56dp—
Enabled › Containermd.comp.filled-text-field.container.shapeShapemd.sys.shape.corner.extra-small.topRounded corners: top-left 4dp, top-right 4dp—
Enabled › Label textmd.comp.filled-text-field.label-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Label textmd.comp.filled-text-field.label-text.fontFont namesmd.sys.typescale.body-large.font → md.ref.typeface.plainRoboto—
Enabled › Label textmd.comp.filled-text-field.label-text.line-heightLine heightmd.sys.typescale.body-large.line-height24pt—
Enabled › Label textmd.comp.filled-text-field.label-text.sizeFont sizemd.sys.typescale.body-large.size16pt—
Enabled › Label textmd.comp.filled-text-field.label-text.weightFont weightmd.sys.typescale.body-large.weight → md.ref.typeface.weight-regular400—
Enabled › Label textmd.comp.filled-text-field.label-text.trackingFont trackingmd.sys.typescale.body-large.tracking0.5pt—
Enabled › Label textmd.comp.filled-text-field.label-text.typeTypographycomposite
font names: md.comp.filled-text-field.label-text.font → md.sys.typescale.body-large.font → md.ref.typeface.plain
font weight: md.comp.filled-text-field.label-text.weight → md.sys.typescale.body-large.weight → md.ref.typeface.weight-regular
font size: md.comp.filled-text-field.label-text.size → md.sys.typescale.body-large.size
line height: md.comp.filled-text-field.label-text.line-height → md.sys.typescale.body-large.line-height
font tracking: md.comp.filled-text-field.label-text.tracking → md.sys.typescale.body-large.tracking
Roboto · weight 400 · size 16pt · line height 24pt · tracking 0.5pt—
Enabled › Label textmd.comp.filled-text-field.label-text.populated.line-heightLine heightmd.sys.typescale.body-small.line-height16pt—
Enabled › Label textmd.comp.filled-text-field.label-text.populated.sizeFont sizemd.sys.typescale.body-small.size12pt—
Enabled › Leading iconmd.comp.filled-text-field.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Leading iconmd.comp.filled-text-field.leading-icon.sizeLength—24dp—
Enabled › Trailing iconmd.comp.filled-text-field.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Trailing iconmd.comp.filled-text-field.trailing-icon.sizeLength—24dp—
Enabled › Active indicatormd.comp.filled-text-field.active-indicator.heightLength—1dp—
Enabled › Active indicatormd.comp.filled-text-field.active-indicator.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.fontFont namesmd.sys.typescale.body-small.font → md.ref.typeface.plainRoboto—
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.line-heightLine heightmd.sys.typescale.body-small.line-height16pt—
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.sizeFont sizemd.sys.typescale.body-small.size12pt—
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.weightFont weightmd.sys.typescale.body-small.weight → md.ref.typeface.weight-regular400—
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.trackingFont trackingmd.sys.typescale.body-small.tracking0.4pt—
Enabled › Supporting textmd.comp.filled-text-field.supporting-text.typeTypographycomposite
font names: md.comp.filled-text-field.supporting-text.font → md.sys.typescale.body-small.font → md.ref.typeface.plain
font weight: md.comp.filled-text-field.supporting-text.weight → md.sys.typescale.body-small.weight → md.ref.typeface.weight-regular
font size: md.comp.filled-text-field.supporting-text.size → md.sys.typescale.body-small.size
line height: md.comp.filled-text-field.supporting-text.line-height → md.sys.typescale.body-small.line-height
font tracking: md.comp.filled-text-field.supporting-text.tracking → md.sys.typescale.body-small.tracking
Roboto · weight 400 · size 12pt · line height 16pt · tracking 0.4pt—
Enabled › Input textmd.comp.filled-text-field.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Enabled › Input textmd.comp.filled-text-field.input-text.fontFont namesmd.sys.typescale.body-large.font → md.ref.typeface.plainRoboto—
Enabled › Input textmd.comp.filled-text-field.input-text.line-heightLine heightmd.sys.typescale.body-large.line-height24pt—
Enabled › Input textmd.comp.filled-text-field.input-text.sizeFont sizemd.sys.typescale.body-large.size16pt—
Enabled › Input textmd.comp.filled-text-field.input-text.weightFont weightmd.sys.typescale.body-large.weight → md.ref.typeface.weight-regular400—
Enabled › Input textmd.comp.filled-text-field.input-text.trackingFont trackingmd.sys.typescale.body-large.tracking0.5pt—
Enabled › Input textmd.comp.filled-text-field.input-text.typeTypographycomposite
font names: md.comp.filled-text-field.input-text.font → md.sys.typescale.body-large.font → md.ref.typeface.plain
font weight: md.comp.filled-text-field.input-text.weight → md.sys.typescale.body-large.weight → md.ref.typeface.weight-regular
font size: md.comp.filled-text-field.input-text.size → md.sys.typescale.body-large.size
line height: md.comp.filled-text-field.input-text.line-height → md.sys.typescale.body-large.line-height
font tracking: md.comp.filled-text-field.input-text.tracking → md.sys.typescale.body-large.tracking
Roboto · weight 400 · size 16pt · line height 24pt · tracking 0.5pt—
Enabled › Input textmd.comp.filled-text-field.input-text.prefix.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Input textmd.comp.filled-text-field.input-text.suffix.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Input textmd.comp.filled-text-field.input-text.placeholder.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Caretmd.comp.filled-text-field.caret.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Disabled › Containermd.comp.filled-text-field.disabled.container.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Containermd.comp.filled-text-field.disabled.container.opacityOpacity—0.04—
Disabled › Label textmd.comp.filled-text-field.disabled.label-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Label textmd.comp.filled-text-field.disabled.label-text.opacityOpacity—0.38—
Disabled › Leading iconmd.comp.filled-text-field.disabled.leading-icon.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Leading iconmd.comp.filled-text-field.disabled.leading-icon.opacityOpacity—0.38—
Disabled › Trailing iconmd.comp.filled-text-field.disabled.trailing-icon.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Trailing iconmd.comp.filled-text-field.disabled.trailing-icon.opacityOpacity—0.38—
Disabled › Supporting textmd.comp.filled-text-field.disabled.supporting-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Supporting textmd.comp.filled-text-field.disabled.supporting-text.opacityOpacity—0.38—
Disabled › Input textmd.comp.filled-text-field.disabled.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Input textmd.comp.filled-text-field.disabled.input-text.opacityOpacity—0.38—
Disabled › Active indicatormd.comp.filled-text-field.disabled.active-indicator.heightLength—1dp—
Disabled › Active indicatormd.comp.filled-text-field.disabled.active-indicator.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Active indicatormd.comp.filled-text-field.disabled.active-indicator.opacityOpacity—0.38—
Hovered › Label textmd.comp.filled-text-field.hover.label-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › State layermd.comp.filled-text-field.hover.state-layer.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Hovered › State layermd.comp.filled-text-field.hover.state-layer.opacityOpacitymd.sys.state.hover.state-layer-opacity0.08—
Hovered › Leading iconmd.comp.filled-text-field.hover.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › Trailing iconmd.comp.filled-text-field.hover.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › Input textmd.comp.filled-text-field.hover.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Hovered › Supporting textmd.comp.filled-text-field.hover.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › Active indicatormd.comp.filled-text-field.hover.active-indicator.heightLength—1dp—
Hovered › Active indicatormd.comp.filled-text-field.hover.active-indicator.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Focused › Label textmd.comp.filled-text-field.focus.label-text.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Focused › Leading iconmd.comp.filled-text-field.focus.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Trailing iconmd.comp.filled-text-field.focus.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Input textmd.comp.filled-text-field.focus.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Focused › Supporting textmd.comp.filled-text-field.focus.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Active indicatormd.comp.filled-text-field.focus.active-indicator.heightLength—2dp—
Focused › Active indicatormd.comp.filled-text-field.focus.active-indicator.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Focused › Active indicatormd.comp.filled-text-field.focus.active-indicator.thicknessLengthmd.sys.state.focus-indicator.thickness3dp—
Errormd.comp.filled-text-field.error.active-indicator.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.filled-text-field.error.label-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.filled-text-field.error.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Errormd.comp.filled-text-field.error.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.filled-text-field.error.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Errormd.comp.filled-text-field.error.trailing-icon.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.filled-text-field.error.focus.active-indicator.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.filled-text-field.error.focus.label-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.filled-text-field.error.focus.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Error › Focusmd.comp.filled-text-field.error.focus.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.filled-text-field.error.focus.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Error › Focusmd.comp.filled-text-field.error.focus.trailing-icon.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.filled-text-field.error.focus.caret.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Hovermd.comp.filled-text-field.error.hover.active-indicator.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100
Error › Hovermd.comp.filled-text-field.error.hover.label-text.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100
Error › Hovermd.comp.filled-text-field.error.hover.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Error › Hovermd.comp.filled-text-field.error.hover.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Hovermd.comp.filled-text-field.error.hover.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Error › Hovermd.comp.filled-text-field.error.hover.trailing-icon.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100
Error › Hovermd.comp.filled-text-field.error.hover.state-layer.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Error › Hovermd.comp.filled-text-field.error.hover.state-layer.opacityOpacitymd.sys.state.hover.state-layer-opacity0.08—

Text field - Outlined · md.comp.outlined-text-field · 84 tokens

For outlined text fields.

GroupTokenTypeReference chainResolved valueOther contexts
Enabled › Containermd.comp.outlined-text-field.container.height (deprecated)Length—56dp—
Enabled › Containermd.comp.outlined-text-field.container.shapeShapemd.sys.shape.corner.extra-smallRounded corners 4dp—
Enabled › Outlinemd.comp.outlined-text-field.outline.widthLength—1dp—
Enabled › Outlinemd.comp.outlined-text-field.outline.colorColormd.sys.color.outline → md.ref.palette.neutral-variant50#79747EDark: #938F99 via md.ref.palette.neutral-variant60
Medium contrast: #49454F via md.ref.palette.neutral-variant30
High contrast: #322F37 via md.ref.palette.neutral-variant20
Enabled › Label textmd.comp.outlined-text-field.label-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Label textmd.comp.outlined-text-field.label-text.fontFont namesmd.sys.typescale.body-large.font → md.ref.typeface.plainRoboto—
Enabled › Label textmd.comp.outlined-text-field.label-text.line-heightLine heightmd.sys.typescale.body-large.line-height24pt—
Enabled › Label textmd.comp.outlined-text-field.label-text.sizeFont sizemd.sys.typescale.body-large.size16pt—
Enabled › Label textmd.comp.outlined-text-field.label-text.weightFont weightmd.sys.typescale.body-large.weight → md.ref.typeface.weight-regular400—
Enabled › Label textmd.comp.outlined-text-field.label-text.trackingFont trackingmd.sys.typescale.body-large.tracking0.5pt—
Enabled › Label textmd.comp.outlined-text-field.label-text.typeTypographycomposite
font names: md.comp.outlined-text-field.label-text.font → md.sys.typescale.body-large.font → md.ref.typeface.plain
font weight: md.comp.outlined-text-field.label-text.weight → md.sys.typescale.body-large.weight → md.ref.typeface.weight-regular
font size: md.comp.outlined-text-field.label-text.size → md.sys.typescale.body-large.size
line height: md.comp.outlined-text-field.label-text.line-height → md.sys.typescale.body-large.line-height
font tracking: md.comp.outlined-text-field.label-text.tracking → md.sys.typescale.body-large.tracking
Roboto · weight 400 · size 16pt · line height 24pt · tracking 0.5pt—
Enabled › Label textmd.comp.outlined-text-field.label-text.populated.line-heightLine heightmd.sys.typescale.body-small.line-height16pt—
Enabled › Label textmd.comp.outlined-text-field.label-text.populated.sizeFont sizemd.sys.typescale.body-small.size12pt—
Enabled › Leading iconmd.comp.outlined-text-field.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Leading iconmd.comp.outlined-text-field.leading-icon.sizeLength—24dp—
Enabled › Trailing iconmd.comp.outlined-text-field.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Trailing iconmd.comp.outlined-text-field.trailing-icon.sizeLength—24dp—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.fontFont namesmd.sys.typescale.body-small.font → md.ref.typeface.plainRoboto—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.line-heightLine heightmd.sys.typescale.body-small.line-height16pt—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.sizeFont sizemd.sys.typescale.body-small.size12pt—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.weightFont weightmd.sys.typescale.body-small.weight → md.ref.typeface.weight-regular400—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.trackingFont trackingmd.sys.typescale.body-small.tracking0.4pt—
Enabled › Supporting textmd.comp.outlined-text-field.supporting-text.typeTypographycomposite
font names: md.comp.outlined-text-field.supporting-text.font → md.sys.typescale.body-small.font → md.ref.typeface.plain
font weight: md.comp.outlined-text-field.supporting-text.weight → md.sys.typescale.body-small.weight → md.ref.typeface.weight-regular
font size: md.comp.outlined-text-field.supporting-text.size → md.sys.typescale.body-small.size
line height: md.comp.outlined-text-field.supporting-text.line-height → md.sys.typescale.body-small.line-height
font tracking: md.comp.outlined-text-field.supporting-text.tracking → md.sys.typescale.body-small.tracking
Roboto · weight 400 · size 12pt · line height 16pt · tracking 0.4pt—
Enabled › Input textmd.comp.outlined-text-field.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Enabled › Input textmd.comp.outlined-text-field.input-text.fontFont namesmd.sys.typescale.body-large.font → md.ref.typeface.plainRoboto—
Enabled › Input textmd.comp.outlined-text-field.input-text.line-heightLine heightmd.sys.typescale.body-large.line-height24pt—
Enabled › Input textmd.comp.outlined-text-field.input-text.sizeFont sizemd.sys.typescale.body-large.size16pt—
Enabled › Input textmd.comp.outlined-text-field.input-text.weightFont weightmd.sys.typescale.body-large.weight → md.ref.typeface.weight-regular400—
Enabled › Input textmd.comp.outlined-text-field.input-text.trackingFont trackingmd.sys.typescale.body-large.tracking0.5pt—
Enabled › Input textmd.comp.outlined-text-field.input-text.typeTypographycomposite
font names: md.comp.outlined-text-field.input-text.font → md.sys.typescale.body-large.font → md.ref.typeface.plain
font weight: md.comp.outlined-text-field.input-text.weight → md.sys.typescale.body-large.weight → md.ref.typeface.weight-regular
font size: md.comp.outlined-text-field.input-text.size → md.sys.typescale.body-large.size
line height: md.comp.outlined-text-field.input-text.line-height → md.sys.typescale.body-large.line-height
font tracking: md.comp.outlined-text-field.input-text.tracking → md.sys.typescale.body-large.tracking
Roboto · weight 400 · size 16pt · line height 24pt · tracking 0.5pt—
Enabled › Input textmd.comp.outlined-text-field.input-text.suffix.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Input textmd.comp.outlined-text-field.input-text.prefix.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Input textmd.comp.outlined-text-field.input-text.placeholder.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Enabled › Caretmd.comp.outlined-text-field.caret.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Enabled › Caretmd.comp.outlined-text-field.error.focus.caret.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Disabled › Label textmd.comp.outlined-text-field.disabled.label-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Label textmd.comp.outlined-text-field.disabled.label-text.opacityOpacity—0.38—
Disabled › Leading iconmd.comp.outlined-text-field.disabled.leading-icon.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Leading iconmd.comp.outlined-text-field.disabled.leading-icon.opacityOpacity—0.38—
Disabled › Trailing iconmd.comp.outlined-text-field.disabled.trailing-icon.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Trailing iconmd.comp.outlined-text-field.disabled.trailing-icon.opacityOpacity—0.38—
Disabled › Outlinemd.comp.outlined-text-field.disabled.outline.widthLength—1dp—
Disabled › Outlinemd.comp.outlined-text-field.disabled.outline.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Outlinemd.comp.outlined-text-field.disabled.outline.opacityOpacity—0.12—
Disabled › Supporting textmd.comp.outlined-text-field.disabled.supporting-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Supporting textmd.comp.outlined-text-field.disabled.supporting-text.opacityOpacity—0.38—
Disabled › Input textmd.comp.outlined-text-field.disabled.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Disabled › Input textmd.comp.outlined-text-field.disabled.input-text.opacityOpacity—0.38—
Hovered › Label textmd.comp.outlined-text-field.hover.label-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Hovered › Leading iconmd.comp.outlined-text-field.hover.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › Trailing iconmd.comp.outlined-text-field.hover.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Hovered › Outlinemd.comp.outlined-text-field.hover.outline.widthLength—1dp—
Hovered › Outlinemd.comp.outlined-text-field.hover.outline.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Hovered › Input textmd.comp.outlined-text-field.hover.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Hovered › Supporting textmd.comp.outlined-text-field.hover.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Label textmd.comp.outlined-text-field.focus.label-text.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Focused › Leading iconmd.comp.outlined-text-field.focus.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Trailing iconmd.comp.outlined-text-field.focus.trailing-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Outlinemd.comp.outlined-text-field.focus.outline.widthLength—3dp—
Focused › Outlinemd.comp.outlined-text-field.focus.outline.colorColormd.sys.color.primary → md.ref.palette.primary40#6750A4Dark: #D0BCFF via md.ref.palette.primary80
Medium contrast: #4F378B via md.ref.palette.primary30
High contrast: #381E72 via md.ref.palette.primary20
Focused › Input textmd.comp.outlined-text-field.focus.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Focused › Supporting textmd.comp.outlined-text-field.focus.supporting-text.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Focused › Focus indicatormd.comp.outlined-text-field.focus.indicator.outline.color (deprecated)Colormd.sys.color.secondary → md.ref.palette.secondary40#625B71Dark: #CCC2DC via md.ref.palette.secondary80
Medium contrast: #4A4458 via md.ref.palette.secondary30
High contrast: #332D41 via md.ref.palette.secondary20
Focused › Focus indicatormd.comp.outlined-text-field.error.focus.indicator.outline.color (deprecated)Colormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Focused › Focus indicatormd.comp.outlined-text-field.focus.indicator.outline.thickness (deprecated)Lengthmd.sys.state.focus-indicator.thickness3dp—
Errormd.comp.outlined-text-field.error.outline.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.outlined-text-field.error.label-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.outlined-text-field.error.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Errormd.comp.outlined-text-field.error.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Errormd.comp.outlined-text-field.error.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Errormd.comp.outlined-text-field.error.trailing-icon.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.outlined-text-field.error.focus.outline.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.outlined-text-field.error.focus.label-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.outlined-text-field.error.focus.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Error › Focusmd.comp.outlined-text-field.error.focus.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Focusmd.comp.outlined-text-field.error.focus.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Error › Focusmd.comp.outlined-text-field.error.focus.trailing-icon.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Hovermd.comp.outlined-text-field.error.hover.outline.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100
Error › Hovermd.comp.outlined-text-field.error.hover.label-text.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100
Error › Hovermd.comp.outlined-text-field.error.hover.input-text.colorColormd.sys.color.on-surface → md.ref.palette.neutral10#1D1B20Dark: #E6E0E9 via md.ref.palette.neutral90
Medium contrast: #000000 via md.ref.palette.neutral0
High contrast: #000000 via md.ref.palette.neutral0
Error › Hovermd.comp.outlined-text-field.error.hover.supporting-text.colorColormd.sys.color.error → md.ref.palette.error40#B3261EDark: #F2B8B5 via md.ref.palette.error80
Medium contrast: #8C1D18 via md.ref.palette.error30
High contrast: #601410 via md.ref.palette.error20
Error › Hovermd.comp.outlined-text-field.error.hover.leading-icon.colorColormd.sys.color.on-surface-variant → md.ref.palette.neutral-variant30#49454FDark: #CAC4D0 via md.ref.palette.neutral-variant80
Medium contrast: #322F37 via md.ref.palette.neutral-variant20
High contrast: #000000 via md.ref.palette.neutral-variant0
Error › Hovermd.comp.outlined-text-field.error.hover.trailing-icon.colorColormd.sys.color.on-error-container → md.ref.palette.error30#8C1D18Dark: #F9DEDC via md.ref.palette.error90
Medium contrast: #FFFFFF via md.ref.palette.error100
High contrast: #FFFFFF via md.ref.palette.error100

Filled text field ​

Diagram of a filled text field indicating the 10 parts of its anatomy.

  1. Container
  2. Leading icon (optional)
  3. Label text in empty field
  4. Label text in populated field
  5. Trailing icon (optional)
  6. Focused active Indicator
  7. Caret
  8. Input text
  9. Supporting text (optional)
  10. Enabled active indicator

Filled text field color ​

Color values are implemented through design tokens. For design, this means working with color values that correspond with tokens. For implementation, a color value will be a token that references a value. Learn more about design tokens

Diagram of a filled text field indicating its color mappings.

Filled text field color roles used for light and dark schemes:

  1. Surface container highest
  2. On surface variant
  3. On surface variant
  4. Primary
  5. On surface variant
  6. Primary
  7. Primary
  8. On surface
  9. On surface variant
  10. On surface

Filled text field states ​

States are visual representations used to communicate the status of a component or interactive element. Learn more about interaction states

Side by side view of empty and populated filled text fields across different states, showing the differences between enabled, focused, hovered, and disabled.

  1. Enabled (empty)
  2. Focused (empty)
  3. Hovered (empty)
  4. Disabled (empty)
  5. Enabled (populated)
  6. Focused (populated)
  7. Hovered (populated)
  8. Disabled (populated)

Filled text field error states ​

Error states are visual representations used to communicate the status of a component or interactive element. An error message can display instructions on how to fix it. Error messages are displayed below the text field as supporting text until fixed.

Side by side view of empty and populated filled text fields across different error states, showing the differences between enabled, focused, hovered.

  1. Enabled (empty)
  2. Focused (empty)
  3. Hovered (empty)
  4. Enabled (populated)
  5. Focused (populated)
  6. Hovered (populated)

Filled text field measurements ​

Diagram showing layout values and paddings for filled text fields without icons.

Padding and size measurements without icons

Diagram showing layout values and paddings for outlined text fields with leading and trailing icons.

Padding and size measurements with icons

A diagram showing layout values and paddings for supporting text, and supporting text in combination with a character count.

Padding and size measurements with supporting text and character count

AttributeValue
Default container height56dp
Label alignment (unpopulated)Vertically centered
Top/bottom padding8dp
Left/right padding without icons16dp
Left/right padding with icons12dp
Icon alignmentVertically centered
Padding between icons and text16dp
Supporting text and character counter top padding4dp
Padding between supporting text and character counter16dp
Target size56dp

Filled text field configurations ​

Side by side view of filled text fields in different configurations.

Empty and populated filled text fields with:

  1. Supporting text
  2. Trailing icon
  3. Leading icon
  4. Leading and trailing icons
  5. Prefix
  6. Suffix
  7. Multi-line text field

Outlined text field ​

Diagram of an outlined text field indicating the 9 parts of its anatomy

  1. Enabled container outline
  2. Leading icon (optional)
  3. Label text in empty field
  4. Label text in populated field
  5. Trailing icon (optional)
  6. Focused container outline
  7. Caret
  8. Input text
  9. Supporting text (optional)

Outlined text field color ​

Color values are implemented through design tokens. For design, this means working with color values that correspond with tokens. For implementation, a color value will be a token that references a value. Learn more about design tokens

Diagram of an outlined text field indicating its color mappings

Outlined text field color roles used for light and dark schemes:

  1. Outline
  2. On surface variant
  3. On surface variant
  4. Primary
  5. On surface variant
  6. Primary
  7. Primary
  8. On surface
  9. On surface variant

Outlined text field states ​

States are visual representations used to communicate the status of a component or interactive element. Learn more about interaction states

Side by side view of empty and populated outlined text fields across different states, showing the differences between enabled, focused, hovered, and disabled.

  1. Enabled (empty)
  2. Focused (empty)
  3. Hovered (empty)
  4. Disabled (empty)
  5. Enabled (populated)
  6. Focused (populated)
  7. Hovered (populated)
  8. Disabled (populated)

Outlined text field error states ​

Error states are visual representations used to communicate the status of a component or interactive element. An error message can display instructions on how to fix it. Error messages are displayed below the text field as supporting text until fixed.

Side by side view of empty and populated filled text fields across different error states, showing the differences between enabled, focused, hovered.

  1. Enabled (empty)
  2. Focused (empty)
  3. Hovered (empty)
  4. Enabled (populated)
  5. Focused (populated)
  6. Hovered (populated)

Outlined text field measurements ​

A diagram showing layout values and paddings for outlined text fields without icons.

Padding and size measurements without icons

A diagram showing layout values and paddings for outlined text fields with leading and trailing icons.

Padding and size measurements with icons

A diagram showing layout values and paddings for supporting text, and supporting text in combination with a character count.

Padding and size measurements with supporting text and character count

AttributeValue
Container height56dp
Left/right padding without icons16dp
Left/right padding with icons12dp
Padding between icons and text16dp
Icon alignmentVertically centered
Supporting text and character counter top padding4dp
Padding between supporting text and character counter16dp
Label alignmentVertically centered
Left/right padding populated label text4dp
Target size56dp

Outlined text field configurations ​

A side by side view of outlined text fields in different configurations.

Empty and populated outlined text fields with:

  1. Supporting text
  2. Trailing icon
  3. Leading icon
  4. Leading and trailing icons
  5. Prefix
  6. Suffix
  7. Multi-line text field

Unofficial offline mirror. Content © Google, licensed under CC BY 4.0.