PassiveWP logo
Help CenterTroubleshooting / Links and Tracking

Branded Link Slug Rejected

Step-by-step help for troubleshooting / links and tracking, including where to click, what to change, and how to confirm it worked.

Troubleshooting / Links and Tracking4 guided stepsCtrl/Cmd + K search
Ctrl/Cmd + K

Branded Link Slug Rejected

Troubleshooting / Links and Tracking

How this article is organized
Go hereUse the route chips to see the exact menu path before you click.
Do thisFollow the action callout to make the change without extra guesswork.
ConfirmUse the verification cue to make sure the fix actually worked.

New link cannot be saved because slug/path is invalid.


Where to Check in PassiveWP

WordPress Admin -> PassiveWP -> Branded Links -> My Links

Step-by-Step Fix Walkthrough

Fix Step 1: Use lowercase letters, numbers, and hyphens only.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In WordPress AdminPassiveWPBranded LinksMy Links, do this in order: open the relevant panel, find the control related to "Use lowercase letters, numbers, and hyphens only.", apply one change, click Save/Run, then reload once to confirm it stuck.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 2: Avoid paths similar to wp-admin, wp-json, login, and other system routes.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In WordPress AdminPassiveWPBranded LinksMy Links, do this in order: open the relevant panel, find the control related to "Avoid paths similar to wp-admin, wp-json, login, and other system routes.", apply one change, click Save/Run, then reload once to confirm it stuck.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 3: Choose a unique campaign-specific slug and retry.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In Basics, set "Branded URL" with a unique lowercase slug (no query/hash), then continue when validation passes.

Confirm Private-window click tests should route correctly and keep required attribution params.

Fix Step 4: Adopt a consistent naming convention to avoid collisions.

Go here WordPress AdminPassiveWPBranded LinksMy Links

Do this In WordPress AdminPassiveWPBranded LinksMy Links, do this in order: open the relevant panel, find the control related to "Adopt a consistent naming convention to avoid collisions.", apply one change, click Save/Run, then reload once to confirm it stuck.

Confirm Private-window click tests should route correctly and keep required attribution params.

Most Common Causes

  • Slug conflicts with reserved WordPress paths.
  • Slug contains unsupported characters or query/hash fragments.
  • Slug already exists in another link.

How to Prevent It Next Time

  • Keep a campaign slug registry.
  • Use structured naming per channel/date/topic.
  • Reserve short premium slugs for evergreen campaigns.

When to Contact Support

  • You completed every fix step and still get the same error.
  • The issue impacts revenue-critical pages or high-volume campaigns.
  • You can share timestamps, affected link/product IDs, and screenshots of the exact error state.

Was this article helpful?

Ready to build better affiliate pages and get more from your traffic?

Build cleaner money pages, keep product data fresh, and know what to improve next without stacking more tools on top of WordPress.

PassiveWP dashboard overview