## **🔍 Overview**

When you run the **Content-Build Internal Links** playbook, you may receive a completion report but find that no internal links were actually inserted into your target pages. This article explains the most common causes and the steps you can take to fix the issue.

## **⚠️ Why This Happens**

The internal links playbook relies on data stored in your **BrandVault** to identify which URLs to link to. If that data is missing, incomplete, or not yet populated, the agent has nothing to work with and will silently skip the insertion step — even though the task is marked as complete. The most common root causes are:

- **Empty internal links fields in BrandVault** — The agent requires populated URL and anchor-text data. If these fields are blank, no links are inserted.
- **No valid page paths detected** — The playbook needs resolvable page paths. URLs that are missing, malformed, or return errors are ignored.
- **Article Refinement conflict** — If you requested internal links through an Article Refinement step rather than a dedicated internal-links step, the links may not be inserted correctly.
- **Stale or cached project data** — Occasionally, outdated project data causes the playbook to act on old information.

## **🛠️ How to Fix It**

1. **Check your BrandVault internal links fields.** Navigate to your BrandVault settings and confirm that the internal links section contains valid URLs and corresponding anchor text. Every URL must be a complete, working path.
2. **Refresh your project data.** Go to **Left sidebar → Home → [project] (Executive Summary)** and click **Refresh Summary**. Wait for the refresh to complete before re-running the playbook.
3. **Re-run the internal links playbook.** After confirming BrandVault data is populated and your project data is fresh, open your playbook and run the **Content-Build Internal Links** step again. Check the target pages once the completion report appears.
4. **Avoid using Article Refinement as a substitute.** If you need internal links inserted, use the dedicated internal-links playbook step rather than requesting them through an Article Refinement prompt. These are separate processes and produce different results.
5. **Verify page paths are valid.** Review the URLs listed in your BrandVault and confirm each one resolves correctly. Remove or correct any broken, redirected, or incomplete paths.

## **✅ How to Confirm Links Were Added**

After re-running the playbook, open each target page in the Content Builder and review the body content for inserted anchor links. Do not rely solely on the completion report — always inspect the page content directly to verify the links are present.

## **🚫 Known Limitations**

- The agent does not insert links if **all** internal link fields in BrandVault are empty. There is no partial insertion — it is all or nothing based on available data.
- Links requested through **Article Refinement** follow a different insertion path and may not be added even if BrandVault data is complete. Use the dedicated playbook step instead.
- Newly added BrandVault URLs may take a moment to be recognised. Always refresh project data before running the playbook after making BrandVault changes.

## **💬 Still Need Help?**

If you have followed all the steps above and internal links are still not being inserted, If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be connected with a member of our team.