GraphQL Persisted Queries not available | Community
Skip to main content
Level 2
June 22, 2026
Question

GraphQL Persisted Queries not available

  • June 22, 2026
  • 5 replies
  • 109 views

i have created the configuration to enable persisted queries for my endpoint but when I am in the query editor, there is a message stating that they are not enabled. What could I be missing?

    5 replies

    Level 1
    July 1, 2026

    Hi ​@RobertSHarper 
    Could you please verify in your Project Configuration Browser whether the GraphQL Persisted Queries option is enabled?
     

     

    Level 2
    July 1, 2026

    Yes, I did and at one point had everything enabled. Still can’t create saved queries.

     

    sarav_prakash
    Community Advisor
    Community Advisor
    July 23, 2026

    Hi ​@RobertSHarper ,

    is this still broken? Few usual suspects:

    1. Tools → Configuration Browser → your config → Properties → is "GraphQL Persisted Queries" checkbox actually checked (not just the endpoint enabled)? As shown below?
    2. Make sure to create the endpoint using Tools → General → GraphQL (endpoint manager). Make sure to Publish endpoint. This is the most common gotcha. AEM strictly looks for persisted queries under the exact /conf/<config-name>/... tree tied to the endpoint you selected in the dropdown — if your queries or settings sit under a different config path, the UI just ignores them. Double check that your endpoint's associated Sites configuration matches the config where you enabled persisted queries — a global endpoint vs. a site-specific endpoint pointing to different /conf paths is a frequent cause.  read this post
    3. Does your endpoint's dropdown selection match the same /conf/<name> path where you enabled persisted queries?
    4. If you manually created any persisted query nodes in CRXDE rather than through GraphiQL's "Save As" — that's a known way for AEM to silently fail to load them due to wrong JCR node types. 
    5. Sometimes creating in jcr nodes might break. Make sure the path convention is /conf/<config-name>/settings/graphql/persistentQueries — if this node doesn't exist under your specific config (or was created manually with wrong node types rather than through the GraphiQL "Save As" flow), AEM can silently fail to recognize it.

     

    #2 could be the cause.

    Shashi_Mulugu
    Community Advisor
    Community Advisor
    July 23, 2026

    Hi ​@RobertSHarper ,

     

    ​Adding to what's been shared, a few deeper technical edge cases to check if your /conf toggle is already enabled:

    ​User ACLs on /conf: Ensure your user account explicitly has Read + Write permissions under /conf/<your-project>/settings/graphql/persistentQueries. If your account lacks write access to create JCR nodes under /conf, GraphiQL won't allow query persistence.

    ​Dispatcher / Filter Blocks: If you are testing this on a Stage/Dev environment with a Dispatcher in front, verify your Dispatcher rules allow traffic to /graphql/execute.json and the /conf query paths. A 403 or 404 on background pre-flight requests causes the editor to display the "Not Available" warning.

    ​OSGi Service Configuration: Check /system/console/configMgr for GraphQLPersistedQueriesOperationServiceImpl to ensure HTTP execution methods (GET/POST) aren't restricted or misconfigured.

    ​AEM SDK / Local Bundle Refresh: If testing on a local SDK, try refreshing the GraphiQL client bundle or re-saving the configuration. The GraphiQL OSGi servlet sometimes caches the initial "disabled" state until a bundle refresh or instance restart occurs.

    MasonReed11
    Level 2
    July 27, 2026

    Check that the persisted queries setting is enabled for the same endpoint and environment your query editor is using. Also try restarting/redeploying after changing the configuration, as the update may not have loaded yet.