Use the QCDR Emergency Bypass on a Frontend Request

When a live Rule or Token makes a frontend page difficult to use, a logged-in Super User can add qcdr_bypass=1 to that frontend URL. QCDR recognizes the authorized request and skips normal Rule/Token transformation for that request only.

The bypass does not disable QCDR globally, alter a Rule, change Token state, or turn off the live-processing switches.

Run an Emergency Bypass

  1. Sign in as a Joomla Super User.
  2. Open the affected frontend URL.
  3. Add ?qcdr_bypass=1 if the URL has no query string, or &qcdr_bypass=1 if it already has one.
  4. Load the URL and confirm the page appears without QCDR's normal live transformation.
  5. Open Joomla Administrator and disable/correct the offending Rule, Token, or live-processing scope.
  6. Return to the clean frontend URL without the bypass parameter and retest.

Who Is Authorized

On an ordinary frontend request, QCDR honors the parameter only when the current identity has Joomla core.admin authority for QCDR—normally a Super User. Adding the parameter as a guest or ordinary frontend user does not create a public bypass.

A valid private Rule Preview also treats the bypass as authoritative because the Preview authorization was issued to an authorized Super User. This lets the administrator prove the unmodified page while testing.

What QCDR Does When the Bypass Is Active

The RuntimeEngine stops before Rules or standalone Tokens are applied and returns the original marker-free rendered Joomla output. It does not consume the page's replacement budget or silently change configuration.

Use It as a Recovery Tool, Not a Permanent URL

The bypass is intended to regain a clean request while you repair the actual configuration. Do not publish bypass URLs in menus, bookmarks, marketing links, or monitoring systems as a normal way to run the site.

Remember Upstream Caches

The parameter can help only when the request reaches Joomla/QCDR. A CDN, reverse proxy, or full-page cache may serve previously cached broken HTML before Joomla runs. If that happens, purge/bypass the upstream cache or use its administrative controls in addition to the QCDR bypass.

Community Discussion

Want to compare workflows, share practical tips, or discuss how you use this QCDR feature? Visit the QC Dynamic Replacer Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.