diff --git a/source/_integrations/gree.markdown b/source/_integrations/gree.markdown
new file mode 100644
index 00000000000..7401ab44c2b
--- /dev/null
+++ b/source/_integrations/gree.markdown
@@ -0,0 +1,24 @@
+---
+title: Gree
+description: Instructions on how to integrate Gree Smart devices within Home Assistant.
+ha_category:
+  - Climate
+ha_release: 0.117
+ha_iot_class: Local Polling
+ha_config_flow: true
+ha_codeowners:
+  - '@cmroche'
+ha_domain: gree
+---
+
+The Gree integration allows you to control a [Gree Smart HVAC](http://global.gree.com/).
+ 
+## Configuration
+
+Go to the integrations page in your configuration and click on **new integration** -> **Gree**.
+
+Gree Smart compatible devices are detected and added automatically.
+
+## Supported models
+
+Any Gree Smart device working with the Gree+ app should be supported, including non-Gree branded devices, including some sold by Trane.