Folder name normalization differences in AEM Assets new UI
Folder names with spaces are handled differently in the new Adobe Experience Manager (AEM) Assets UI than in the classic UI. Use hyphens instead of spaces in folder names to keep repository paths and naming consistent.
Description description
When creating folders in AEM Assets, the way folder names are handled differs between the classic/Author Assets UI and the new Assets UI. In the classic UI, spaces in folder names are automatically replaced with hyphens, resulting in sanitized JCR node names and repository paths (for example, Content Hub becomes content-hub). In the new Assets UI, spaces are retained in the folder name and path, which means repository paths and URLs may contain encoded spaces (displayed as %20 in browsers). This can make paths harder to reference, copy, or troubleshoot, and may lead to inconsistent naming conventions across your Digital Asset Management (DAM) folders.
Resolution resolution
Follow these steps to keep folder names consistent.
- Instruct authors to enter folder names without spaces (using hyphens instead) when creating new folders in the new Assets UI. For example, use
content-hubinstead ofContent Hub. - For existing folders with spaces, use the Rename action in the new Assets UI to update folder names as needed. Before renaming, review any integrations or references to the current path and test changes in a lower environment to avoid disruptions.
- If you require sanitized (hyphenated) paths for key folders, consider creating those folders using the classic/Author Assets console, which automatically normalizes folder names. Authors can then use the new Assets UI for daily asset management within those folders.
- After making changes, verify that folder paths appear as expected in the repository and that all references and integrations continue to function correctly.