---
name: "ttk_label"
section: "n"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/ttk_label/n"
---

# ttk\_label(n)

Display a text string and/or image

## NAME

ttk::label - Display a text string and/or image

## SYNOPSIS

**ttk::label** *pathName* ?*options*?

## DESCRIPTION

A **ttk::label** widget displays a textual label and/or image. The label may be linked to a Tcl variable  to automatically change the displayed text. -class	-compound	-cursor -image	-style	-takefocus -text	-textvariable	-underline -width

## WIDGET-SPECIFIC OPTIONS

\[**-anchor** *anchor Anchor*\] Specifies how the information in the widget is positioned relative to the inner margins.  Legal values are **n**, **ne**, **e**, **se**, **s**, **sw**, **w**, **nw**, and **center**. See also **-justify**. \[**-background** *frameColor FrameColor*\] The widget's background color.   If unspecified, the theme default is used. \[**-font** *font Font*\] Font to use for label text. \[**-foreground** *textColor TextColor*\] The widget's foreground color. If unspecified, the theme default is used. \[**-justify** *justify Justify*\] If there are multiple lines of text, specifies how the lines are laid out relative to one another. One of **left**, **center**, or **right**. See also **-anchor**. \[**-padding** *padding Padding*\] Specifies the amount of extra space to allocate for the widget. The padding is a list of up to four length specifications  *left top right bottom*. If fewer than four elements are specified,  *bottom* defaults to *top*, *right* defaults to *left*, and  *top* defaults to *left*. \[**-relief** *relief Relief*\] Specifies the 3-D effect desired for the widget border. Valid values are **flat**, **groove**, **raised**, **ridge**, **solid**,  and **sunken**. \[**-text** *text Text*\] Specifies a text string to be displayed inside the widget (unless overridden by **-textvariable**). \[**-wraplength** *wrapLength WrapLength*\] Specifies the maximum line length (in pixels). If this option is less than or equal to zero, then automatic wrapping is not performed; otherwise the text is split into lines such that no line is longer than the specified value.

## WIDGET COMMAND

Supports the standard widget commands **configure**, **cget**, **identify**, **instate**, and **state**; see *ttk::widget(n)*.

## SEE ALSO

ttk::widget(n), [label(n)](/label/n.md)