diff --git a/components/esphome.rst b/components/esphome.rst
index afc5d5ba4..69d460425 100644
--- a/components/esphome.rst
+++ b/components/esphome.rst
@@ -330,7 +330,17 @@ Project information
 
 This allows creators to add the project name and version to the compiled code. It is currently only
 exposed via the logger, mDNS and the device_info response via the native API. The format of the name
-should be ``namespace.project_name``.
+should be ``author_name.project_name``.
+
+.. code-block:: yaml
+
+    # Example configuration
+    esphome:
+      ...
+      project:
+        name: "jesse.leds_party"
+        version: "1.0.0"
+
 
 See Also
 --------