AegisLink User Guide
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.
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
- 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)
- Open AegisLink → Linking Assistant → Keyword Links
- Add 5–20 Smart Links (keyword → URL) for your key products/pages
- Enable Smart Links site-wide
- Review a few posts/pages to confirm linking looks natural
Create campaign short links (10–15 minutes)
- Open ShortURL Links tab
- Create a short slug and target URL
- Use Share to copy the short link (and QR if enabled)
- Optionally enable tracking and review Analytics
Publish a Word Cloud block (5–10 minutes)
- Open Word Cloud tab and review defaults
- Copy the shortcode and paste it into a page/post/builder shortcode element
- 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.
Configuration
- Upload the AegisLink ZIP in WordPress.
- Activate the plugin.
- 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
- Open AegisLink → Linking Assistant.
- Use the top tabs to switch modules.
- 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.

Configuration
- Open Word Cloud tab.
- Review defaults (word limit, min/max length, font sizes).
- Copy the shortcode block and paste it into a page/post/builder shortcode element.
- Preview and tune limits only if needed.
Keyword Links (Smart Links: Keyword → URL)
Where: AegisLink → Linking Assistant → Keyword Links
Create one-word keywords that automatically link across your site content. Smart Links help you standardize internal linking to cornerstone pages (products, services, documentation) without editing every post manually.

Configuration
- Open Keyword Links tab.
- Add Smart Links rows: one-word keyword + destination URL.
- Enable Smart Links site-wide.
- Review a few pages to confirm linking feels natural.
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
- In Keyword Links, select a Page or Post.
- Review Suggestions for that content.
- 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.

Configuration
- Open ShortURL Links tab.
- Review Settings (prefix, default redirect code, tracking defaults).
- Create short links in Manage tab.
- 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
- Click “Edit Short Link” (or create new).
- Set target URL and slug.
- Choose redirect code and tracking (per-link overrides if needed).
- 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.

Configuration
- Open Bulk tab.
- Choose the bulk action (generate/create as provided by your UI).
- Run the bulk operation.
- 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.

Configuration
- Enable tracking (default or per-link).
- Send/share the short link.
- 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.

Configuration
- Use Export CSV to download your link set.
- Prepare a CSV for import (matching expected columns).
- 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
- Choose QR Provider (or disable external QR endpoints).
- Enable WooCommerce Share Button if you want product sharing.
- Bulk-generate product short links to auto-enable sharing.
- 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.

Configuration
- Open Tools & License.
- Enter license key and email used at checkout.
- Activate License and confirm status.
- 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.
Configuration
- Set batch size per run (default is safe).
- Reschedule Daily to enable background checks.
- Use Run Now after big updates or imports.
- Review Manage tab for any flagged/broken items.
Operational checklists
Smart Links rollout (safe process)
- Start with 5–10 high-value keywords (products, services, flagship docs).
- Use one-word keywords and avoid generic terms (example: avoid “best” or “click”).
- Enable site-wide and test 3–5 representative pages (blog, landing page, product page).
- Confirm existing links are not being altered and that linking looks natural.
- Expand rules gradually; review readability after each batch.
ShortURL campaign launch
- Set your Short Link Prefix (example:
go). - Create slugs that are short and human-readable.
- Decide whether to enable tracking (default and/or per-link).
- Use Share to copy short links and QR codes (if enabled).
- After launch, review Analytics to verify traffic sources and performance.
Word Cloud publishing
- Keep defaults unless you have a clear reason to change them.
- Publish the shortcode on a page where a “topic map” or keyword overview is useful (blog hub, category landing page, about page).
- Preview on mobile and desktop to confirm readability.
- 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.
- Open AegisLink → Keyword Links and confirm “Enable Smart Links site-wide” is enabled.
- Confirm at least one rule exists and is saved (keyword + destination URL).
- Test a standard post (not cached) and confirm the keyword appears as plain text.
- 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.
- Open ShortURL Links → Manage and confirm the slug exists.
- Confirm the Short Link Prefix matches the URL you’re testing.
- Edit the short link and verify the target URL is valid.
- 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.
- Open ShortURL Links → Settings and confirm “Default Click Tracking” is enabled (if desired).
- Edit the specific short link and confirm tracking is enabled for it.
- 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.
- Open Tools & License → Health Checks and click Reschedule Daily.
- Click Run Now to confirm the check executes manually.
- If the site has low traffic, configure a real server cron to call WP-Cron on a schedule.
Glossary
| Term | Meaning in AegisLink |
|---|---|
| Linking Assistant | The main AegisLink admin workspace with tabs for Word Cloud, Keyword Links, ShortURL Links, and Tools & Licensing. |
| Smart Links | Keyword → URL rules that automatically link matching words across site content when enabled. |
| Keyword | A one-word trigger (case-insensitive) used by Smart Links. |
| ShortURL | A short link on your own domain that redirects to a target URL (example: /go/some-slug). |
| Slug | The short identifier portion of a ShortURL link (the part after the prefix). |
| Prefix | The base path used for short links (example: go yields /go/{slug}). |
| Redirect code | The HTTP redirect type used when sending visitors to the target (for example, 301 or 302). |
| Click tracking | When enabled, records click events so Analytics can report trends and sources. |
| Health checks | Background validation of a small batch of short link targets to detect broken links safely over time. |

