Unlock seamless workflows and faster delivery with our latest releases - Join the deep dive

How to request an image from Sanity with its original filename instead of a hash

3 replies
Last updated: Jul 7, 2022
Hi, how can I request an image from Sanity with its original filename instead of a hash?
For example, I want to have a url like
<https://cdn.sanity.io/images/1234567/production/[here-the-original-filename-instead-of-the-hash]-1766x1065.png?q=75&fit=clip&auto=format>
instead of
<https://cdn.sanity.io/images/1234567/production/754c8d64997b668642bd2500f833722c6293cf8b-1766x1065.png?q=75&fit=clip&auto=format>

I only found the
&dl
param in the docs but this doesn’t solve the problem as it’s only for downloading the file and the url would still contains the hash instead of the file name.
My goal is to have a better image URL to follow
Google Images best practices for SEO
Create good URL structure for your images: Google uses the URL path as well as the file name to help it understand your images. Consider organizing your image content so that URLs are constructed logically.
Jul 6, 2022, 10:24 AM
Hi
user T
, we currently support ‘vanity filenames’, which should be more user and SEO friendly than using the hash alone.
This lets you add e.g.
/someFilename.png
after the hashed file name at the end of an image/file URL, while the usual parameters continue working (e.g. webp format support in case of images).
General format:

<https://cdn.sanity.io/images/><projectId>/<dataset>/<hashedFileName>/<originalFilename>?<params>
Example:

<https://cdn.sanity.io/files/5fe89r5x/production/a123456789bb123cd1e1fgh123h1i123456j1234k1.jpg/my-friendly-image-name.jpg>
The exact implementation will depend on how you currently build the image URLs, but could be a matter of querying and appending the original file name or any other field you’ve designated for these more friendly file names.
Jul 6, 2022, 12:29 PM
Thanks!! That should do the job. Wasn’t able to find this in the docs.
Jul 6, 2022, 3:41 PM
With pleasure! Sometimes things are a little buried, that’s why we are here 😉. But I think there might be a need for a guide or doc article about SEO practices … until then good building! 💪
Jul 7, 2022, 1:46 PM

Sanity– build remarkable experiences at scale

Sanity is a modern headless CMS that treats content as data to power your digital business. Free to get started, and pay-as-you-go on all plans.

Was this answer helpful?