From cc21121ac2c34ffb722387498b798494fe78ebb1 Mon Sep 17 00:00:00 2001
From: luar123 <49960470+luar123@users.noreply.github.com>
Date: Tue, 28 Oct 2025 23:00:05 +0100
Subject: [PATCH 1/3] Update esp32.md with custom partitions information

Added details about custom partitions to esp32.md.
---
 content/components/esp32.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/content/components/esp32.md b/content/components/esp32.md
index 3377301d40..b80ad20981 100644
--- a/content/components/esp32.md
+++ b/content/components/esp32.md
@@ -39,7 +39,9 @@ esp32:
   `360MHz` or `400MHz`. Defaults to `160MHz`. Not all values are available for all chips.
 
 - **partitions** (*Optional*, filename): The name of (optionally including the path to) the file containing the
-  partitioning scheme to be used. When not specified, partitions are automatically generated based on `flash_size`.
+  partitioning scheme to be used. When not specified, partitions are automatically generated based on `flash_size` and `custom_partitions.
+
+- **custom_partitions** (*Optional*): Add partitions to the automatically generated partition scheme. See [Custom Partitions](#esp32-partitions).
 
 - **framework** (*Optional*): Options for the underlying framework used by ESPHome. See [Framework](#esp32-framework).
 
@@ -239,6 +241,15 @@ git repository.
 - **path** (*Optional*, string): The path of the component in the git repository or a local path to the
   component if `source` is not set.
 
+{{< anchor "esp32-partitions" >}}
+
+## Custom Partitions
+
+The `custom_partitions` option allows you to add partitions to the automatically generated partition table.
+
+- **name** (*Required*, string): Name of the component e.g. `espressif/esp_hosted`.
+
+
 ## GPIO Pin Numbering
 
 The ESP32 boards often use the internal GPIO pin numbering based on the microcontroller, so you likely don't have to

From cd47767c95eec95783953d2fe79dd343510359bd Mon Sep 17 00:00:00 2001
From: luar123 <49960470+luar123@users.noreply.github.com>
Date: Wed, 29 Oct 2025 21:47:48 +0100
Subject: [PATCH 2/3] Update custom partitions section in esp32.md

Clarified requirements for custom partitions in esp32.md.
---
 content/components/esp32.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/content/components/esp32.md b/content/components/esp32.md
index b80ad20981..a9d761e314 100644
--- a/content/components/esp32.md
+++ b/content/components/esp32.md
@@ -245,10 +245,13 @@ git repository.
 
 ## Custom Partitions
 
-The `custom_partitions` option allows you to add partitions to the automatically generated partition table.
-
-- **name** (*Required*, string): Name of the component e.g. `espressif/esp_hosted`.
+The `custom_partitions` option allows you to add partitions to the automatically generated partition table. Valid partition types and subtypes
+are found in the [esp-idf documentation](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/api-guides/partition-tables.html).
 
+- **name** (*Required*, string): Name of the partition. Can not be any of `nvs`, `app0`, `app1`, `otadata`, `eeprom`, `spiffs`, `phy_init`.
+- **type** (*Required*, string or integer): Partition type. One of `app` or `data` or a custom type with integer between 0x40 and 0xFE.
+- **subtype** (*Required*, string or integer): Partition sub type. Can be a valid sub type name or integer between 0x0 and 0xFE.
+- **size** (*Required*, integer): Partition size in bytes.
 
 ## GPIO Pin Numbering
 

From 7f346554c4bcde0c700a77f036520ee8dd5b9e6a Mon Sep 17 00:00:00 2001
From: luar123 <49960470+luar123@users.noreply.github.com>
Date: Wed, 29 Oct 2025 21:53:14 +0100
Subject: [PATCH 3/3] fix

---
 content/components/esp32.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/components/esp32.md b/content/components/esp32.md
index a9d761e314..5639e6ec42 100644
--- a/content/components/esp32.md
+++ b/content/components/esp32.md
@@ -39,7 +39,7 @@ esp32:
   `360MHz` or `400MHz`. Defaults to `160MHz`. Not all values are available for all chips.
 
 - **partitions** (*Optional*, filename): The name of (optionally including the path to) the file containing the
-  partitioning scheme to be used. When not specified, partitions are automatically generated based on `flash_size` and `custom_partitions.
+  partitioning scheme to be used. When not specified, partitions are automatically generated based on `flash_size` and `custom_partitions`.
 
 - **custom_partitions** (*Optional*): Add partitions to the automatically generated partition scheme. See [Custom Partitions](#esp32-partitions).