From 05691ea904ff020b63c238187aa6acc497533301 Mon Sep 17 00:00:00 2001
From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
Date: Tue, 29 Oct 2024 11:29:03 +0100
Subject: [PATCH] Integration instance remove (#35449)

* Add steps on removing an integration instance

* Revert changes
---
 .../_includes/common-tasks/remove_device_service.md | 13 +++++++++++++
 source/common-tasks/general.markdown                |  4 +++-
 2 files changed, 16 insertions(+), 1 deletion(-)
 create mode 100644 source/_includes/common-tasks/remove_device_service.md

diff --git a/source/_includes/common-tasks/remove_device_service.md b/source/_includes/common-tasks/remove_device_service.md
new file mode 100644
index 00000000000..886175a11c5
--- /dev/null
+++ b/source/_includes/common-tasks/remove_device_service.md
@@ -0,0 +1,13 @@
+## Removing an integration instance
+
+If you no longer want to use a device or service in Home Assistant, you can remove the integration instance including the device or service with all its entities.
+
+The following steps describe the general steps needed to remove an integration instance. Depending on the integration, additional steps can be needed, such as resetting the device or to delete credentials. Refer to the integration documentation to see if additional steps are needed.
+
+### To remove an integration instance from Home Assistant
+
+1. Go to {% my integrations title="**Settings** > **Devices & services**" %} and select the integration card.
+2. From the list of devices, select the integration instance you want to remove.
+3. Next to the entry, select the three-dot menu. Then, select **Delete**.
+
+   ![Screenshot showing how to remove an integration instance](/images/organizing/integration_instance_delete.png)
diff --git a/source/common-tasks/general.markdown b/source/common-tasks/general.markdown
index 324c38ddaeb..f6479020755 100644
--- a/source/common-tasks/general.markdown
+++ b/source/common-tasks/general.markdown
@@ -22,4 +22,6 @@ Creating an automation for polling gives you more flexibility on when to poll:
 1. Not all integrations have a configurable polling interval. The homeassistant.update_entity service, on the other hand, works with most of the integrations; no code changes are required.
 2. An automation allows you to poll whenever you want. For example, if you have a rate-limited solar panel provider with a maximum number of requests per day, you may want to lower/stop the polling at night but poll more frequently during the day.
 
-{% include common-tasks/define_custom_polling.md %}
\ No newline at end of file
+{% include common-tasks/define_custom_polling.md %}
+
+{% include common-tasks/remove_device_service.md %}
\ No newline at end of file