ApolloAutomation · bharvey88 · Aug 22, 2026 · Aug 22, 2026 · Aug 22, 2026
diff --git a/docs/homey/products/air1/additonal-info/air-quality-sensor-comparison.md b/docs/homey/products/air1/additonal-info/air-quality-sensor-comparison.md
@@ -1 +1,4 @@
+---
+description: "A technical comparison of air quality sensors used with the AIR-1, including performance, accuracy, and specifications."
+---
 --8<-- "products/air1/additional-info/air-quality-sensor-comparison.md:5:"
diff --git a/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md b/docs/homey/products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md
@@ -1 +1,4 @@
+---
+description: "Adding Optional MiCS-4514 Gas Sensor To The AIR-1."
+---
 --8<-- "products/air1/addons/adding-the-mics-4514-gas-sensor-to-the-air-1.md:5:"
diff --git a/docs/homey/products/air1/air1-reviews.md b/docs/homey/products/air1/air1-reviews.md
@@ -1 +1,4 @@
+---
+description: "Youtuber reviews and feedback about the AIR-1 sensor from Apollo Automation."
+---
 --8<-- "products/air1/air1-reviews.md:5:"
diff --git a/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md b/docs/homey/products/air1/calibrating-and-updating/air-1-temp-calibration.md
@@ -1,2 +1,5 @@
+---
+description: "Calibrate the AIR-1 temperature reading from its SEN55 to your room using a temperature offset."
+---
 
 ![AIR-1 Temperature Offset 2.png](/assets/air-1-temperature-offset-2.png)
diff --git a/docs/homey/products/air1/faq.md b/docs/homey/products/air1/faq.md
@@ -1 +1,4 @@
+---
+description: "Frequently asked questions about the AIR-1 environmental sensor, including setup, features, and troubleshooting."
+---
 --8<-- "products/air1/faq.md:5:"
diff --git a/docs/homey/products/air1/introduction.md b/docs/homey/products/air1/introduction.md
@@ -1 +1,4 @@
+---
+description: "Documentation for AIR-1, including setup, usage, and best practices."
+---
 --8<-- "products/air1/introduction.md:5:"
diff --git a/docs/homey/products/air1/setup/general-tips.md b/docs/homey/products/air1/setup/general-tips.md
@@ -1,4 +1,7 @@
 ---
+description: ">-"
+---
+---
 # AIR-1 General Tips
 
 The AIR-1 has multiple different types of sensors and this guide will help you understand which ones you should be concerned with and expected safe or not safe thresholds to alert or automate on.

diff --git a/docs/homey/products/air1/setup/prevent-sleep.md b/docs/homey/products/air1/setup/prevent-sleep.md
@@ -1 +1,4 @@
---8<-- "products/air1/setup/prevent-sleep.md:5:"
+---
+description: "How to disable Prevent Sleep and allow your Apollo device to sleep!"
+---
+--8<-- "products/general/battery-sensors/prevent-sleep.md:5:"
diff --git a/docs/homey/products/air1/setup/sensor-definitions.md b/docs/homey/products/air1/setup/sensor-definitions.md
@@ -1 +1,4 @@
+---
+description: "Full list of definitions for the AIR-1 and its various sensors."
+---
 --8<-- "products/air1/setup/sensor-definitions.md:5:"
diff --git a/docs/homey/products/air1/troubleshooting/air1-boot-mode.md b/docs/homey/products/air1/troubleshooting/air1-boot-mode.md
@@ -1,3 +1,6 @@
+---
+description: "Step by step guide for putting The AIR-1 In Boot Mode."
+---
 
 !!! info "This will cover how to put the AIR-1 into boot mode."
 

diff --git a/docs/homey/products/air1/troubleshooting/air1-code.md b/docs/homey/products/air1/troubleshooting/air1-code.md
@@ -1,3 +1,6 @@
+---
+description: "Step by step guide for re-flashing the AIR-1 back to factory firmware."
+---
 
 !!! info "If your device becomes unresponsive and you've exhausted the other troubleshooting methods you can reflash the factory firmware by following the steps below."
 

diff --git a/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md b/docs/homey/products/air1/troubleshooting/air1-reset-wi-fi-credentials.md
@@ -1,3 +1,6 @@
+---
+description: "Step by step guide for resetting the Wi-Fi Credentials on your AIR-1."
+---
 
 1\. Plug the device into power.
 

diff --git a/docs/homey/products/air1/troubleshooting/air1-teardown.md b/docs/homey/products/air1/troubleshooting/air1-teardown.md
@@ -1 +1,4 @@
+---
+description: "Step by step guide for tearing down your AIR-1 to replace parts, clean it, swap cases, etc."
+---
 --8<-- "products/air1/troubleshooting/air1-teardown.md:5:"
diff --git a/docs/homey/products/btn1/additional-info/prevent-sleep.md b/docs/homey/products/btn1/additional-info/prevent-sleep.md
@@ -1 +1,4 @@
+---
+description: "How to prevent the BTN-1 from sleeping to maintain functionality"
+---
 --8<-- "products/btn1/additional-info/prevent-sleep.md:5:"
diff --git a/docs/homey/products/btn1/addons/btn1-addon.md b/docs/homey/products/btn1/addons/btn1-addon.md
@@ -1 +1,4 @@
+---
+description: "BTN-1 attaching keys to the BTN-1"
+---
 --8<-- "products/btn1/addons/btn1-addon.md:5:"
diff --git a/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md b/docs/homey/products/btn1/battery-sensors/wake-up-battery-sensor.md
@@ -1 +1,4 @@
+---
+description: "How to wake up your Apollo device which is currently sleeping."
+---
 --8<-- "products/general/battery-sensors/wake-up-battery-sensor.md:5:"
diff --git a/docs/homey/products/btn1/btn1-reviews.md b/docs/homey/products/btn1/btn1-reviews.md
@@ -1 +1,4 @@
+---
+description: "Youtuber and other Influencer reviews and feedback about the BTN-1 sensor from Apollo Automation."
+---
 --8<-- "products/btn1/btn1-reviews.md:5:"
diff --git a/docs/homey/products/btn1/examples/blueprint.md b/docs/homey/products/btn1/examples/blueprint.md
@@ -1 +1,4 @@
+---
+description: ">-"
+---
 --8<-- "products/btn1/examples/blueprint.md:7:"
diff --git a/docs/homey/products/btn1/examples/example-automation.md b/docs/homey/products/btn1/examples/example-automation.md
@@ -1 +1,4 @@
+---
+description: "Example of how to use the BTN-1 Events to create an automation in Home Assistant!"
+---
 --8<-- "products/btn1/examples/example-automation.md:5:"
diff --git a/docs/homey/products/btn1/faq.md b/docs/homey/products/btn1/faq.md
@@ -1 +1,4 @@
+---
+description: "Frequently asked questions about the BTN-1 Macro Deck"
+---
 --8<-- "products/btn1/faq.md:5:"
diff --git a/docs/homey/products/btn1/introduction.md b/docs/homey/products/btn1/introduction.md
@@ -1 +1,4 @@
+---
+description: "Documentation for BTN-1, including setup, usage, and best practices."
+---
 --8<-- "products/btn1/introduction.md:5:"
diff --git a/docs/homey/products/btn1/setup/general-tips.md b/docs/homey/products/btn1/setup/general-tips.md
@@ -1 +1,4 @@
+---
+description: "BTN-1 General Tips"
+---
 --8<-- "products/btn1/setup/general-tips.md:5:"
diff --git a/docs/homey/products/btn1/setup/getting-started.md b/docs/homey/products/btn1/setup/getting-started.md
@@ -1 +1,4 @@
+---
+description: "Step by step guide to getting started with your BTN-1!"
+---
 --8<-- "products/btn1/setup/getting-started.md:5:"
diff --git a/docs/homey/products/btn1/setup/sensor-definitions.md b/docs/homey/products/btn1/setup/sensor-definitions.md
@@ -1 +1,4 @@
+---
+description: "These are all of the entities exposed by the BTN-1 to automate on!"
+---
 --8<-- "products/btn1/setup/sensor-definitions.md:5:"
diff --git a/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md b/docs/homey/products/btn1/troubleshooting/btn1-boot-mode.md
@@ -1 +1,4 @@
+---
+description: "Step by step guide for putting The BTN-1 In Boot Mode."
+---
 --8<-- "products/btn1/troubleshooting/btn1-boot-mode.md:5:"
diff --git a/docs/homey/products/btn1/troubleshooting/btn1-reflash.md b/docs/homey/products/btn1/troubleshooting/btn1-reflash.md
@@ -1 +1,4 @@
+---
+description: "Step by step guide for reflashing The BTN-1."
+---
 --8<-- "products/btn1/troubleshooting/btn1-reflash.md:5:"
diff --git a/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md b/docs/homey/products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md
@@ -1 +1,4 @@
+---
+description: "Step by step guide for resetting the Wi-Fi Credentials on your BTN-1."
+---
 --8<-- "products/btn1/troubleshooting/btn1-reset-wi-fi-credentials.md:5:"
diff --git a/docs/homey/products/btn1/troubleshooting/btn1-teardown.md b/docs/homey/products/btn1/troubleshooting/btn1-teardown.md
@@ -1 +1,4 @@
+---
+description: ">-"
+---
 --8<-- "products/btn1/troubleshooting/btn1-teardown.md:7:"
diff --git a/docs/homey/products/general/battery-sensors/awake-homey-flow.md b/docs/homey/products/general/battery-sensors/awake-homey-flow.md
@@ -1,3 +1,6 @@
+---
+description: "Keep a battery powered Apollo sensor awake using Homey Advanced Flows."
+---
 # How to keep your sensor awake using Homey Advanced Flows
 
 1\. This still needs to be done!
diff --git a/docs/homey/products/general/calibrating-and-updating/co2-calibration.md b/docs/homey/products/general/calibrating-and-updating/co2-calibration.md
@@ -1,3 +1,6 @@
+---
+description: "Step by step guide for re-calibrating your SCD40 CO2 sensor"
+---
 # CO<sub>2</sub> Calibration
 
 !!! info "Your sensor calibrates itself"

diff --git a/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md b/docs/homey/products/general/calibrating-and-updating/mmwave-videos.md
@@ -1,3 +1,6 @@
+---
+description: "Two short videos and a quick sumamry on how to best tune the LD2410B in the MSR-2!"
+---
 # This needs to be redone for Homey if it can be duplicated.
 
 !!! tip "Radar Engineering Mode (REM)"

diff --git a/.../homey/products/general/calibrating-and-updating/zone-configuration/zones-ha.md b/.../homey/products/general/calibrating-and-updating/zone-configuration/zones-ha.md
@@ -1 +1,4 @@
---8<-- "homey/products/mtr1/setup/zones-ha.md"
+---
+description: "Tutorial for MTR-1 Home Assistant Zone Configuration."
+---
+--8<-- "products/mtr1/setup/zones-ha.md:5:"
diff --git a/...homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md b/...homey/products/general/calibrating-and-updating/zone-configuration/zones-hlk.md
@@ -1 +1,4 @@
+---
+description: "Tutorial for MTR-1 HLKRadarTool app Zone Configuration."
+---
 --8<-- "homey/products/mtr1/setup/zones-hlk.md"
diff --git a/docs/homey/products/general/comparisons.md b/docs/homey/products/general/comparisons.md
@@ -1 +1,4 @@
+---
+description: "mmWave Presense Sensor Comparison Chart."
+---
 --8<-- "products/general/comparisons.md:5:"
diff --git a/docs/homey/products/general/contact-us/Facebook.md b/docs/homey/products/general/contact-us/Facebook.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/Facebook.md"
+---
+description: "Join the Apollo Automation community group on Facebook."
+---
+--8<-- "products/general/contact-us/Facebook.md:4:"
diff --git a/docs/homey/products/general/contact-us/GitHub.md b/docs/homey/products/general/contact-us/GitHub.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/GitHub.md"
+---
+description: "Apollo Automation on GitHub, where the firmware and hardware files live."
+---
+--8<-- "products/general/contact-us/GitHub.md:4:"
diff --git a/docs/homey/products/general/contact-us/Instagram.md b/docs/homey/products/general/contact-us/Instagram.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/Instagram.md"
+---
+description: "Follow Apollo Automation on Instagram."
+---
+--8<-- "products/general/contact-us/Instagram.md:4:"
diff --git a/docs/homey/products/general/contact-us/Reddit.md b/docs/homey/products/general/contact-us/Reddit.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/Reddit.md"
+---
+description: "The Apollo Automation subreddit."
+---
+--8<-- "products/general/contact-us/Reddit.md:4:"
diff --git a/docs/homey/products/general/contact-us/YouTube.md b/docs/homey/products/general/contact-us/YouTube.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/YouTube.md"
+---
+description: "The Apollo Automation YouTube channel, with setup guides, reviews, and live streams."
+---
+--8<-- "products/general/contact-us/YouTube.md:4:"
diff --git a/docs/homey/products/general/contact-us/apollo-automation-shop.md b/docs/homey/products/general/contact-us/apollo-automation-shop.md
@@ -1 +1,4 @@
+---
+description: "The Apollo Automation shop, where you can buy sensors, probes, and accessories."
+---
 --8<-- "products/general/contact-us/apollo-automation-shop.md:5:"
diff --git a/docs/homey/products/general/contact-us/contact-us-support.md b/docs/homey/products/general/contact-us/contact-us-support.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/contact-us-support.md"
+---
+description: "How to reach Apollo Automation support, by email, on Discord, or through the community forum."
+---
+--8<-- "products/general/contact-us/contact-us-support.md:4:"
diff --git a/docs/homey/products/general/contact-us/our-team.md b/docs/homey/products/general/contact-us/our-team.md
@@ -1 +1,4 @@
---8<-- "products/general/contact-us/general/our-team.md"
+---
+description: "Meet the people behind Apollo Automation."
+---
+--8<-- "products/general/contact-us/our-team.md:4:"
diff --git a/docs/homey/products/general/faq.md b/docs/homey/products/general/faq.md
@@ -1 +1,4 @@
+---
+description: "Frequently Asked Questions."
+---
 --8<-- "products/general/faq.md:5:"
diff --git a/docs/homey/products/general/links.md b/docs/homey/products/general/links.md
@@ -1 +1,4 @@
+---
+description: "Links to our github, printables, and discord!"
+---
 --8<-- "products/general/links.md:5:"
diff --git a/docs/homey/products/general/mmwave-presence-sensor-comparison.md b/docs/homey/products/general/mmwave-presence-sensor-comparison.md
@@ -1 +1,4 @@
+---
+description: "mmWave Presense Sensor Comparison Chart."
+---
 --8<-- "products/general/mmwave-presence-sensor-comparison.md:5:"
diff --git a/docs/homey/products/general/resellers.md b/docs/homey/products/general/resellers.md
@@ -1 +1,4 @@
+---
+description: "A list of resellers across the globe for Apollo Automation products!"
+---
 --8<-- "products/general/resellers.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-air1.md b/docs/homey/products/general/setup/getting-started-air1.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-msr1.md b/docs/homey/products/general/setup/getting-started-msr1.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-msr2.md b/docs/homey/products/general/setup/getting-started-msr2.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-mtr1.md b/docs/homey/products/general/setup/getting-started-mtr1.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-plt1.md b/docs/homey/products/general/setup/getting-started-plt1.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started-temp1.md b/docs/homey/products/general/setup/getting-started-temp1.md
@@ -1 +1,4 @@
+---
+description: "Generic getting started article."
+---
 --8<-- "homey/products/general/setup/getting-started.md:5:"
diff --git a/docs/homey/products/general/setup/getting-started.md b/docs/homey/products/general/setup/getting-started.md
@@ -1,3 +1,6 @@
+---
+description: "Generic getting started article."
+---
 # Getting Started
 
 This will walk you through the process of connecting your new Apollo Automation sensor to Homey. If at any point you get stuck, join our <a href="https://link.apolloautomation.com/discord" target="_blank" rel="noopener">Discord</a> for some help.

diff --git a/docs/homey/products/general/setup/renaming-apollo-devices.md b/docs/homey/products/general/setup/renaming-apollo-devices.md
@@ -1,3 +1,6 @@
+---
+description: "Rename an Apollo device from the Homey app or the Homey dashboard."
+---
 # Renaming Apollo Devices
 
 1\. Open the Homey App or dashboard in a browser and right click a device or short hold and then select "Rename".

diff --git a/docs/homey/products/general/temp-hum-calibration.md b/docs/homey/products/general/temp-hum-calibration.md
@@ -1 +1,4 @@
+---
+description: "Temp and Humidity Calibration and Offset Examples."
+---
 --8<-- "products/general/temp-hum-calibration.md:5:"
diff --git a/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md b/docs/homey/products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md
@@ -1 +1,4 @@
+---
+description: "Tutorial to help fix the OPNsense mDNS Auto Discover Issue"
+---
 --8<-- "products/general/troubleshooting/opnsense-mdns-auto-discover-issue.md:5:"
diff --git a/docs/homey/products/general/troubleshooting/removing-device-from-homey.md b/docs/homey/products/general/troubleshooting/removing-device-from-homey.md
@@ -1,3 +1,6 @@
+---
+description: "Remove an Apollo device from Homey through the app or the dashboard."
+---
 # Removing Devices from Homey
 
 1\. Open your Homey app or desktop browser and navigate to the Homey Dashboard.

diff --git a/...mey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md b/...mey/products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md
@@ -1 +1,4 @@
+---
+description: "Tutorial to help fix the Ubiquiti Unifi mDNS Auto Discover Issue."
+---
 --8<-- "products/general/troubleshooting/ubiquiti-unifi-mdns-auto-discover-issue.md:5:"
diff --git a/docs/homey/products/led1/addons/adding-microphone-to-led-1.md b/docs/homey/products/led1/addons/adding-microphone-to-led-1.md
@@ -1 +1,4 @@
+---
+description: "Step by Step directions for adding a microphone to your LED-1"
+---
 --8<-- "products/led1/addons/adding-microphone-to-led-1.md:5:"
diff --git a/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md b/docs/homey/products/led1/examples/led-1-controlling-govee-lights.md
@@ -1 +1,4 @@
+---
+description: ">-"
+---
 --8<-- "products/led1/examples/led-1-controlling-govee-lights.md:7:"
diff --git a/docs/homey/products/led1/faq.md b/docs/homey/products/led1/faq.md
@@ -1 +1,4 @@
+---
+description: "Frequently asked questions about the LED-1 controller."
+---
 --8<-- "products/led1/faq.md:5:"
diff --git a/docs/homey/products/led1/introduction.md b/docs/homey/products/led1/introduction.md
@@ -1 +1,4 @@
+---
+description: "Documentation for LED-1, including setup, usage, and best practices."
+---
 --8<-- "products/led1/introduction.md:5:"
diff --git a/docs/homey/products/led1/led1-reviews.md b/docs/homey/products/led1/led1-reviews.md
@@ -1 +1,4 @@
+---
+description: "Youtuber reviews and feedback about the LED-1 sensor from Apollo Automation."
+---
 --8<-- "products/led1/led1-reviews.md:5:"
diff --git a/docs/homey/products/led1/setup/getting-started-led1.md b/docs/homey/products/led1/setup/getting-started-led1.md
@@ -1 +1,4 @@
+---
+description: "Getting started with your new LED-1!"
+---
 --8<-- "products/led1/setup/getting-started-led1.md:5:"
diff --git a/docs/homey/products/led1/setup/led1-general-tips.md b/docs/homey/products/led1/setup/led1-general-tips.md
@@ -1 +1,4 @@
+---
+description: "Multiple helpful tips to use your LED-1 to the fullest!"
+---
 --8<-- "products/led1/setup/led1-general-tips.md:5:"
diff --git a/docs/homey/products/led1/setup/led1-pinout-guide.md b/docs/homey/products/led1/setup/led1-pinout-guide.md
@@ -1 +1,4 @@
+---
+description: "LED-1 Pinout Guide"
+---
 --8<-- "products/led1/setup/led1-pinout-guide.md:5:"