diff --git a/source/_integrations/labs.markdown b/source/_integrations/labs.markdown index f919d022636..fdbb8350dee 100644 --- a/source/_integrations/labs.markdown +++ b/source/_integrations/labs.markdown @@ -20,11 +20,9 @@ The **Labs** {% term integration %} provides a dedicated panel where you can pre Labs preview features are different from beta testing: - *Beta testing* evaluates the stability of upcoming Home Assistant releases. -- *Labs preview features* are preview features being refined through real-world usage and feedback. - -{% include integrations/config_flow.md %} - -## About Labs preview features +- *Labs preview features* are in the process of being refined through real-world usage and feedback. + +## About Labs Labs allows you to: @@ -34,38 +32,42 @@ Labs allows you to: All preview features in Labs are: -- Optional: Disabled by default, you must explicitly enable them. +- Optional: Disabled by default, you need to explicitly enable them. - Free of critical bugs: Fully functional and free of critical bugs. - Subject to change: Feature set may be extended, and design and behavior may be refined based on feedback. - Reversible: Can be disabled at any time. -## Accessing Labs -To access the Labs panel: -1. Go to {% my labs title="**Settings** > **System** > **Labs**" %}. -2. Only admin users can access this panel. -## Using preview features +## About preview features -Each preview feature in Labs includes: +Each preview feature section in Labs includes: - **Name** and **Description**: What the feature does. - **Enable/Disable** button: Turn the feature on or off. Optionally they include: -- Feedback link: Share your experience with the community. -- Documentation link: Learn more about the feature. -- Report issue link: Report bugs or problems. +- **Feedback** link: Share your experience with the community. +- **Documentation** link: Learn more about the feature. +- **Report issue** link: Report bugs or problems. -### Enabling a feature +## Enabling a preview feature -1. Navigate to {% my labs title="the Labs panel" %}. +### Prerequisites + +- You need administrator rights to access this panel. +- Some preview features require specific integrations to be installed and configured. + - If a feature is unavailable with a message indicating a required integration, set up that integration and try again. + +### To enable a preview feature + +1. Go to {% my labs title="**Settings** > **System** > **Labs**" %}. 2. Find the feature you want to try. -3. Select the **Enable** button. +3. Select **Enable**. -You can also use My Home Assistant links to navigate directly to a specific feature in Labs. For example: +You can also use My Home Assistant links to directly go to a specific feature in Labs. For example: ```text https://my.home-assistant.io/redirect/labs/?domain=kitchen_sink&preview_feature=special_repair @@ -73,22 +75,25 @@ https://my.home-assistant.io/redirect/labs/?domain=kitchen_sink&preview_feature= These links are useful in release notes, documentation, or when sharing specific features with others. -### Disabling a feature +## Disabling a preview feature -1. Return to {% my labs title="the Labs panel" %}. +### Prerequisites + +- You need administrator rights to access this panel. +- You have enabled a preview feature. + +### To disable a preview feature + +1. Go to {% my labs title="**Settings** > **System** > **Labs**" %}. 2. Find the enabled feature. -3. Select the **Disable** button. - -## Feature requirements - -Some preview features require specific integrations to be installed and configured. If a feature is unavailable with a message indicating a required integration, you must first set up that integration before you can enable the feature. +3. Select **Disable**. ## Providing feedback Your feedback helps improve these features! When you enable a preview feature: -1. Use the **Give Feedback** link to share your experience in the community forum. -2. Use the **Report Issue** link to report bugs on GitHub. +1. Use the **Give feedback** link to share your experience in the community forum. +2. Use the **Report issue** link to report bugs on GitHub. 3. Be specific about what works well and what could be improved. 4. Include relevant details like your Home Assistant version and setup.