diff --git a/source/_docs/configuration/state_object.markdown b/source/_docs/configuration/state_object.markdown
index 346d98224aa..4736c0da719 100644
--- a/source/_docs/configuration/state_object.markdown
+++ b/source/_docs/configuration/state_object.markdown
@@ -16,8 +16,9 @@ All states will always have an entity id, a state and a timestamp when last upda
 | `state.domain`       | Domain of the entity. Example: `light`.                                                                                                                                                                            |
 | `state.object_id`    | Object ID of entity. Example: `kitchen`.                                                                                                                                                                           |
 | `state.name`         | Name of the entity. Based on `friendly_name` attribute with fall back to object ID. Example: `Kitchen Ceiling`.                                                                                                    |
-| `state.last_updated` | Time the state was written to the state machine in UTC time. Note that writing the exact same state including attributes will not result in this field being updated. Example: `2017-10-28 08:13:36.715874+00:00`. |
-| `state.last_changed` | Time the state changed in the state machine in UTC time. This is not updated when there are only updated attributes. Example: `2017-10-28 08:13:36.715874+00:00`.                                                  |
+| `state.last_changed` | Time the state changed in the state machine in UTC time. This is not updated if only state attributes change. Example: `2017-10-28 08:13:36.715874+00:00`.                                                         |
+| `state.last_reported`| Time the state was written to the state machine in UTC time. This timestamp is updated regardless of any change to the state or a state attribute. Example: `2017-10-28 08:13:36.715874+00:00`.                    |
+| `state.last_updated` | Time the state or state attributes changed in the state machine in UTC time. This is not updated if neither state nor state attributes changed. Example: `2017-10-28 08:13:36.715874+00:00`. |
 | `state.attributes`   | A dictionary with extra attributes related to the current state.                                                                                                                                                   |
 | `state.context`      | A dictionary with extra attributes related to the context of the state.                                                                                                                                                   |