WordPress Guides
Theme•Updated 2025-01-15

Internal Linking for Astra Sites: Complete Guide

Astra is a lightweight, fast-loading WordPress theme that works with any page builder. Whether you use Gutenberg, Elementor, or Beaver Builder with Astra, here's how to implement effective internal linking that works with your setup.

Why Astra's Flexibility Matters for Internal Linking

Astra is not a page builder itself - it is a highly customizable WordPress theme designed for speed and flexibility. It works seamlessly with Gutenberg, Elementor, Beaver Builder, and other page builders. Many Astra users install Starter Templates, which are pre-designed full website kits that can be imported and customized. This means your internal linking strategy for an Astra site depends on which page builder you are using. An Astra + Elementor site has the same linking challenges as any Elementor site. An Astra + Gutenberg site follows Gutenberg best practices. However, Astra's theme customizer and header/footer builder do add some unique considerations for sitewide navigation links.

Internal Linking Challenges on Astra Sites

Multiple Page Builder Compatibility

Because Astra works with any page builder, your internal linking approach varies. If you use Elementor with Astra, you face Elementor's JSON metadata challenges. If you use Gutenberg, you deal with block-based content. If you use Beaver Builder, you encounter its module system. Internal linking tools need to parse whatever page builder your Astra site uses, not just understand Astra itself.

Starter Template Import Structure

Many Astra users start with a Starter Template - a complete website design imported in one click. These templates include pre-built pages, headers, footers, and navigation menus with placeholder links. After importing a template, you need to audit and update the default link structure to match your actual content, replacing generic links with strategic internal links to your real pages.

Custom Header and Footer Builders

Astra Pro includes a custom header and footer builder (built with Gutenberg or Elementor blocks, depending on your choice). Links you add to the header or footer appear across your entire site. While this is great for sitewide navigation, you need to ensure these links are universally relevant and do not conflict with page-specific contextual links elsewhere.

Dynamic Content and Custom Layouts

Astra's custom layouts feature lets you insert content dynamically on specific pages, post types, or based on conditions. If you create a custom layout with internal links, you need to ensure those links make sense everywhere the layout appears. A 'Related Services' custom layout might work great on all service pages but be confusing on blog posts.

Step-by-Step Guide

1

Identify Your Page Builder and Audit Content

First, determine which page builder your Astra site uses. Check a few pages in the WordPress editor - is it Gutenberg blocks, Elementor sections, or Beaver Builder modules? Once you know, follow the internal linking best practices for that specific builder. Use WPLink to crawl your site - it will automatically detect your page builder and parse content accordingly, whether you are using Gutenberg, Elementor, Divi, or Beaver Builder with Astra.

  • •Check your most important pages to see which builder they use (some Astra sites mix builders)
  • •If you imported a Starter Template, note which pages are template defaults vs. custom content you created
  • •Export a content inventory showing page titles, word counts, builder type, and current internal links
2

Update Starter Template Default Links

If you imported an Astra Starter Template, it came with pre-designed pages including placeholder links. Go through the template pages and replace generic links (like 'Learn More' buttons linking to example.com or '#') with real internal links to your cornerstone content. Check the header navigation, footer links, and any CTA sections to ensure they point to actual pages on your site, not template placeholders.

  • •Start with the homepage - replace all template placeholder links with links to your real pages
  • •Check the header menu and footer widget links - update these sitewide elements first
  • •Review CTA sections in template pages and link buttons to relevant conversion or hub pages
3

Design a Hub-and-Spoke Content Structure

Map your content into topical clusters, creating hub pages for each major topic and linking related spoke pages to the hub. Use Astra's lightweight design to build fast-loading hub pages with clear navigation to spokes. Whether you are using Gutenberg columns, Elementor sections, or Beaver Builder rows, design hub pages that showcase related content with compelling links. Ensure all spoke pages link back to their hub, building strong topical authority.

  • •Use Astra's built-in column layouts (if using Gutenberg) to create hub pages with linked content grids
  • •Design a consistent visual style for hub page CTA buttons using Astra's global color settings
  • •Add breadcrumb navigation (Astra supports this) so users always see the hub page in their navigation path
4

Add Contextual Links Within Page Builder Content

Follow the internal linking best practices for whichever page builder you are using with Astra. If using Gutenberg, add contextual links in Paragraph blocks. If using Elementor, add links in Text Editor widgets. If using Beaver Builder, add them in Text Editor modules. Aim for 2-3 contextual links per 500 words of content, placed where they genuinely help readers explore related topics. Use descriptive anchor text that tells readers what they will find when they click.

  • •Prioritize linking from high-authority pages (popular blog posts) to newer or conversion-focused pages
  • •Use your page builder's link settings to ensure internal links open in the same tab (not new windows)
  • •Add 'Related Resources' sections at the end of long-form content with 2-3 strategic internal links
5

Optimize Header and Footer Links in Astra Builder

Use Astra's header and footer customizer (or custom layouts with Gutenberg/Elementor) to add strategic sitewide navigation links. Your header menu should link to top-level hub pages and key conversion pages. The footer can include more comprehensive sitemap-style links, resources, and links to cornerstone content. Because these elements appear on every page, ensure the links are universally relevant, not page-specific contextual links.

  • •Use Astra's header builder to create a clean main menu linking to 5-7 top hub pages
  • •Add a 'mega menu' (if using Astra Pro) to showcase subcategory pages under main hub links
  • •Create a footer with 3-4 widget columns - one for product/service links, one for resources, one for company pages
6

Monitor Performance and Iterate Your Link Structure

After implementing your internal linking strategy, track results using Google Search Console (internal link counts, indexed pages) and Google Analytics (page-to-page traffic flow). Check your header and footer links to see which are getting clicks. Verify that your page builder content renders links correctly on the frontend. Use WPLink to re-crawl your site monthly and discover new linking opportunities as you publish more content.

  • •Set up GA4 events to track clicks on header menu links and footer CTA links
  • •Use Google Search Console's 'Links' report to confirm your hub pages are accumulating internal links
  • •Re-crawl your site after publishing 5-10 new pieces of content to find fresh linking opportunities

How WPLink Works with Astra

WPLink works seamlessly with Astra because it detects and parses the underlying page builder your Astra site uses. Whether you are using Gutenberg, Elementor, Beaver Builder, or another builder with Astra, WPLink automatically uses the appropriate parsing strategy. It extracts content from Gutenberg blocks, Elementor widgets, Beaver Builder modules, or standard post content, giving you a complete view of your site regardless of builder choice. The AI-powered semantic analysis then suggests contextual internal links with specific anchor text and target pages. Links are inserted through the WordPress REST API, preserving your page builder settings and Astra theme styling.

Auto-detects your page builder (Gutenberg, Elementor, Beaver Builder, etc.) and parses content accordingly
Extracts content from Astra custom layouts and header/footer builder elements
AI semantic analysis works regardless of which page builder you use with Astra
Suggests contextual anchor text and placement appropriate for your page builder
Inserts links via WordPress REST API, preserving page builder settings and Astra theme styles
Flags Astra custom layouts and header/footer elements as sitewide so you can make informed link decisions
WPLink works with Astra 3.0+ (and Astra Pro) on WordPress 5.9+. Compatible with Astra + Gutenberg, Astra + Elementor, Astra + Beaver Builder, Astra + Divi, and other page builder combinations. Supports Astra Starter Templates, custom layouts, and header/footer builder elements. Works with both the free Astra theme and Astra Pro features.

Alternative Approaches

Link Whisper

Pros
  • + Works directly in WordPress admin with any theme/builder
  • + Provides link suggestions as you write content
  • + Includes orphan content detection and link analytics
Cons
  • - May not parse Elementor or Beaver Builder content correctly if used with Astra
  • - Annual subscription pricing adds up over time
  • - Keyword-based suggestions miss semantic relationships between topics

Frequently Asked Questions

Ready to optimize your internal links?

Get started with WPLink today and see the difference.

Download WPLink