# Labels | WPF Controls | DevExpress Documentation

## Overview

A label is an object that is used to categorize appointments. It provides a caption and a color, so that end-users can assign a corresponding color to an appointment’s background to identify appointments.

The image below shows appointments with different labels. An end-user can change the appointment’s label in the context menu or the [Appointment Window](/WPF/119347/controls-and-libraries/scheduler/visual-elements/windows/appointment-window).

![WPFScheduler_Label_As](/WPF/images/wpfscheduler_label_as131847.png)

A label is an [AppointmentLabelItem](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelItem) class instance that is assigned to an appointment using the [AppointmentItem.LabelId](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.LabelId) property.  All labels are contained in the [SchedulerControl.LabelItems](/WPF/DevExpress.Xpf.Scheduling.SchedulerControl.LabelItems) collection and you can use it to customize existing labels, remove them or add your own.

## Default Labels

The [SchedulerControl.LabelItems](/WPF/DevExpress.Xpf.Scheduling.SchedulerControl.LabelItems) collection includes the following labels by default:

- XAML

<section id="tabpanel_wB9Nh6IYfH_tabid-xaml" role="tabpanel" data-tab="tabid-xaml">
<pre><code class="lang-xaml">&lt;dxsch:SchedulerControl.LabelItems&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelNone}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_None}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelNone}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelImportant}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Important}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelImportant}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelBusiness}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Business}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelBusiness}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelPersonal}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Personal}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelPersonal}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelVacation}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Vacation}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelVacation}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelMustAttend}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_MustAttend}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelMustAttend}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelTravelRequired}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_TravelRequired}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelTravelRequired}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelNeedsPreparation}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_NeedsPreparation}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelNeedsPreparation}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelBirthday}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Birthday}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelBirthday}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelAnniversary}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_Anniversary}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelAnniversary}&quot;/&gt;
    &lt;dxsch:AppointmentLabelItem BrushName=&quot;{x:Static dxsch:DefaultBrushNames.LabelPhoneCall}&quot; Caption=&quot;{dxsch:SchedulerLocalizer StringId=AppointmentLabel_PhoneCall}&quot; Id=&quot;{x:Static dxsch:DefaultItemIds.LabelPhoneCall}&quot;/&gt;
&lt;/dxsch:SchedulerControl.LabelItems&gt;
</code></pre></section>

You can generate this XAML snippet by clicking the **Create Label Items** item in the scheduler’s [Smart Tag](/WPF/18096/whats-installed/smart-tags/smart-tag-overview).

See the [Appearance Customization](/WPF/400994/controls-and-libraries/scheduler/appearance-customization) topic for information on how to customize brushes associated with labels.

Tip

Handle the [SchedulerControl.InitNewAppointment](/WPF/DevExpress.Xpf.Scheduling.SchedulerControl.InitNewAppointment) event to initialize all newly created appointments with a specific label.

## Binding to Data

Labels can be bound to a data source using the [DataSource.AppointmentLabelsSource](/WPF/DevExpress.Xpf.Scheduling.DataSource.AppointmentLabelsSource) property. Map data fields to label properties using the [AppointmentLabelMappings](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings) settings.

See Also

[How to: Create Custom Labels and Statuses](/WPF/116501/controls-and-libraries/scheduler/examples/how-to-create-custom-labels-and-statuses)

[Customize Colors](/WPF/400994/controls-and-libraries/scheduler/appearance-customization)

[Customize Themes](/WPF/400710/common-concepts/themes/customize-themes)