Configure the Global Maximum Replacements Per Request

Maximum replacements per request is QCDR's hard request-wide ceiling on actual runtime substitutions. It limits the combined work performed by enabled Rules and the later standalone Token pass on one rendered frontend page.

The QCDR 1.1.05 default is 10,000 replacements.

Where to Configure It

  1. Open Components > QC Dynamic Replacer > Settings.
  2. In Runtime Safety, locate Maximum replacements per request.
  3. Enter the request-wide ceiling you want.
  4. Save Settings and test representative pages.

Allowed Range

  • Minimum: 1
  • Default: 10,000
  • Maximum: 100,000

QCDR clamps both the saved setting and runtime value to that range.

How the Global Ceiling Interacts with Rule Limits

Each Rule can also have its own Maximum replacements value. A positive per-Rule value trims that Rule's selected occurrences first. Then the global request-wide ceiling limits whatever capacity remains across later Rules.

If a Rule has 0 as its per-Rule maximum, it adds no extra Rule-specific cap; the global ceiling still applies. Once the request total reaches the global maximum, QCDR stops running additional Rule replacements.

Standalone Tokens Share the Same Request Budget

Standalone Token placeholders resolve after Rules. They can use only the replacement capacity still available for that request. If Rules consumed the full global limit, QCDR leaves later standalone Token placeholders untouched rather than exceeding the configured ceiling.

Matches Are Not the Same as Replacements

A Rule can find more matches than QCDR ultimately replaces. Occurrence selection, protected areas, unavailable Token output, the per-Rule limit, and the global remaining budget can all reduce the actual replacement count.

When troubleshooting a broad Rule, do not increase the global limit just because a page contains many matches. First confirm that the Rule is intentionally that broad.

Choose a Conservative Production Value

The 10,000 default is intentionally generous for normal pages while still providing a runaway ceiling. Lower it if your site needs a tighter safety boundary. Raise it only for a verified workflow that legitimately needs more substitutions, and Preview broad Rules before enabling them.

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.