Documentation

Marketing query parameters missing in backend requests in AEMaaCS

Last update: Wed Apr 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

In AEM as a Cloud Service, marketing query parameters such as utm_*, cid, and bid are not available to backend servlets or services. The CDN removes these parameters before requests reach the dispatcher or AEM, which impacts server-side logic that relies on them for business processing. To fix this issue, update the CDN configuration to retain marketing query parameters.

Description description

Environment

  • Product: Adobe Experience Manager as a Cloud Service – Sites
  • Scope: Environments created in October 2023 or later (default behavior)

Issue/Symptoms

  • Marketing and campaign-related query parameters such as utm_source, cid, and bid appear in browser requests.
  • These query parameters do not reach backend servlets or services.
  • Server-side logic cannot access the marketing query parameter values.

Resolution resolution

To fix this issue, follow these steps:

  1. Open the cdn.yaml configuration file for the affected environment.
  2. Locate the section related to requestTransformations.
  3. Set the removeMarketingParams flag to false under requestTransformations.
  4. Save and commit the updated configuration to your repository.
  5. Deploy the updated cdn.yaml file by using the environment’s configuration pipeline.
  6. After deployment completes, confirm that backend servlets and services receive the marketing query parameters.

Notes:

  • This behavior applies by default only to environments created in October 2023 or later. Older environments require explicit enablement.
  • Client-side scripts running in browsers continue to access marketing query parameters because removal occurs only at the CDN level.
  • Adobe recommends handling marketing parameters on the client side or passing them through the request body or custom headers when backend processing requires them.
  • No global enforcement date exists for environments created before October 2023. Enable this behavior manually when needed.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f