Install & Setup Guide

Overview

WarpWare XEO is a Shopify app that generates AI-powered product descriptions for your store. This guide walks you through installation, setup, generating your first description, and uninstalling the app.

Availability: WarpWare XEO is currently available to Shopify merchants located in the United States. We plan to expand to additional markets in the future. EU/UK availability is covered in our Privacy Policy.

Section 1: Install

Step 1: Find the App in Shopify App Store

  1. Log in to your Shopify Admin (https://admin.shopify.com)
  2. Navigate to Apps > App Store (or search for “WarpWare” in the search bar)
  3. Find WarpWare XEO in the search results
  4. Click the app tile to open the app details page

Step 2: Review Permissions and Click Install

  1. On the app details page, click Add app (or Install)
  2. A modal will appear showing Requested permissions

Shopify will ask XEO to access the following scopes (permissions). Here’s what each one does and why XEO needs it:

Required scopes (granted by every merchant at install):

PermissionWhy XEO Needs It
read_productsTo fetch your product titles, descriptions, images, tags, and variants so the AI has context to write descriptions
write_productsTo save AI-generated descriptions and tags back to your products when you click “Save”
read_inventoryTo read variant stock quantities so the AI Search audit can flag out-of-stock items in its analysis

Optional scope (only requested if you opt in — you can decline or revoke at any time):

PermissionWhy XEO Needs It
read_orders (optional)Used only by merchants on the Optimize or Intelligence plans who enable A/B testing. XEO subscribes to the orders/create webhook to attribute purchases to the description variant a shopper saw and compute conversion lift. Merchants on the Free or Generate plans never grant this scope.

XEO does NOT request access to customer names, emails, phone numbers, addresses, payment information, themes, blog/article content, or analytics reports.

Step 3: Approve Permissions and Authorize

  1. Review the requested scopes
  2. Click Install or Authorize to grant XEO access to your store
  3. Shopify will redirect you to the XEO admin interface

Step 4: XEO Admin Interface Loads

Once authorized, you’ll see the XEO app interface appear inside your Shopify Admin. The app is now installed and ready for setup.

Troubleshooting Installation

ProblemSolution
App doesn’t load after installRefresh the page. If still blank, check browser console for errors.
OAuth error or “Unable to authenticate”Re-install the app. This usually happens on the first attempt; a second install typically resolves it.
“Permission denied” errorEnsure you have admin access to the Shopify store. Install the app as an account owner or admin.

Section 2: First-Time Setup

Once XEO loads, you’ll see an onboarding wizard. Complete these steps to get started:

1. Define Your Brand Voice Profile

Your “voice profile” is a set of guidelines that tells XEO how to write descriptions in your brand’s style.

You’ll configure:

  • Brand tone (professional, casual, friendly, luxury, playful, etc.)
  • Key messaging (what matters most to your customers?)
  • Target audience (who are you selling to?)
  • Brand values (sustainability, quality, innovation, etc.)
  • Unique selling points (what makes your products different?)

Example:
If you sell eco-friendly activewear, your voice might be: “Conversational but professional, emphasizing sustainability, performance, and inclusivity.”

2. Choose Default Settings

  • Description length (short, medium, long, or custom word count)
  • Default language (English, Spanish, French, etc.)
  • SEO focus (general, keyword-focused, or natural)
  • Include image alt text? (Yes/No — XEO can generate alt text for accessibility)

3. Save Your Profile

Once saved, XEO will use these settings for all description generation. You can create multiple voice profiles if you sell different product types.

Setup wizard screenshot placeholder:

Section 3: Generating Your First Description

Method 1: Single Product

  1. Navigate to Products in your Shopify Admin
  2. Click on any product to open it
  3. Scroll to the Description field
  4. Click Generate with XEO (if visible) or open the XEO app from the admin sidebar
  5. Select the product and click Generate
  6. XEO will generate a description in 5-15 seconds
  7. Review the result in the preview pane
  8. Click Save to product to update your Shopify store
  9. Or click Regenerate to try a different version

Method 2: Bulk Upload (CSV)

  1. Open XEO in your Shopify Admin
  2. Click Bulk Generate
  3. Upload a CSV file with product IDs or product handles
  4. Choose your voice profile
  5. Click Start batch
  6. XEO will generate descriptions for all products asynchronously
  7. When complete, download the results CSV
  8. Review descriptions in the app, then save in bulk to your store

Method 3: Generate from Product Admin

  1. In your Shopify Admin, navigate to Products
  2. Open any product
  3. The XEO sidebar widget (if enabled) shows a Generate button
  4. Click Generate, review, and save

Tips for best results:

  • More product details (categories, tags, images) = better descriptions
  • XEO respects any existing description; it uses it as context
  • Always review generated content before publishing — ensure accuracy and brand fit

Section 4: Billing

If XEO includes paid plans, all app charges are processed through Shopify billing. You can review available plan options and manage your subscription from the XEO billing screen inside Shopify Admin.

Section 5: Uninstall & Data Deletion

How to Uninstall

  1. Log in to your Shopify Admin
  2. Navigate to Apps (usually in the sidebar under “Sales channels” or “Apps”)
  3. Click XEO to open the app details
  4. Click Uninstall (look for a trash icon or “Remove” button)
  5. Confirm the uninstall in the dialog that appears

What Happens After Uninstall

Immediately:

  • The app is removed from your admin sidebar
  • XEO no longer has access to your store data
  • All active API tokens are revoked

Within 48 hours:

  • Shopify sends XEO a mandatory “shop/redact” webhook
  • XEO receives your uninstall notification and begins data deletion
  • All your store data is deleted from production systems

Within 90 days:

  • All data is completely removed from backups and archives
  • Only anonymized aggregation statistics may remain (e.g., “50,000 descriptions generated globally”)

Data We Delete Upon Uninstall

When you uninstall, the following data is deleted:

  • All generated descriptions and their versions
  • Your brand voice profiles
  • Usage history and analytics for your store
  • Billing and subscription records
  • Any drafts or pending generations

Data We Do NOT Delete

Per our privacy practices:

  • Legal/tax records (required for 7+ years by law)
  • Anonymized aggregated statistics (“global descriptions generated per month”)
  • Your Shopify products themselves — XEO only deletes its own records, not your catalog

Reference: See our full data deletion timeline in Privacy Policy.

Request Early Data Deletion (Optional)

If you need your data deleted before the automatic 48-hour timeline:

  1. Email privacy@warpwareworks.com with the subject “Request immediate data deletion”
  2. Include your Shopify store domain (e.g., mystore.myshopify.com)
  3. We’ll process your request within 24 hours

Re-Install After Uninstall

You can re-install XEO anytime. Upon re-install, you’ll start with a fresh account:

  • Your previous profiles and settings are not recovered (they were deleted)
  • You’ll go through the setup wizard again
  • Your Shopify products remain unchanged (XEO deletion doesn’t affect your product catalog)

Section 6: Troubleshooting & Support

Common Issues

“App doesn’t load in Shopify Admin”

Symptoms: Blank screen, spinning loader, or 404 error

Solutions:

  1. Hard refresh your browser: Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
  2. Clear browser cache: Open DevTools (F12) → Right-click reload icon → “Empty cache and hard reload”
  3. Try a different browser: Safari, Chrome, Firefox — sometimes browser extensions interfere
  4. Check your internet: Ensure you’re not on a corporate proxy that blocks the app

“OAuth failed” or “Unable to authenticate”

Symptoms: Error message after clicking “Install”

Solutions:

  1. Try install again: OAuth occasionally times out on the first try
  2. Ensure you’re store admin: Only admins can install apps; try an account with owner access
  3. Disable browser extensions: Some password managers or security tools can interfere with OAuth
  4. Check Shopify status: Visit https://status.shopify.com to ensure Shopify services are operational

“Can’t see products in XEO”

Symptoms: “No products found” or empty product list in the app

Solutions:

  1. Verify permissions: XEO must have read_products scope — check Shopify Admin → Apps → XEO → check permissions
  2. Publish your products: XEO shows published products; ensure products aren’t in draft status
  3. Refresh the app: Click the app in the sidebar to reload
  4. Check product count: If you have 10,000+ products, they may not load instantly; try searching by name

“Descriptions not generating”

Symptoms: Click “Generate” but nothing happens, or error message appears

Solutions:

  1. Ensure API is configured: XEO requires valid API keys — if this fails, you’ll see an error. Contact support.
  2. Check billing status: If generation is unavailable because of billing, go to Settings > Billing in XEO.
  3. Verify product has content: Descriptions generate better when you provide product title + category + tags. Add missing details and try again.
  4. Check browser console: Press F12 → Console tab → Look for red error messages. Screenshot and email to support

“Billing/subscription issues”

Symptoms: Plan change failed, charge not processing, or unexpected charge

Solutions:

  1. Refresh Settings page: Go to XEO → Settings → Billing, wait 10 seconds, and refresh
  2. Check Shopify billing: The actual charge happens through Shopify, not XEO. Verify your Shopify payment method is valid: Shopify Admin → Settings → Billing
  3. Contact support: If issues persist, email support@warpwareworks.com with your store domain

Getting Help

Help Center & Knowledge Base:
Visit /support for help.

Email Support:
Send questions or issues to support@warpwareworks.com

Response time: We respond to support emails within 24 business hours.

What to include in your email:

  • Your Shopify store domain (e.g., mystore.myshopify.com)
  • Description of the problem
  • Steps you’ve already tried
  • Browser console errors (if applicable)

Security & Privacy

All data transmitted to XEO is encrypted in transit (TLS 1.3) and at rest (AES-256). For details, see our Privacy Policy and Data Processing Agreement.

Next Steps

  1. Complete setup: Finish the onboarding wizard in XEO
  2. Generate your first description: Try the single-product or bulk method above
  3. Explore features: Check out voice profiles, bulk upload, and reporting
  4. Review billing: Open Settings > Billing in XEO if you need to manage your subscription
  5. Read the Privacy Policy: Understand how we handle your data (/legal/privacy)

Questions?

Check /support for additional resources or email support@warpwareworks.com.