---
schema_version: "1"
id: 1e30ca811f6d276d492622067bdff3799d8b681eb15c8f2831bd599f0b00a84a
title: apex:outputLabel
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/salesforce-pages-developers-guide/guides/pages/components/pages-compref-outputlabel.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-pages-developers-guide/guide/pages-compref-outputlabel.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 77a607ca5bc7bcb4b2486ae4762a1cf9e803d32d4d7446a1af21e1a5bb6e2709
products:
  - Visualforce Developer Guide
  - Platform Developer Content
---

# apex:outputLabel

A label for an input or output field. Use this component to provide a label for a controller method that does not correspond to a field on a Salesforce object.

This component supports [HTML pass-through attributes](https://developer.salesforce.com/docs/atlas.en-us.pages.meta/pages/pages_html_features_pass_through_attributes.htm) using the "html-" prefix. Pass-through attributes are attached to the generated `<label>` tag.

## Example

```apex
<apex:outputLabel value="Checkbox" for="theCheckbox"/>
<apex:inputCheckbox value="{!inputValue}" id="theCheckbox"/>
```

The example above renders the following HTML:

```html
<label for="theCheckbox">Checkbox</label>
<input id="theCheckbox" type="checkbox" name="theCheckbox" />
```

## Attributes

|Attribute Name|Attribute Type|Description|Required?|API Version|Access|
|--------------|--------------|-----------|---------|-----------|------|
|`accesskey`|String|The keyboard access key that puts the label and its associated field in focus.| |10.0|global|
|`dir`|String|The direction in which the generated HTML component should be read. Possible values include "RTL" (right to left) or "LTR" (left to right).| |10.0|global|
|`escape`|Boolean|A Boolean value that specifies whether sensitive HTML and XML characters should be escaped in the HTML output generated by this component. If you don't specify escape="false", the character escape sequence displays as written. For example, the only way to add a ">" symbol to a label is by using the symbol's character escape sequence and setting escape="false". If not specified, this value defaults to true.| |10.0|global|
|`for`|String|The ID of the component with which the label should be associated. When the label is in focus, the component specified by this attribute is also in focus.| |10.0|global|
|`id`|String|An identifier that allows the label component to be referenced by other components in the page.| |10.0|global|
|`lang`|String|The base language for the generated HTML output, for example, "en" or "en-US". For more information on this attribute, see [the W3C specifications](http://www.w3.org/TR/REC-html40/struct/dirlang.html).| |10.0|global|
|`onblur`|String|The JavaScript invoked if the onblur event occurs--that is, if the focus moves off of the label.| |10.0|global|
|`onclick`|String|The JavaScript invoked if the onclick event occurs--that is, if the user clicks the label.| |10.0|global|
|`ondblclick`|String|The JavaScript invoked if the ondblclick event occurs--that is, if the user clicks the label twice.| |10.0|global|
|`onfocus`|String|The JavaScript invoked if the onfocus event occurs--that is, if the focus is on the label.| |10.0|global|
|`onkeydown`|String|The JavaScript invoked if the onkeydown event occurs--that is, if the user presses a keyboard key.| |10.0|global|
|`onkeypress`|String|The JavaScript invoked if the onkeypress event occurs--that is, if the user presses or holds down a keyboard key.| |10.0|global|
|`onkeyup`|String|The JavaScript invoked if the onkeyup event occurs--that is, if the user releases a keyboard key.| |10.0|global|
|`onmousedown`|String|The JavaScript invoked if the onmousedown event occurs--that is, if the user clicks a mouse button.| |10.0|global|
|`onmousemove`|String|The JavaScript invoked if the onmousemove event occurs--that is, if the user moves the mouse pointer.| |10.0|global|
|`onmouseout`|String|The JavaScript invoked if the onmouseout event occurs--that is, if the user moves the mouse pointer away from the label.| |10.0|global|
|`onmouseover`|String|The JavaScript invoked if the onmouseover event occurs--that is, if the user moves the mouse pointer over the label.| |10.0|global|
|`onmouseup`|String|The JavaScript invoked if the onmouseup event occurs--that is, if the user releases the mouse button.| |10.0|global|
|`rendered`|Boolean|A Boolean value that specifies whether the component is rendered on the page. If not specified, this value defaults to true.| |10.0|global|
|`style`|String|The style used to display the label component, used primarily for adding inline CSS styles.| |10.0|global|
|`styleClass`|String|The style class used to display the label component, used primarily to designate which CSS styles are applied when using an external CSS stylesheet.| |10.0|global|
|`tabindex`|String|The order in which this label is selected compared to other page components when a user presses the Tab key repeatedly. This value must be an integer between 0 and 32767, with component 0 being the first component that is selected when a user presses the Tab key.| |10.0|global|
|`title`|String|The text to display as a tooltip when the user's mouse pointer hovers over this component.| |10.0|global|
|`value`|Object|The text displayed as the label.| |10.0|global|