diff --git a/website/content/docs/job-specification/env.mdx b/website/content/docs/job-specification/env.mdx
index d849fe7d4..400552fd8 100644
--- a/website/content/docs/job-specification/env.mdx
+++ b/website/content/docs/job-specification/env.mdx
@@ -65,6 +65,16 @@ env {
 }
 ```
 
+### Environment variables with dots
+
+Environment variables that aren't valid HCLv2 identifiers, like ones containing `.`, require an alternative map assignment syntax.
+
+```hcl
+env = {
+  "discovery.type" = "single-node"
+}
+```
+
 ### Dynamic Environment Variables
 
 Nomad also supports populating dynamic environment variables from data stored in
diff --git a/website/content/docs/job-specification/meta.mdx b/website/content/docs/job-specification/meta.mdx
index 4f108dfb9..a7d0eca95 100644
--- a/website/content/docs/job-specification/meta.mdx
+++ b/website/content/docs/job-specification/meta.mdx
@@ -79,6 +79,16 @@ meta {
 }
 ```
 
+### Meta keys with dots
+
+Meta keys that aren't valid HCLv2 identifiers, like ones containing `.`, require an alternative map assignment syntax.
+
+```hcl
+meta = {
+  "project.team" = "sre"
+}
+```
+
 [job]: /docs/job-specification/job 'Nomad job Job Specification'
 [group]: /docs/job-specification/group 'Nomad group Job Specification'
 [task]: /docs/job-specification/task 'Nomad task Job Specification'