How can I utilize the ALT text field in my theme settings?

Store Design

Topic summary

Main issue: How to access and use the ALT text entered for images stored in the Shopify Files admin (/admin/settings/files) within a theme.

Details:

  • The poster noticed an ALT text field when clicking an image in the Files admin and wants to use that value in Liquid.
  • Currently retrieves image URLs using the Liquid filter file_img_url (e.g., {{ 'image.png' | file_img_url: '100x100' }}).
  • Knows how to set/get ALT text for product images and image fields via the Theme Customizer, but cannot find a method or documentation for retrieving ALT text for files from the Files admin.

Context/terms:

  • ALT text: alternative text for images used for accessibility and SEO.
  • file_img_url: Shopify Liquid filter to generate image URLs from files.

Status:

  • No answers or solutions provided yet; documentation reference requested.
  • A screenshot of the Files admin ALT field is central to the question.
Summarized with AI on February 23. AI used: gpt-5.
1

Apologies if this has been asked before, I have looked through the forums and on Google and nothing has come up so far.

Today I noticed the ALT text field when you click on an image in /admin/settings/files for the first time.

Screenshot 2022-02-10 at 16.36.45.png
Screenshot 2022-02-10 at 16.36.45.png1282×394 21 KB

Can anyone point in the direction of how to actually use this in my theme?

I am using the file_img_url filter to get the URL of an image such as

{{ 'image.png' | file_img_url: '100x100' }}

But how do I get the ALT text field from the Files admin page?

I know how to get the ALT on product images and image fields in the Customizer, but I can’t find any documentation relating to getting it for images in the Files admin page.