diff --git a/README.md b/README.md
index 8c46fbe21ca2d979c270fa1b0c9586ea745b9a7c..2bd2a2b234f27aba666f1708f4d33e8a4b1bbad9 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,8 @@ pip install mkdocs-material
 Append the following line to your project's `mkdocs.yml`:
 
 ``` yaml
-theme: 'material'
+theme:
+  name: 'material'
 ```
 
 ## What to expect
diff --git a/docs/customization.md b/docs/customization.md
index 48333da4adf9da8a925e0416b4f14b0b9308574d..48764df0b3cb013b8474439327b1593cd5664441 100644
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -71,18 +71,19 @@ main theme.
 ### Setup and theme structure
 
 Reference the Material theme as usual in your `mkdocs.yml`, and create a
-new folder for overrides, e.g. `theme`, which you reference using `theme_dir`:
+new folder for overrides, e.g. `theme`, which you reference using `custom_dir`:
 
 ``` yaml
-theme: 'material'
-theme_dir: 'theme'
+theme:
+  name: 'material'
+  custom_dir: 'theme'
 ```
 
 !!! warning "Theme extension prerequisites"
 
-    As the `theme_dir` variable is used for the theme extension process, the
+    As the `custom_dir` variable is used for the theme extension process, the
     Material theme needs to be installed via `pip` and referenced with the
-    `theme` parameter in your `mkdocs.yml`.
+    `name` parameter in your `mkdocs.yml`.
 
 The structure in the theme directory must mirror the directory structure of the
 original theme, as any file in the theme directory will replace the file with
@@ -98,6 +99,7 @@ The directory layout of the Material theme is as follows:
 │  ├─ javascripts/                     # JavaScript
 │  └─ stylesheets/                     # Stylesheets
 ├─ partials/
+│  ├─ language/                        # Localized languages
 │  ├─ disqus.html                      # Disqus integration
 │  ├─ footer.html                      # Footer bar
 │  ├─ header.html                      # Header bar