This guide helps you recognize and fix common image issues in translated languages. Find the issue that matches what you are seeing, then follow the steps to resolve it.


In case none of this helps, don't hesitate to reach out to us at support@langify-app.com.



The translated image appears broken


Instead of the translated image, you see a broken image icon in your storefront:


Example of a broken image on a storefront page


Possible cause: The original file name is too short


Very short file names (for example, 1.png or 234.png) can sometimes cause unexpected behavior.

  1. In your Shopify admin, go to Content -> Files.
  2. Open the original image and rename it to something longer and descriptive, such as product-image-01.png.
  3. In langify, go to the item where you translated the image and upload the translated image again.


Possible cause: The translated image was removed or renamed

  1. In langify, open the product, collection, or article where you translated the image and go to the Images section.
  2. If the translated image is no longer available, langify will show it as broken like this:

Example of a broken translated image in the langify Images section

  1. Click the red Clear Image button.
  2. Upload the translated image again. This will also add it to your Shopify Files section.


If you translated the image via Custom Content instead of the Images section, upload the translated image manually to your Shopify Files section, then update the Custom Content translation with the new link.


Please take care not to delete or rename images in the Shopify Files section that are used for translation.



The translated pages still show the original image


You have translated an image in langify's Images section or via Custom Content, but the storefront still displays the original.


Solution A: Make sure langify is published


Images translated in langify's Images section only apply if langify is published. See Publishing langify for instructions, then check the page again.


Solution B: Enable the Image Translation setting

  1. In langify, go to Dashboard -> Theme Settings -> Advanced Settings.
  2. Check that the Image Translation option is enabled. It is on by default but may have been turned off accidentally.

Screenshot showing the Image Translation option in langify Advanced Settings



The image field for a product is empty in langify


You want to edit or remove an image translation, but the image area for the item is empty in langify.


Solution: Find where the image is being translated


The image may be shared across multiple items and translated on a different product or collection.

  1. In Shopify, go to Content → Files.
  2. Find the image and click References to see all items that use it.

Screenshot showing the References link in Shopify Files


  1. In langify, check the Images sections of those items to find where the translation is set.



The translated pages still show an old version of the image


You updated an image in the Shopify Theme Customizer, but the old version still appears on translated pages.


Solution: Remove the outdated translation in langify

  1. In langify, go to Online Store -> Theme.
  2. Search for the name of the new image.
  3. Remove the existing translation.
  4. After a few seconds, check the translated pages to confirm the updated image is now showing.



The article image translation suddenly stopped working


You recently edited a text on your article in the Shopify admin and now the image no longer translates.


Solution: Find the article in langify and open it to trigger a re-sync


Unfortunately, Shopify may update the URL of the original article image whenever there is any change to the article. Opening the article in langify will prompt langify to re-sync the article's image. Afterwards your image translation should work again in all languages.