Documentation

Variants Description Pro is a Shopify app that allows merchants to create unique, SEO-optimized descriptions for every product variant. The app includes:

• Rich Text Editor - Format descriptions with bold, italic, lists, and more
• AI Generation - Automatically create unique descriptions using AI
• Multi-Language Support - Translate descriptions using Shopify's native Translations API
• Theme Blocks - Display descriptions on your storefront without coding
• SEO Fields - Meta titles and descriptions for each variant
• Automation - Auto-process new products in the background

Requirements

• Shopify store (any plan: Basic, Shopify, Advanced, or Plus)
• Online Store 2.0 compatible theme (for theme blocks)

Install Steps

1. Visit the Shopify App Store and search for "Variants Description Pro"
2. Click "Add app" to begin installation
3. Authorize the required permissions (read/write products, metafields)
4. The app will be added to your Apps section in Shopify admin

Required Permissions

• read_products - Access product and variant information
• write_products - Save descriptions as metafields
• read_translations - Access existing translations
• write_translations - Save translated descriptions

Enable App Embed

1. Go to Apps → Variants Description Pro → Settings
2. Click the "Theme Blocks" tab
3. Toggle "App Embed" to ON

Add Theme Block

1. Go to Online Store → Themes → Customize
2. Navigate to a product page template
3. Click "Add block" in the sidebar
4. Under "Apps", select "Variant Description"
5. Position the block where you want descriptions to appear
6. Configure styling options (font size, colors, etc.)
7. Save your theme

Available Theme Blocks

• Variant Description - Main description text (updates on variant change)
• Variant SEO Title - Meta title display
• Variant SEO Description - Meta description display
• Variant Images - Additional variant images (if configured)

Metafield Namespace & Keys

All variant descriptions are stored as Shopify metafields on the ProductVariant resource:

Field	Namespace	Key	Type
Description	custom	variant_description	multi_line_text_field
Meta Title	custom	variant_meta_title	single_line_text_field
Meta Description	custom	variant_meta_description	multi_line_text_field

Accessing via Liquid

{{ product.selected_or_first_available_variant.metafields.custom.variant_description }}
      

Translations

Non-primary language translations are stored using Shopify's native Translations API. They automatically appear when the store is viewed in that language.

AI Generation

The AI analyzes your product information to generate unique descriptions:

• Product title and description
• Variant options (size, color, material, etc.)
• Vendor/brand name
• SKU (if available)

Customization Options

• Tone: Professional, Friendly, Luxury, Playful, Technical
• Length: Short (~50 words), Medium (~100 words), Long (~200 words)
• Language: Any of your shop's published languages
• Include SEO: Generate meta title and description alongside the main description

AI Credits

• 1 credit = Generate 1 description
• 1 credit = Translate 1 description to 1 language
• 1 credit = Generate SEO for 1 variant

Credit Packages

• Small: 100 credits - $9.99
• Medium: 500 credits - $39.99
• Large: 2000 credits - $99.99

API Access

Professional and Enterprise plans include API access for custom integrations.

Authentication

All API requests require an API key in the header:

Authorization: Bearer YOUR_API_KEY
      

Endpoints

GET /api/external/v1?action=descriptions&productId={id}

Get all variant descriptions for a product.

POST /api/external/v1?action=descriptions

Save a variant description.

{
  "variantId": "gid://shopify/ProductVariant/123",
  "description": "Your description here",
  "language": "en"
}
      

POST /api/external/v1?action=generate

Generate a description using AI.

{
  "variantId": "gid://shopify/ProductVariant/123",
  "tone": "professional",
  "length": "medium",
  "language": "en"
}
      

Rate Limits

• Professional: 60 requests/minute
• Enterprise: 300 requests/minute