Label Element (Report Items) (RDL)

Provides a user-friendly label for an instance of an item within a report.

<Textbox Name="..."> <!-- or Line, Rectangle, Image, Subreport, List, Matrix, Table, Chart, Grouping -->
</Textbox> <!-- or /Line, /Rectangle, /Image, /Subreport, /List, /Matrix, /Table, /Chart, /Grouping -->

Characteristic Description

Data type and length


Default value



0-1: Optional element that can occur once or not at all.

Relationship Element

Parent elements

Chart, Grouping, Image, Line, List, Matrix, Rectangle, Subreport, Table, Textbox

Child element


The expression within the Label element evaluates to a variant. You can use an expression within the Label element to identify individual instances of a report item with a user-friendly name. Label is used in searches and displayed within the document map. Report item labels appear in the document map as a hierarchy that reflects the hierarchy of items within the report definition.

The label for the item does not appear in the document map if the expression contained in the Label element returns a null value, or Label is not defined. Label is not used for report items within a page header or page footer.

To cause the link in the document map to jump to a child item in the report, use the sibling LinkToChild element. LinkToChild is available only with rectangle items.

Community Additions