

# Interact with device shadows
<a name="interact-with-shadows"></a>

Greengrass core devices can interact with [Amazon IoT device shadows](https://docs.amazonaws.cn/iot/latest/developerguide/iot-device-shadows.html) using components. A *shadow* is a JSON document that stores the current or desired state information for an Amazon IoT thing. Shadows can make a device’s state available to other Amazon IoT Greengrass components whether the device is connected to Amazon IoT or not. Each Amazon IoT device has its own classic, unnamed shadow. You can also create multiple named shadows for each device. 

Devices and services can create, update, and delete cloud shadows by using MQTT and the [reserved MQTT shadow topics](https://docs.amazonaws.cn/iot/latest/developerguide/reserved-topics.html#reserved-topics-shadow), HTTP using the [Device Shadow REST API](https://docs.amazonaws.cn/iot/latest/developerguide/device-shadow-rest-api.html), and the [Amazon CLI for Amazon IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/index.html).

The [shadow manager](shadow-manager-component.md) component enables your Greengrass components to create, update, and delete local shadows by using the [local shadow service](ipc-local-shadows.md) and the local publish/subscribe shadow topics. The shadow manager also manages the storage of these local shadow documents on your core device, and handles the synchronization of shadow state information with cloud shadows.

You can also use the shadow manager component to manage local shadows for [client devices](interact-with-local-iot-devices.md) that connect to the core device. To enable shadow manager to manage client device shadows, you configure the [MQTT bridge component](mqtt-bridge-component.md) to relay messages between the local MQTT broker and the local publish/subscribe service. For more information, see [Interact with and sync client device shadows](work-with-client-device-shadows.md).

For more information about Amazon IoT device shadow concepts, see [Amazon IoT Device Shadow service](https://docs.amazonaws.cn/iot/latest/developerguide/iot-device-shadows.html) in the *Amazon IoT Developer Guide*.

**Topics**
+ [Interact with shadows in components](interact-with-shadows-in-components.md)
+ [Sync local device shadows with Amazon IoT Core](sync-shadows-with-iot-core.md)