Scroll Sites
Scroll Sites
Breadcrumbs

A Context Key Link Opens Page Not Found

If a context key link opens Page Not Found even though the page is published in Confluence, this article explains how to fix it.

Symptoms

  • A context key link you just created opens Page Not Found.

  • The page exists and is published in Confluence, but its link doesn't resolve on your site.

  • The link worked before and has stopped working.

Cause

A context key link resolves against your published site, not against Confluence. Until the page and its context key are part of a successful site update, your site has nothing to resolve the link to.

If the link still fails after an update, something is keeping the page out of the published site.

Solution

Update your site and wait for it to finish

Context key changes don't trigger a live update automatically. You need to start the update yourself.

If you are using Manual Updated:

  1. Open your site in My Sites.

  2. Select Update site.

  3. Wait for the update to finish, then test the link again.

If you are using Live Updates, trigger a manual full-site update.

Don't test while an update is still running. You can check progress on the Site updates screen.

Check the page is in the right site and content source

Confirm that the page belongs to a content source that's part of the site you're linking to. A page that's published in Confluence but not included in the site's content sources never appears on the site.

Check the parent pages too. If a parent isn't published or isn't included, its children may not be reachable.

Rule out labels and restrictions

Three labels keep a page out of your published site, and any of them will break a context key link:

  • scroll-sites-no-publish removes the page from the site entirely.

  • scroll-sites-only-url keeps the page reachable by direct URL but takes it out of navigation and search.

  • scroll-help-center-exclude-page excludes the page from the help center.

Confluence view restrictions have the same effect. If the app's user can't see the page, the page can't be published. See App Access to Confluence Spaces and Content.

Check the URL path and capitalization

Compare the link against the page's current path on your site. Scroll Sites URLs are case-sensitive, so /My-Page and /my-page aren't the same address.

If you built the link by hand, check that you appended the key to the correct content source URL and removed the language code, as described in Generate Stable Links (Context Keys).

After you make a change

Any fix you make in Confluence, whether removing a label, lifting a restriction, or moving a page, needs another site update before it takes effect. Run the update and test the link again.

Still Having Issues?

If the link still fails after a successful update, contact our support team. Send us your Confluence base URL, your Site ID, the context key, and the full URL that returns Page Not Found.

Last updated: