diff --git a/source/_integrations/miele.markdown b/source/_integrations/miele.markdown
index 7809fd0df33..47fc5239fb8 100644
--- a/source/_integrations/miele.markdown
+++ b/source/_integrations/miele.markdown
@@ -208,22 +208,16 @@ When the configuration entry is loaded or after a streaming error (for example a
 
 ## Troubleshooting
 
-### Unavailable entities for a device
-
-#### Symptom: "The entities related to an appliance were available but no longer are"
+{% details "Problem: Unavailable entities for a device" %}
 
 After reloading the Miele integration, the entities related to an appliance that used to be available are no longer available.
 
-##### Description
-
 Unavailable entities can have multiple causes:
 
 - The appliance is turned off. When it is turned off, the appliance is disconnected and the API does not retrieve information about the appliance.
 - The appliance is experiencing a network issue.
 - The Miele API is experiencing issues.
 
-##### Resolution
-
 To try to solve the above issues, follow these steps:
 
 1. Turn on the appliance and reload the Miele integration.
@@ -236,6 +230,16 @@ To try to solve the above issues, follow these steps:
    - [Miele service and contact](https://www.miele.com/)
    - [Miele developer Help & Support](https://www.miele.com/developer)
 
+{% enddetails %}
+
+{% details "Problem: Program or program phase is unknown" %}
+
+The most common cause is that the code presented by the API is unknown to the integration. Details of the missing code can be found in the Home Assistant log or in the diagnostic file. Please open an issue on GitHub with the details from the logs. Please also include information on the program or program phase that was active when the message occurred.
+
+Unknown can also be displayed if the state is reported as unknown by the API, usually caused by a temporary malfunction in the cloud service.
+
+{% enddetails %}
+
 ## Removing the integration
 
 This integration follows standard integration removal. If you have entered your own credentials, you will be asked if you want to keep them or delete them. If you want to delete them later you can do that from the tree-dot menu in {% my integrations title="**Settings** > **Devices & services**" %}.