From 5316a460cd6dafb4f2dc11139c344b6ae57e53ad Mon Sep 17 00:00:00 2001
From: tr4nt0r <4445816+tr4nt0r@users.noreply.github.com>
Date: Fri, 5 Dec 2025 17:55:43 +0100
Subject: [PATCH 1/2] Adjust to changed subentry functionality in Xbox
 integration

---
 source/_integrations/xbox.markdown | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/source/_integrations/xbox.markdown b/source/_integrations/xbox.markdown
index 9e7aca9d525e..8c7a34a03b8c 100644
--- a/source/_integrations/xbox.markdown
+++ b/source/_integrations/xbox.markdown
@@ -43,6 +43,12 @@ The Home Assistant Xbox {% term integration %} lets you monitor and control Xbox
 
 {% include integrations/config_flow.md %}
 
+## Track online status of friends
+
+The **Xbox integration** allows tracking the online status, activity and other information of your friends. To add a friend, go to {% my integration domain="xbox" title="**Settings** > **Devices & services** > **Xbox**" %} and select **{% icon "mdi:plus" %} Add friend**.
+
+Once added, a new device will appear with the same set of entities available for your own Xbox account, allowing you to track your friend’s activity.
+
 ## Supported devices
 
 - Xbox One (S/X)
@@ -262,7 +268,7 @@ elements:
 
 ## Binary sensor
 
-The Xbox binary sensor platform automatically keeps track of your "**Favorite** friends". In your friends list, select **Change friendship > Favorite** to have that person automatically pulled into Home Assistant.
+The **Xbox binary sensor platform** automatically tracks the online status and activity of your own account as well as your friends.
 
 | Entity Name                      | Description                                                            |
 | -------------------------------- | ---------------------------------------------------------------------- |
@@ -272,7 +278,7 @@ The Xbox binary sensor platform automatically keeps track of your "**Favorite**
 
 ## Sensor
 
-Just like the binary sensors, the Xbox sensor platform automatically keeps track of your "**Favorite** friends".
+Similar to binary sensors, the **Xbox sensor platform** monitors your account and friends, providing detailed information about their activity and achievements.
 
 | Entity Name      | Description                                                                |
 | ---------------- | -------------------------------------------------------------------------- |
@@ -284,12 +290,19 @@ Just like the binary sensors, the Xbox sensor platform automatically keeps track
 | **Last online**  | Displays the last time the friend was active online.                       |
 | **In party**     | Shows the number of people in the user’s party chat if they are currently in one. |
 | **Now playing**  | Shows the title of the game currently being played. Additional details such as a short description, genre, developer, age rating, and achievement progress are available in the entity's attributes. |
+
+### Storage Sensors
+
+These sensors track the storage on your own **Xbox consoles** and connected storage devices.
+
+| Entity Name      | Description                                                                |
+| ---------------- | -------------------------------------------------------------------------- |
 | **Total space: *{name}*** | Reports the total storage capacity of the device. A separate sensor is created for each Xbox console and connected internal and external storage device. |
 | **Free space: *{name}*** | Reports the available (unused) storage space on the device. A separate sensor is created for each Xbox console and connected internal and external storage device. |
 
 ## Image
 
-For your account and each of your favorite friends, several image entities are available:
+For your account and each of your friends, several image entities are available:
 
 | Entity Name      | Description                                                                            |
 | ---------------- | -------------------------------------------------------------------------------------- |

From 5d7b933d35fed3ad1559a1e3da7f9d25f6c2196d Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 9 Dec 2025 06:51:51 +0100
Subject: [PATCH 2/2] tiny tweaks

---
 source/_integrations/xbox.markdown | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/source/_integrations/xbox.markdown b/source/_integrations/xbox.markdown
index 8c7a34a03b8c..d95db1ef0d36 100644
--- a/source/_integrations/xbox.markdown
+++ b/source/_integrations/xbox.markdown
@@ -45,7 +45,7 @@ The Home Assistant Xbox {% term integration %} lets you monitor and control Xbox
 
 ## Track online status of friends
 
-The **Xbox integration** allows tracking the online status, activity and other information of your friends. To add a friend, go to {% my integration domain="xbox" title="**Settings** > **Devices & services** > **Xbox**" %} and select **{% icon "mdi:plus" %} Add friend**.
+The **Xbox integration** allows tracking the online status, activity, and other information of your friends. To add a friend, go to {% my integration domain="xbox" title="**Settings** > **Devices & services** > **Xbox**" %} and select **{% icon "mdi:plus" %} Add friend**.
 
 Once added, a new device will appear with the same set of entities available for your own Xbox account, allowing you to track your friend’s activity.
 
@@ -291,7 +291,7 @@ Similar to binary sensors, the **Xbox sensor platform** monitors your account an
 | **In party**     | Shows the number of people in the user’s party chat if they are currently in one. |
 | **Now playing**  | Shows the title of the game currently being played. Additional details such as a short description, genre, developer, age rating, and achievement progress are available in the entity's attributes. |
 
-### Storage Sensors
+### Storage sensors
 
 These sensors track the storage on your own **Xbox consoles** and connected storage devices.