Image & Video APIs

Why shouldn't I use underscore within folder names?

Last updated: Dec-31-2025

Using underscores in folder names can sometimes create ambiguity and result in broken URLs on your website. This occurs because, for example, a folder named u_2 (after the band, of course) could be misinterpreted as an attempt to underlay an asset named "2" under a base asset.

To prevent such issues, consider following at least one of these best practices:

  • Avoid using underscores (_) in folder names. Instead, use hyphens (-) as delimiters.
  • Ensure at least four characters precede the first underscore, e.g., abcd_1234.
  • Use versioning to separate the public ID from the transformation section.

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars