Shopify App

The AltText.ai Shopify App automatically generates optimized alt text for your product and store images. The app is Certified Built for Shopify, meaning it does not slow down your store and has been rigorously tested by Shopify to meet their speed and quality standards.

Installation

From your Shopify Admin

• Go to Apps, and type AltText.ai in the search bar at the top of the popup window.

• Click the AltText.ai listing, then click the Install button on the app page.

  

From the Shopify App Store

• Visit the AltText.ai listing on the Shopify App Store, or just search for AltText.ai in the app store.
• Click on the AltText.ai listing, then click Install to add it to your store.

Setup

On the Settings page, you will connect the Shopify app to your AltText.ai account via an API Key.

1. Click the Connect button, which will take you to your AltText.ai account to select an API key. You may need to login first if you are not already logged in.
2. Select an existing API Key, or just create a new one to use.

3. You will be returned to the Shopify App, and your selected API Key will be connected!

   

Basic Usage

Our Shopify app runs automatically when you add or update a product in your catalog. It will look for any images that are missing alt text, and generate alt text for those images using your product data. Product images with existing alt text are skipped by default.

Say your store sells snowboards, and you add a new blue snowboard product called "Genesis", by the vendor "Board Town". Then you add a product image of a man doing a mid-air jump on the snowboard. The AltText.ai Shopify app will automatically generate alt text for the image and use your product name and brand, so you might get something like: A man doing a jump on a blue Board Town Genesis snowboard.

Alt text is always added in the background, so don't worry if you don't see it immediately. You might need to refresh the product detail page in your browser after a few seconds to pick up the changes.

Updating Existing Products and Images

Updating a Single Product

Our app integrates directly into your Shopify admin so it's easy to update the alt text for an individual product.

1. In the Shopify admin, view the product you want to update.
2. At the top of the page, click the More Actions dropdown.
3. Select AltText.ai - Update Alt Text

4. Optionally enter additional SEO keywords you want to use. If you don't provide keywords, then by default our app will use your product description to get keyword ideas (you can turn this off in the Settings page).

   

Updating Multiple Products at Once

If you have several products you want to update, you can select them from the Shopify admin Products page. Our app allows you to update alt text on selected products from the Products action menu.

1. From the Shopify Admin, go to Products.
2. Check the boxes of the products you want to update.

3. Click the "..." menu, then select Update Alt Text.

   

Bulk Updating All Product Images

The app has a Bulk Update tool which lets you update your existing library of either product images or non-product images (e.g. blog, site, theme images). To start a bulk update, follow these steps:

1. From your Shopify Admin, click on Apps -> AltText.ai -> Bulk Update

2. Click the Configure Catalog Update... button.

   

3. Choose Product images to update your entire catalog of products. By default, the update will only process images that are missing alt text (you can change this in the app Settings).

   

Info

Bulk updates are processed in the background, so it may take a while for your full catalog to be finished (Shopify typically allows only 1-2 updates per second). You will receive an email when the update is done if you chose to be notified of bulk updates in your app settings.

Limiting by Vendor

Our Bulk Update tool lets you restrict catalog updates only to products for a specific vendor. For example, say you need to update only products with the brand/vendor name "Jersey Toys". Here is how you would do that:

1. Before starting the catalog update (shown above), click the Advanced settings... button.
2. Enter the exact vendor name that you want to process. In this example, we would enter Jersey Toys.
3. Start the update and that's it!

Bulk Updating non-Product Images

The Bulk Update tool lets you select either product images or non-product images (e.g. blog, site, theme images). To start an update for non-product images, follow these steps:

1. From your Shopify Admin, click on Apps -> AltText.ai -> Bulk Update

2. Click the Configure Catalog Update... button.

   

3. Choose Other images. This will process all non-product images located in the Shopify Admin: Content -> Files listing.

   

Images in Metafields

If you use metafields to store your product or variant images, our app can process these as well when doing a Bulk Update. We support metafields with the type of File (a single image), or List:File (multiple images). To generate alt text for metafield images, update your app settings as follows:

1. In the Settings: Bulk Updates section, select whether your metafield images are part of your Product metafields, or Variant metafields.
2. Enter the metafield namespace and key for the field which holds your image(s).

Note

Currently metafield images are supported only when doing a bulk update. They are not examined as part of the automatic processing when products are updated or created.

Updating Product Descriptions

If you have images in the HTML of your product descriptions, our Shopify app can generate alt text for those too! Just check the box in the app Settings page to process product descriptions:

Controlling Alt Text for Product Images

Use the app Settings page to control which products are processed for alt text, along with other features. You can skip products which are not active and/or published in your online store, as well as control whether existing alt text is overwritten or skipped.

Including Color Name

AltText.ai can intelligently include your variant color names if they are configured as product options in Shopify. Just check the box to use color values from your product options, and specify the option name that contains the variant color. Here's an example:

1. Find your product option name that represents the variant color:

   

2. Check the box and enter the option name into the color name setting:

   

What Was Processed

There are a few ways to see what has been processed by the AltText.ai Shopify App:

1. Go to the History page in the app submenu in your Shopify admin. This page shows you every product image which has been processed by the app, along with the alt text that was generated. You can edit and update the alt text for any of the images if you want to make adjustments.

   

2. Configure a special tag to be added to all products which are processed by the app:

   

   You can then search for Products in your Shopify admin which contain this tag.

3. Login to your AltText.ai account online, and view your Images library. This will show you the urls of all images processed in your account, along with thumbnail views of the processed images. You should see your product images here, along with the generated alt text.

   Note

   Editing alt text in your online library does not sync back to Shopify. If you need to edit the generated alt text for Shopify images, you will need to do that directly in Shopify.