Use a Direct Replacement Value or a Reusable QCDR Token

A QCDR Rule can use either a value stored directly in the Rule or a reusable QCDR Token as its replacement source. The choice determines whether the Rule owns its replacement content or stays linked to centrally managed Token content.

Enter a Value

Choose Enter a value when the replacement belongs only to this Rule. Select the appropriate Replacement type and enter the content in the Rule editor. This is the simplest choice for one-off text, HTML, URLs, CSS, JavaScript, or another currently supported direct replacement type.

Use a QCDR Token

Choose Use a QCDR token when several Rules should reuse one centrally managed value. Select the Token from the list. QCDR stores the Token name as a dependency, so changing that Token later changes what every linked Rule resolves at runtime.

If no Tokens exist yet, save the Rule as Draft, create the Token on the Tokens tab, then return and select it.

Plan Requirements Follow the Dependency

A Rule cannot use a Token whose required tier is above the current Effective tier. QCDR also checks Token dependencies that appear inside a direct replacement value. Existing paid dependencies are preserved across a downgrade, but they do not become usable merely because the saved Rule remains in the database.

Unavailable Tokens Fail Safely

At runtime QCDR verifies that a replacement Token exists and qualifies for the same request context. If the Token is unavailable because of its own targeting, schedule, tier, or a failed PHP Token resolution, QCDR skips that replacement and leaves the administrator-authored original match intact rather than replacing it with blank output.

Which Source Should You Choose?

  • Use a direct value for Rule-specific content that should change only when that Rule is edited.
  • Use a Token for shared branding, contact information, reusable markup, dynamic Joomla data, or other values that should have one source of truth.
  • Test a linked Token under the same page/audience conditions as the Rule, because both objects must qualify for the replacement to occur.

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.