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

# Video SEO Alt Tags Guide

Install and configure the Video SEO Alt Tags app to generate AI-powered alt text for your BigCommerce and Shopify product and file videos.

## Installation Guide

### 1. Find the App

Search for "Video SEO Alt Tags" on the **Shopify App Store** or **BigCommerce App Marketplace**. You can also find the app by browsing the SEO or Media categories.

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  View App Details →
</a>

### 2. Install the App

Click the "Install" or "Add app" button. Review the required permissions — the app needs access to read your storefront themes and write to your product and file metadata. Click to proceed with the installation.

### 3. Open the App

Navigate to your store admin apps section and open **Video SEO Alt Tags**.

***

## How to Use

### Select Your Plan

Video SEO Alt Tags offers flexible plans for stores of all sizes, including options for unlimited optimizations. Choose the plan that fits your catalog size.

<Note>
  ### 🔐 Your Security is Our Priority

  If you choose a plan that utilizes your own API credentials, your keys are protected by **AES-256 enterprise-grade encryption** at rest.

  * **Encrypted Storage:** We use specialized encrypted fields that are unreadable to anyone—including our own database administrators.
  * **Direct Processing:** Your key is only decrypted at the exact moment of an optimization request and is never logged in plain text.
  * **Merchant Control:** You can update or remove your credentials at any time through your app settings.
</Note>

### Configure Fallback Rules

Determine what alt text is used when a video thumbnail is not yet ready for AI analysis:

* **Store Name** / **Product Title** / **Custom Text**

### Sync & Optimize Videos

Click the **‘Sync & Optimize Videos’** button. The app scans for videos without tags, analyzes thumbnails via GPT-4o, and applies the results directly to your store's metadata.

***

## Verify the Results

### Check Product Videos

1. Go to your store admin **Products** section.
2. Select a product with video media.
3. Click on the video thumbnail and check the **Alt text** field.

### Check Site Content & Files

1. Go to your store's **Content** or **File Manager**.
2. Click a video file to see the optimized **Alt text** saved to the file metadata.

***

## Tips & Best Practices

<Tip>
  **Pro Tip: The "Double Validation" SEO Strategy**
  Rename generic files (e.g., `7039804.mp4`) to descriptive names (e.g., `woman-wearing-silk-scarf.mp4`) before uploading. When the filename matches our AI-generated Alt Text, it provides "Double Validation" to search engines, significantly boosting your rankings.
</Tip>

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Does this work with YouTube or Vimeo?">
    No. This app is specifically designed for **locally-hosted videos** (Shopify or BigCommerce native uploads). This allows us to write metadata directly to these files for a massive SEO boost.
  </Accordion>

  <Accordion title="Will this slow down my store?">
    **Not at all.** We update the metadata of the file itself on the backend. There is no Javascript library loading on your storefront.
  </Accordion>

  <Accordion title="How is billing handled?">
    All billing is handled securely through your respective platform (**Shopify Admin** or **BigCommerce Billing**).
  </Accordion>

  <Accordion title="What happens if I uninstall?">
    The Alt Text we generated **stays on your videos.** We believe you should own your SEO. You only lose access to automatic optimization for new uploads.
  </Accordion>
</AccordionGroup>

<br />

<div class="glass-callout">
  ### Need Support?

  If you have specific questions about bulk syncing or custom AI rules, our engineering team is ready to help.
  [Contact Amethyst Support](mailto:support@amethystapps.com)
</div>

<br />

<a href="https://apps.shopify.com/partners/amethyst-apps" class="btn-amethyst-install">
  Start Optimizing Your Videos Now →
</a>
