diff --git a/docs/docs/custom-html.md b/docs/docs/custom-html.md
index fd49f64135e65..bbe52ea0f2ef1 100644
--- a/docs/docs/custom-html.md
+++ b/docs/docs/custom-html.md
@@ -15,18 +15,24 @@ cp .cache/default-html.js src/html.js
And then make modifications as needed.
+If you need to insert custom html into the `` or `` of each page on your site, you can use `html.js`.
+
### Required props
Note: the various props that are rendered into pages _are_ required e.g.
`headComponents`, `preBodyComponents`, `body`, and `postBodyComponents`.
-### React Helmet
+### Inserting html into the
-Also, anything you render in the `html.js` component will _not_ be made "live" in
+Anything you render in the `html.js` component will _not_ be made "live" in
the client like other components. If you want to dynamically update your
`` we recommend using
[React Helmet](/packages/gatsby-plugin-react-helmet/)
+### Inserting html into the
+
+If you want to insert custom html into the footer, html.js is the preferred way of doing this. If you're writing a plugin, consider using the `setPostBodyComponents` prop in the [Gatsby SSR API](/docs/ssr-apis/).
+
### Target container
If you see this error: `Uncaught Error: _registerComponent(...): Target container is not a DOM element.` it means your `html.js` is missing the required