Skip to main content

Internal linking

Note

Internal linking is an AI-driven feature. While we strive for accuracy, links can occasionally be misplaced or point to the wrong article. Always review internal links before publishing.

Machined can link the articles in a cluster to each other as they're written. Links are woven naturally into the text using keyword-targeted anchor text, and point to other articles in the same cluster.

Internal linking is off by default.

Turning internal linking on​

  • Clusters: in the SEO tab of the cluster table, set Internal Links to Cluster Only for an article, or for every article at once. None turns it off.
  • Whole project: turn on Internal links in writing defaults, under SEO. New cluster articles then start with internal linking on.

Single articles don't get internal links, because there's no cluster for them to link within.

When an article is written, Machined links to sibling articles in the same cluster that are already written or published, plus any articles being written in the same batch. The number of links depends on how many other articles in the cluster are written, and they're spread across the article's sections with varied anchor text.

You can see the links that were added in the Internal links section of the right panel in the article editor.

Internal links are added as relative links (for example, /how-to-brew-coffee), so they work automatically when all articles are published to the same directory on your site. If your articles live under a path such as /blog/, set the Internal-link path prefix when publishing to WordPress so links point to the right place.

Tip

Write and publish cluster articles together where possible. If you publish gradually, check for links to articles that haven't gone live yet to avoid broken links.