Content Strategy

Validate internal links between subtopic content and pillar pages

Last updated: August 22, 2018

Applies to:

Marketing Hub Basic, Professional, Enterprise

In your content strategy tool, you can keep track of internal links to make sure that your subtopic content page or blog post contains a link back to your pillar page. These internal links contribute to this framework for increasing organic traffic.

Validate internal links

  • In your HubSpot Marketing Hub Basic, Professional, or Enterprise account, navigate to Marketing > Planning and Strategy > Content Strategy.
  • Click the name of the topic in the content strategy dashboard. 
  • A green link icon link in a subtopic header indicates that HubSpot has found an internal link between your subtopic content and the pillar page.

  • Click the subtopic bubble to view the subtopic content with the internal link.

  • If your subtopic content is hosted on HubSpot, you can add a link to your pillar page:
    • Click the name of the subtopic content to access the content's performance page.
    • Then, click Edit at the upper right and add a hyperlink within the content's body that links to your pillar page.
    • Click Update to take your changes live.

Internal links are not validating

If you have added internal links in your subtopic content to your pillar content, but your internal links are still not detected, there are a few possible reasons: 

  • Check to make sure that your subtopic content has been published. The tool can't detect internal links in a draft page or blog post.
  • The internal link must be on the subtopic page linking back to the pillar page. If the pillar page links to the subtopic page(s), the internal link(s) will not be validated.
  • It can take up to four hours for the crawler to complete the crawl once you click to check for links.
<a href=“”>our home page</a> 

Please note: CTAs are JavaScript snippets that redirect to your destination URL. Since the link to the destination is not present in the body HTML of the page, Google’s crawlers will not detect it as an internal link. 

  • Does the anchor tag in the page source match the format of the pillar page URL as you have entered it in your content strategy tool? 
    • If your link in the subtopic content is hardcoded as http, but your pillar page is now on SSL, you will need to make the link https
    • Relative links will be detected without issue. Either the absolute URL ( or the relative URL (/my-subtopic-page) will work.
    • If your link does not have a scheme, meaning http or https is not included in the URL (://, the link will not be detected. 
  • Is the attached subtopic a file from the file manager?
    • Image files (PNG, JPEG) and PDF files are not composed of HTML like a webpage. The subtopic content needs to be a blog post or live page where the tool can crawl it for links. Search engines parse through the HTML of a webpage and pick up on <a> tags to understand the internal links from one page to another. With a hosted image file, there is just the image itself. There are no hyperlinks leading to the pillar page.
    • There also needs to be a tracking code on the subtopic page, but there isn’t one on files in the file manager. 

Was this article helpful?

If you still need help you can get answers from the , or to contact support.