AegisLink Master User Guide

AegisLink User Guide

Version 1.1.18 • Updated February 09, 2026

About this guide

This document is a consolidated, product-grade user guide for AegisLink. It is written for WordPress administrators who want practical workflows for improving internal linking, creating keyword-based Smart Links, publishing SEO-friendly Word Clouds, and managing on-domain ShortURL links for campaigns and sharing.

AegisLink is an admin-first tool: most configuration happens in WordPress, and the front-end behavior is applied automatically (for Smart Links and ShortURL redirects) when enabled.

Screenshots: This guide is maintained as an active, continuously improved resource. As AegisLink evolves, new capabilities, interface refinements, and optimization recommendations may be introduced. To ensure accuracy and reliability, instructions, definitions, and screenshots may be updated periodically. Always refer to the latest version of this guide for the most up-to-date information and recommended workflows.

Audience and scope

Primary audience

  • Site owners, marketers, and editors responsible for SEO structure and internal linking
  • Administrators managing short links for campaigns, newsletters, social, and ecommerce
  • Technical admins who need controlled settings, logging, and health checks

In scope

  • Configuring Word Cloud defaults and using the shortcode
  • Creating Smart Links (keyword → URL) and reviewing suggestions
  • Creating, sharing, and tracking ShortURL links
  • License activation and daily health checks

Out of scope

  • Rewriting your content strategy (AegisLink provides tools; you choose what to link and why)
  • Replacing full analytics suites (AegisLink focuses on link-level signal and operational visibility)

Safety, limitations, and responsibilities

Important: AegisLink can change front-end output when Smart Links are enabled and can create public-facing redirects when ShortURL links are published. Treat changes as production-impacting: test on staging when possible.
  • Change control: Keep a record of major Smart Link rules and ShortURL campaigns so you can audit or revert quickly.
  • Performance: Large rule sets and click tracking add work on page render and redirect. Use only what you need and keep rules intentional.
  • SEO responsibility: Over-linking can reduce readability and trust. Use Smart Links as a helper, not as an excuse to spam keywords.
  • Privacy: Click tracking and analytics store link interaction data. Follow your site’s privacy policy and applicable laws.

Core concepts

Smart Links (Keyword → URL)

  • A keyword is a single word you define (case-insensitive).
  • A destination URL is where that keyword should link.
  • When enabled site-wide, AegisLink automatically links matching keywords across common content surfaces.

ShortURL links

  • A short slug creates a clean URL on your domain (ex: /go/summer-sale).
  • A target URL is the final destination where the short link redirects.
  • Tracking (when enabled) records click activity for analytics.

Word Cloud

AegisLink can generate a keyword frequency “word cloud” from content using standard HTML text (not a canvas image). This keeps the output readable, theme-friendly, and SEO-friendly.

Quick start paths

Improve internal linking (10–20 minutes)

  1. Open AegisLinkLinking AssistantKeyword Links
  2. Add 5–20 Smart Links (keyword → URL) for your key products/pages
  3. Enable Smart Links site-wide
  4. Review a few posts/pages to confirm linking looks natural

Create campaign short links (10–15 minutes)

  1. Open ShortURL Links tab
  2. Create a short slug and target URL
  3. Use Share to copy the short link (and QR if enabled)
  4. Optionally enable tracking and review Analytics

Publish a Word Cloud block (5–10 minutes)

  1. Open Word Cloud tab and review defaults
  2. Copy the shortcode and paste it into a page/post/builder shortcode element
  3. Preview and adjust limits/font sizes only if needed

Features

Install & Activate

Where: Plugins → Add New → Upload Plugin (then AegisLink menu appears)

Adds AegisLink to the WordPress admin and enables the Linking Assistant workspace. Once activated, AegisLink registers its admin menus and initializes modules for Smart Links, ShortURL links, and Word Cloud output.

Important: Confirm your host meets minimum requirements (WordPress 6.8+, PHP 8.2+) and that your admin user has the required capabilities.

Configuration

  1. Upload the AegisLink ZIP in WordPress.
  2. Activate the plugin.
  3. Open AegisLink from the admin menu.

Linking Assistant (Workspace & Tabs)

Where: AegisLink → Linking Assistant

AegisLink organizes core functionality into four tabs so admins can manage SEO helpers and link tools from a single workspace: Word Cloud, Keyword Links, ShortURL Links, and Tools & Licensing.

Configuration

  1. Open AegisLink → Linking Assistant.
  2. Use the top tabs to switch modules.
  3. Save settings per module and validate front-end behavior where applicable.

Word Cloud (Keyword Word Cloud shortcode)

Where: AegisLink → Linking Assistant → Word Cloud

Generates a clean, SEO-friendly keyword frequency cloud from your content using real HTML text. It extracts words from content, applies length and count limits, and renders words in size buckets (large/medium/small) for readability.

Word Cloud (Keyword Word Cloud shortcode)

Configuration

  1. Open Word Cloud tab.
  2. Review defaults (word limit, min/max length, font sizes).
  3. Copy the shortcode block and paste it into a page/post/builder shortcode element.
  4. Preview and tune limits only if needed.

Internal link suggestions (per post/page)

Where: AegisLink → Linking Assistant → Keyword Links → Suggestions

Generates internal link suggestions for a selected Page or Post. This helps editors spot opportunities to add contextual links to other relevant pages without guessing.

Configuration

  1. In Keyword Links, select a Page or Post.
  2. Review Suggestions for that content.
  3. Apply the suggestions by adding Smart Link rules or manual edits (your choice).

ShortURL Links (on-domain short links)

Where: AegisLink → Linking Assistant → ShortURL Links

Create and manage short links on your own domain (example: /go/your-slug) with optional click tracking and analytics. Useful for campaigns, QR sharing, ecommerce product sharing, and cleaner URLs in social posts.

ShortURL Links (on-domain short links)

Configuration

  1. Open ShortURL Links tab.
  2. Review Settings (prefix, default redirect code, tracking defaults).
  3. Create short links in Manage tab.
  4. Use Share to copy link and QR code (if enabled).

ShortURL Manage tab

Where: ShortURL Links → Manage

Create, edit, organize, and share short links. Each short link maps a short slug to a target URL, with per-link overrides for redirect code, tracking, and rel attributes.

Configuration

  1. Click “Edit Short Link” (or create new).
  2. Set target URL and slug.
  3. Choose redirect code and tracking (per-link overrides if needed).
  4. Save and test the short link in an incognito window.

ShortURL Bulk tab

Where: ShortURL Links → Bulk

Bulk-create or bulk-generate short links to save time (especially for many ecommerce products or campaign sets). This is commonly paired with the WooCommerce Share Button feature.

ShortURL Bulk tab

Configuration

  1. Open Bulk tab.
  2. Choose the bulk action (generate/create as provided by your UI).
  3. Run the bulk operation.
  4. Spot-check several created links, then enable sharing where needed.

ShortURL Analytics tab

Where: ShortURL Links → Analytics

Shows link-level performance signals such as daily clicks trends, top referrers, and user agents (when tracking is enabled). This helps you validate campaign performance and detect unusual traffic patterns.

ShortURL Analytics tab

Configuration

  1. Enable tracking (default or per-link).
  2. Send/share the short link.
  3. Open Analytics to review clicks and sources.

ShortURL Import/Export tab

Where: ShortURL Links → Import/Export

Export short links to CSV for backups/reporting and import CSV to create or update links (typically by slug). This supports migrating link sets between environments or managing links in bulk.

ShortURL Import/Export tab

Configuration

  1. Use Export CSV to download your link set.
  2. Prepare a CSV for import (matching expected columns).
  3. Import to create/update by slug, then spot-check critical links.

QR codes and WooCommerce Share Button

Where: ShortURL Links → Settings

Optionally show QR code images in the Share modal and enable a WooCommerce Share button on product pages when a product short link exists. This is designed for fast, consistent sharing on ecommerce sites.

Configuration

  1. Choose QR Provider (or disable external QR endpoints).
  2. Enable WooCommerce Share Button if you want product sharing.
  3. Bulk-generate product short links to auto-enable sharing.
  4. Verify Share button appears only when a mapped short link exists.

Tools & Licensing

Where: AegisLink → Tools & License (or Linking Assistant → Tools & Licensing tab)

Manage license activation and operational health checks. License unlocks PRO features where your UI indicates gating, and health checks help detect broken short link targets safely over time.

Tools & Licensing

Configuration

  1. Open Tools & License.
  2. Enter license key and email used at checkout.
  3. Activate License and confirm status.
  4. Use Health Checks to Run Now, Reschedule Daily, or Disable Schedule.

Health Checks (Short Links)

Where: Tools & License → Health Checks

Runs daily (small batch by default) to validate a subset of short link targets without overloading shared hosting. Broken links can be flagged so you can update targets or remove dead links.

Important: Health checks use WP-Cron. On low-traffic sites, consider configuring a real server cron to trigger WP-Cron reliably.

Configuration

  1. Set batch size per run (default is safe).
  2. Reschedule Daily to enable background checks.
  3. Use Run Now after big updates or imports.
  4. Review Manage tab for any flagged/broken items.

Operational checklists

Smart Links rollout (safe process)

  1. Start with 5–10 high-value keywords (products, services, flagship docs).
  2. Use one-word keywords and avoid generic terms (example: avoid “best” or “click”).
  3. Enable site-wide and test 3–5 representative pages (blog, landing page, product page).
  4. Confirm existing links are not being altered and that linking looks natural.
  5. Expand rules gradually; review readability after each batch.

ShortURL campaign launch

  1. Set your Short Link Prefix (example: go).
  2. Create slugs that are short and human-readable.
  3. Decide whether to enable tracking (default and/or per-link).
  4. Use Share to copy short links and QR codes (if enabled).
  5. After launch, review Analytics to verify traffic sources and performance.

Word Cloud publishing

  1. Keep defaults unless you have a clear reason to change them.
  2. Publish the shortcode on a page where a “topic map” or keyword overview is useful (blog hub, category landing page, about page).
  3. Preview on mobile and desktop to confirm readability.
  4. If the cloud feels noisy: reduce word limit or increase minimum word length.

Troubleshooting

Symptom: Smart Links are not showing on the front-end

Likely meaning: Smart Links are not enabled, rules were not saved, or the content surface is not being filtered.

  1. Open AegisLinkKeyword Links and confirm “Enable Smart Links site-wide” is enabled.
  2. Confirm at least one rule exists and is saved (keyword + destination URL).
  3. Test a standard post (not cached) and confirm the keyword appears as plain text.
  4. If using a builder, confirm the page output is not bypassing filters; test another page type.

Symptom: Short link shows “expired” or does not redirect

Likely meaning: the short link record is missing/disabled, or the slug does not exist for the configured prefix.

  1. Open ShortURL LinksManage and confirm the slug exists.
  2. Confirm the Short Link Prefix matches the URL you’re testing.
  3. Edit the short link and verify the target URL is valid.
  4. Re-test in an incognito window to avoid cached redirects.

Symptom: Analytics show no clicks

Likely meaning: click tracking is disabled globally or for that specific short link.

  1. Open ShortURL LinksSettings and confirm “Default Click Tracking” is enabled (if desired).
  2. Edit the specific short link and confirm tracking is enabled for it.
  3. Click the short link yourself once to validate logging, then refresh Analytics.

Symptom: Health checks are not running daily

Likely meaning: WP-Cron is disabled or the site has low traffic and cron is not being triggered.

  1. Open Tools & LicenseHealth Checks and click Reschedule Daily.
  2. Click Run Now to confirm the check executes manually.
  3. If the site has low traffic, configure a real server cron to call WP-Cron on a schedule.

Glossary

TermMeaning in AegisLink
Linking AssistantThe main AegisLink admin workspace with tabs for Word Cloud, Keyword Links, ShortURL Links, and Tools & Licensing.
Smart LinksKeyword → URL rules that automatically link matching words across site content when enabled.
KeywordA one-word trigger (case-insensitive) used by Smart Links.
ShortURLA short link on your own domain that redirects to a target URL (example: /go/some-slug).
SlugThe short identifier portion of a ShortURL link (the part after the prefix).
PrefixThe base path used for short links (example: go yields /go/{slug}).
Redirect codeThe HTTP redirect type used when sending visitors to the target (for example, 301 or 302).
Click trackingWhen enabled, records click events so Analytics can report trends and sources.
Health checksBackground validation of a small batch of short link targets to detect broken links safely over time.