---
name: "ttk::label"
section: "3tk"
platform: "linux"
package: "tk8.5-doc"
version: "8.5.19-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/ttk::label"
---

# ttk::label(3tk)

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.

## STANDARD OPTIONS

```
-class	-compound	-cursor
-image	-style	-takefocus
-text	-textvariable	-underline
-width
```

See the  manual entry for details on the standard options.

## WIDGET-SPECIFIC OPTIONS

```
Command-Line Name:	-anchor
Database Name:	anchor
Database Class:	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**.

```
Command-Line Name:	-background
Database Name:	frameColor
Database Class:	FrameColor
```

-

  The widget's background color.   If unspecified, the theme default is used.

```
Command-Line Name:	-font
Database Name:	font
Database Class:	Font
```

-

  Font to use for label text.

```
Command-Line Name:	-foreground
Database Name:	textColor
Database Class:	TextColor
```

-

  The widget's foreground color. If unspecified, the theme default is used.

```
Command-Line Name:	-justify
Database Name:	justify
Database Class:	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**.

```
Command-Line Name:	-padding
Database Name:	padding
Database Class:	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*.

```
Command-Line Name:	-relief
Database Name:	relief
Database Class:	Relief
```

-

  Specifies the 3-D effect desired for the widget border. Valid values are **flat**, **groove**, **raised**, **ridge**, **solid**,  and **sunken**.

```
Command-Line Name:	-text
Database Name:	text
Database Class:	Text
```

-

  Specifies a text string to be displayed inside the widget (unless overridden by **-textvariable**).

```
Command-Line Name:	-wraplength
Database Name:	wrapLength
Database Class:	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(3tk)](/ttk::widget/3tk.md)*.

## SEE ALSO

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