Why do components use the old name of content fragments even though they were renamed? | Community
Skip to main content
S
smckinley
October 15, 2025
Solved

Why do components use the old name of content fragments even though they were renamed?

  • October 15, 2025
  • 4 replies
  • 351 views

We renamed some content fragments but when we go to the component using those fragments, the old names still appear. What can we do to refresh them? Please help! 

Best answer by Syed_Shaik

Hi @smckinley 

 

Verify if the CF path changed

  • Open CRXDE Lite or Developer Mode → Inspect Component.

  • Check the property that stores the CF reference (like fragmentPath or fileReference).

  • If it still points to the old name/path, you’ll need to re-link the fragment.

  • Re-link the updated fragment

    • Edit the component in Author mode.

    • Open the Content Fragment selector and reselect the renamed CF.

    • This forces AEM to refresh the reference and metadata.

  • Clear any caches

    • If your component or model uses GraphQL, content fragment lists, or experience fragments, clear the GraphQL cache.

    • On AEM as a Cloud Service, you can trigger cache invalidation using the Developer Console or the /_api/graphql flush endpoint.

  • Republish fragments

    • Republish the renamed CFs to ensure both the author and publish environments have the latest metadata.

  • (Optional) Find and fix old references

    • If several fragments were renamed, run a Query Builder query to locate outdated references

       

4 replies

SantoshSai
Community Advisor
SantoshSaiCommunity Advisor
Community Advisor
October 15, 2025

Hi @smckinley,

Mostly likely becuse of stores the reference metadata.

Here is what you can do: 

1. Check if the path actually changed

Go to CRXDE Lite or use Developer Mode -> Inspect the component.

  • Look for the property that references your CF (usually something like fragmentPath or fileReference).

  • If it still points to the old path, you’ll need to manually reselect the CF.

2. Re-link the fragment

Edit the component in author mode -> re-open the Content Fragment selector -> choose the newly renamed fragment.
This refreshes the stored path and updates metadata references.

3. Clear caches

If you’re using GraphQL models, Content Fragment Lists, or Experience Fragments:

  • Clear or invalidate the cache.

  • For AEMaaCS, you can also use /_api/graphql cache flush from Developer Console.

4. Republish the renamed fragments - Sometimes the publish environment still holds the old metadata.

5. Just in case Run a query to find old references

If you renamed multiple CFs and need to bulk fix them:
Use a QueryBuilder query like:

path=/content
property=fragmentPath
property.value=/content/dam/old-folder-name
p.limit=-1

Then update references via Groovy script or manually.

Santosh Sai
    Syed_Shaik
    Syed_ShaikAccepted solution
    Level 3
    October 16, 2025

    Hi @smckinley 

     

    Verify if the CF path changed

    • Open CRXDE Lite or Developer Mode → Inspect Component.

    • Check the property that stores the CF reference (like fragmentPath or fileReference).

    • If it still points to the old name/path, you’ll need to re-link the fragment.

    • Re-link the updated fragment

      • Edit the component in Author mode.

      • Open the Content Fragment selector and reselect the renamed CF.

      • This forces AEM to refresh the reference and metadata.

    • Clear any caches

      • If your component or model uses GraphQL, content fragment lists, or experience fragments, clear the GraphQL cache.

      • On AEM as a Cloud Service, you can trigger cache invalidation using the Developer Console or the /_api/graphql flush endpoint.

    • Republish fragments

      • Republish the renamed CFs to ensure both the author and publish environments have the latest metadata.

    • (Optional) Find and fix old references

      • If several fragments were renamed, run a Query Builder query to locate outdated references

         
      muskaanchandwani
      Adobe Employee
      muskaanchandwaniAdobe Employee
      Adobe Employee
      October 16, 2025

      Hello @smckinley 

      Which component is being used to reference the Content Fragment? OOTB or custom?

      In AEM 6.5, if the fragments were renamed using the Move option in Assets, only the node name (path) is updated - the Title (jcr:title) remains unchanged. So the components referencing the fragment may still display the old title.

      Where exactly you’re seeing the old name wrt the Component?

        Heena_Shirke
        Heena_Shirke
        Level 2
        October 20, 2025

        Hi @smckinley , what steps were followed to rename the content fragments?

        Terms & ConditionsAccessibility statement

        Loading footer...