---
layout: component
title: "Lights"
description: "Instructions how to setup your lights with Home Assistant."
date: 2015-01-24 14:39
sidebar: true
comments: false
sharing: true
footer: true
---

This component allows you to track and control various light bulbs.

It has [4 built-in light profiles](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/light/light_profiles.csv) which you're able to extend by putting a `light_profiles.csv` file in your config dir.

It supports the following platforms:

 * `hue` for Philips Hue
 * `wink` for Wink

Preferred way to setup the Philips Hue platform is through the [the discovery component]({{site_root}}/components/discovery/). For the Wink light platform enable [the wink component]({{site_root}}/components/wink/).

If you want to enable the light component directly, add the following lines to your `configuration.yaml`:

```
light:
  platform: hue
```

<p class='note'>
The light component supports multiple entries in <code>configuration.yaml</code> by appending a sequential number to the section: <code>light 2:</code>, <code>light 3:</code> etc.
</p>

### Service `light.turn_on`

Turns one light on or multiple lights on using [groups]({{site_root}}/components/group/).

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | Only act on specified lights. Else targets all.
| `transition` | yes | Seconds to take to switch to new state. *not supported by Wink
| `profile` | yes | Which light profile to use.
| `xy_color` | yes | Two comma seperated floats that represent the color in XY
| `rgb_color` | yes | Three comma seperated integers that represent the color in RGB
| `brightness` | yes | Integer between 0 and 255 for how bright the color should be 
| `flash` | yes | Tell light to flash, can be either value `short` or `long`. *not supported by Wink

### Service `light.turn_off`

Turns one or multiple lights off.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | no | Only act on specified lights. Else targets all.
