diff --git a/CHANGELOG b/CHANGELOG
index bd9d45cc2..74352fd70 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,3 +1,7 @@
+mkdocs-material-8.1.8+insiders-4.7.0 (2022-01-25)
+
+ * Added native support for offline search
+
mkdocs-material-8.1.8 (2022-01-23)
* Added Latvian translations
diff --git a/docs/insiders/changelog.md b/docs/insiders/changelog.md
index 947431730..e18c2596b 100644
--- a/docs/insiders/changelog.md
+++ b/docs/insiders/changelog.md
@@ -6,6 +6,10 @@ template: overrides/main.html
## Material for MkDocs Insiders
+### 4.7.0 _ January 25, 2022 { id="4.7.0" }
+
+- Added native support for offline search
+
### 4.6.1 _ January 16, 2022 { id="4.6.1" }
- Fixed #3459: Section index pages picking up wrong title
diff --git a/docs/insiders/index.md b/docs/insiders/index.md
index c0c562079..27de69629 100644
--- a/docs/insiders/index.md
+++ b/docs/insiders/index.md
@@ -162,8 +162,9 @@ The following features are solely available via Material for MkDocs Insiders:
+- [x] [Offline search] :material-new-box:
- [x] [Annotations] :material-new-box:
-- [x] [Navigation icons] :material-new-box:
+- [x] [Navigation icons]
- [x] [Code annotations: anchor links]
- [x] [Code annotations: strip comments]
- [x] [Dismissable announcement bar]
@@ -243,12 +244,14 @@ are released for general availability.
- [x] [Tokenizer with lookahead]
- [x] [Advanced search highlighting]
- [x] [Excluding content from search]
+- [x] [Offline search]
[Brand new search plugin]: ../blog/2021/search-better-faster-smaller.md
[Rich search previews]: ../blog/2021/search-better-faster-smaller.md#rich-search-previews
[Tokenizer with lookahead]: ../blog/2021/search-better-faster-smaller.md#tokenizer-lookahead
[Advanced search highlighting]: ../blog/2021/search-better-faster-smaller.md#accurate-highlighting
[Excluding content from search]: ../setup/setting-up-site-search.md#search-exclusion
+ [Offline search]: ../setup/setting-up-site-search.md#offline-search
#### $ 12,000 – Piri Piri
diff --git a/docs/setup/setting-up-site-search.md b/docs/setup/setting-up-site-search.md
index a2d263120..898854942 100644
--- a/docs/setup/setting-up-site-search.md
+++ b/docs/setup/setting-up-site-search.md
@@ -6,10 +6,10 @@ search:
# Setting up site search
-Material for MkDocs provides an excellent, client-side search implementation,
+Material for MkDocs provides an excellent client-side search implementation,
omitting the need for the integration of third-party services, which might
-be tricky to integrate to be compliant with data privacy regulations. Moreover,
-with some effort, search can be made available [offline].
+not be compliant with privacy regulations. Moreover, search even works
+[offline], allowing users to download your documentation.
[offline]: #offline-search
@@ -307,26 +307,30 @@ clipboard.
### Offline search
-[:octicons-tag-24: 5.0.0][offline search support] ·
-[:octicons-cpu-24: Plugin][localsearch]
+[:octicons-heart-fill-24:{ .mdx-heart } Insiders][Insiders]{ .mdx-insiders } ·
+[:octicons-tag-24: insiders-4.7.0][Insiders] ·
+:octicons-beaker-24: Experimental
-If you distribute your documentation as `*.html` files, the built-in search
-will not work out-of-the-box due to the restrictions modern browsers impose for
-security reasons. This can be mitigated with the [localsearch] plugin in
-combination with @squidfunk's [iframe-worker] polyfill.
+Insiders makes sure that the built-in search also works when you distribute your
+documentation as `*.html` files for download. Simply add the following lines to
+`mkdocs.yml`:
-For setup instructions, refer to the [localsearch documentation].
+``` yaml
+use_directory_urls: false
+```
+
+This ensures that `index.html` is appended to all internal URLs, which is
+necessary for allowing users to view your documentation locally and without
+Internet connection. No further setup is necessary – your documentation will
+work online and offline without any further ado.[^1]
+
+ [^1]:
+ Offline search was previously implemented through the third-party
+ [localsearch] plugin, which is still possible if you don't want to use
+ [Insiders]. Note, however, that setup might be challenging if you're not
+ experienced with MkDocs.
- [offline search support]: https://github.com/squidfunk/mkdocs-material/releases/tag/5.0.0
[localsearch]: https://github.com/wilhelmer/mkdocs-localsearch/
- [iframe-worker]: https://github.com/squidfunk/iframe-worker
- [localsearch documentation]: https://github.com/wilhelmer/mkdocs-localsearch#installation-material-v5
-
-!!! tip
-
- When distributing documentation as HTML files to be opened from the file
- system, you will also want to set `use_directory_urls: false` in
- `mkdocs.yml` to make page links function correctly.
## Usage