> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gistmag.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Integration - Alt Text

> Automatically generate alt text for Shopify product images

## Overview

The GistMag Shopify app automatically generates AI-powered alt text for product images in your Shopify store, improving accessibility and SEO.

<Card title="Install Shopify App" icon="store" href="https://apps.shopify.com/gistmag">
  Install from Shopify App Store
</Card>

## Features

* **Automatic Generation**: Generate alt text when products are created or updated
* **Bulk Processing**: Process all product images at once
* **Product Image Support**: Works with all product images
* **SEO Optimization**: SEO-optimized alt text for better search rankings
* **Accessibility**: Improves store accessibility for screen readers

## Installation

### From Shopify App Store

1. Log in to your Shopify admin
2. Go to **Apps** → **App and sales channel settings**
3. Click **Shopify App Store**
4. Search for "GistMag"
5. Click **Add app**
6. Click **Install app**

### Configuration

1. After installation, go to the GistMag app in your Shopify admin
2. Connect your GistMag account or create a new one
3. Configure settings:
   * **Auto-generate**: Enable automatic generation for new products
   * **Default Mode**: Choose Short, Long, or SEO mode
   * **Language**: Select default language
4. Click **Save**

## Usage

### Automatic Generation

When enabled, alt text is automatically generated when:

* New products are created
* Product images are added
* Products are updated

### Manual Generation

1. Go to **Products** in your Shopify admin
2. Click on a product
3. Scroll to the **Images** section
4. Click **Generate Alt Text** on any image
5. Choose your mode and click **Generate**

### Bulk Processing

1. Go to the GistMag app in your Shopify admin
2. Click **Bulk Process**
3. Select products or all products
4. Choose mode and language
5. Click **Start Processing**

## Mode Guide

### Short Mode

* **Best for**: Product thumbnails, gallery images
* **Length**: 50-100 characters
* **Example**: "Blue cotton t-shirt"

### Long Mode

* **Best for**: Main product images, detailed shots
* **Length**: 100-200 characters
* **Example**: "Blue cotton t-shirt with round neck and short sleeves, displayed on a white background"

### SEO Mode

* **Best for**: All product images (recommended)
* **Features**: Includes product keywords and attributes
* **Example**: "Blue cotton t-shirt - men's casual wear - summer clothing"

<Info>
  SEO mode is recommended for Shopify stores as it helps improve search engine rankings while maintaining accessibility.
</Info>

## Pricing & Limits

The Shopify integration uses your GistMag subscription credits. Check your usage in the GistMag app or your [Dashboard](https://gistmag.co.uk/dashboard/analytics).

## Troubleshooting

### Alt text not generating

* Verify your GistMag account is connected
* Check your API usage limits
* Ensure product images are accessible

### App not working

* Check that the app is installed and active
* Verify your GistMag account connection
* Contact support if issues persist

## Support

For Shopify-specific issues, contact [GistMag Support](mailto:support@gistmag.co.uk).

For general API questions, see the [API Documentation](/api-reference/introduction).