I Built a Free Alt Text Scanner for Shopify — and the Hardest Part Was the Compliance
I shipped a free tool that scans any Shopify storefront and tells the owner how many product images are missing alt text. No install, no OAuth, no signup — you type a domain and get a number back in a few seconds. The scanning logic took an afternoon. The compliance work took longer, and it changed the design three times. Here's what actually happened. Why build a scanner at all I run a small…
A free tool has been created to scan Shopify storefronts and identify product images lacking alt text. The scanning process takes just a few seconds, requiring no installation or signup – users only need to enter the store's domain. The tool's development process involved two crucial steps: overcoming compliance challenges and refining the scanning logic. The compliance work proved more challenging and required several design changes, ultimately resulting in a more accurate and respectful scanning process.
The main challenge was ensuring the scanner adhered to all requirements set forth by the store owners. Initially, the scanner attempted to access the store's data and analyze the JSON data from the /products.json endpoint. However, it quickly discovered that this method could produce false positives, leading to a loss of trust. To resolve this, the scanner was redesigned to analyze the rendered product pages instead, providing a more accurate ratio of images with descriptive alt text. This ratio is labeled as sampled and not exact, ensuring honesty in the results presented.
Another significant hurdle was respecting the store's wishes and avoiding any potential legal issues, such as being blocked, complained about, or sued. The solution was to read the robots.txt file before accessing any store data. If the robots.txt file indicated that automated tools were not allowed to scan the store, the scanner would stop immediately and display a message explaining the restriction. This approach respects the store's preferences and avoids potential legal complications.
Lastly, the scanner had to handle HTTP 429 responses, which are returned when Shopify temporarily rate-limits automated requests to a store. The scanner now recognizes and communicates this outcome appropriately, informing users that Shopify is limiting automated requests and suggesting they wait briefly before retrying. This thoughtful approach prevents users from misinterpreting rate limits as store errors, ensuring a smoother user experience.
In summary, the development of this free alt text scanner for Shopify storefronts involved navigating compliance challenges, refining the scanning logic for accuracy, and respecting store owners' preferences and wishes. The result is a tool that helps store owners identify product images without alt text, ultimately improving accessibility and user experience for their customers.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.