Support

Feature guides, plan availability, troubleshooting, and FAQs for the Aganim AI Shopify app.

Feature docs

Each feature below includes plan availability, step-by-step usage, and common fixes.

Brand Soul

Define your brand identity — archetype, tone, power words, banned phrases, and cultural touchpoints — to power all AI-generated content.

Guide

What

Analyzes your store and generates a brand profile: archetype, tone, power words, banned phrases, core value propositions, and cultural touchpoints.
Brand context automatically enriches all AI features — rewrites, missions, marketing copy, and content templates.
Upload your brand logo (PNG, JPG, or WebP) for use in Informative-style hero banners.

How

Navigate to Brand Soul from the Home page.
Click "Edit Identity" to open the Brand Soul wizard.
Follow the wizard — the AI analyzes your store and generates brand intelligence.
Review the generated profile: archetype, tonal guardrails, power words, banned phrases, value propositions, and cultural touchpoints.
Upload your brand logo for hero banner generation.
To enable or disable Brand Soul globally, use the toggle on the Dashboard (under Brand Soul). When enabled, brand context is automatically applied to all AI features.

Deep dive

How Brand Soul powers other features

Dashboard Toggle: Enable or disable Brand Soul globally from the Dashboard. When enabled, all AI features automatically use your brand context.
Rewriter (strongest impact): Your full brand story, pillars, and philosophy are injected into the LLM prompt with strict instructions to weave brand facts into the product description naturally — not as a copy-pasted 'About Us' block.
Missions: Brand context is automatically injected when agents run in a mission pipeline. Every agent in the chain benefits from your brand profile.
Content Templates: Blog posts, hero sections, and collection descriptions draw on your brand voice.
Hero Banners: Your uploaded logo appears in the "Informative" image style for hero sections and collections.

How Brand Soul affects image generation

Image Refinement & Marketing Images: A short brand aesthetic hint (archetype + power words) is added to the image prompt — e.g., 'Heritage House. heritage, master artisans, meticulous, Ichigo Ichie, heirlooms aesthetic.' This gives the image model a subtle style direction.
Marketing Ads (Ideogram): The brand aesthetic is injected into the ad composition prompt to influence the visual style and tone of generated typography ads.
Note: Image models respond to brand soul more subtly than the text Rewriter. The visual difference is most noticeable in the Premium and Natural themes, where the aesthetic hint complements the scene styling. For Clean Studio and Minimalist themes, the effect is minimal by design.

Issues & FAQs

Troubleshooting

Brand intelligence is stuck on "Generating..."

Likely cause

The AI analysis can take 30–60 seconds. If it takes longer, there may be a backend issue.

Fix

Wait up to 2 minutes — the page polls for updates automatically.
Refresh the page and check if the status updated.
If still stuck, try running the wizard again.

Logo upload failed.

Likely cause

File format or size issue.

Fix

Ensure the file is PNG, JPG, or WebP.
Try a smaller file if the upload times out.

FAQs

Can I edit the generated brand profile?

Yes — click the Edit button on the Brand Soul summary on the Home page to edit the generated text directly. To fully regenerate, re-run the Brand Soul wizard.

How often should I re-run Brand Soul?

Re-run whenever you significantly change your brand messaging, add new product categories, or want to refresh the AI's understanding of your store.

Where is the logo used?

Your logo appears in the "Informative" image style when generating hero banners for collections, hero sections, and blog posts.

How do I enable or disable Brand Soul?

Go to the Dashboard and find the Brand Soul card. Use the toggle to enable or disable it globally. When disabled, none of the AI features will use your brand context. The toggle only appears after you've completed the Brand Soul setup wizard.

Rewriter Workspace

Generate localized drafts (title + HTML description + SEO title/meta) per market and save translations back to Shopify.

Guide

What

A workspace to optimize a product for global markets (per locale).
Generates: title, HTML description, SEO title, meta description, and optional SEO alt text.
Supports per-locale editing so you can tailor messaging and SEO to each market.

How

Open Rewriter and select a product.
Select target market(s)/locale(s). (Basic: 1 locale. Standard/Pro: multi-locale.)
Set Optimization Preferences (tone, measurements, strip irrelevant content).
Click "Optimize for Global" to generate drafts.
Review and edit drafts for the active locale (title, HTML, SEO fields).
Optionally add Japanese Value insights to strengthen proof and differentiation.
Click "Save to Shopify" to persist translations + SEO fields for that locale.

Plan features (Rewriter)

Feature	Basic	Standard	Pro	Notes
AI "Optimize for Global" (draft title + HTML description + SEO title/desc)	✅	✅	✅	Generates localized title, description, and SEO metadata.
Rewrite markets selection (published locales)	✅ (1 locale)	✅ (multi)	✅ (multi)	Basic is limited to 1 locale per run.
Bulk multi-market generation in one click	❌	✅	✅	Generate content for multiple locales simultaneously.
Tone / Market Persona / Brand Tone selector	❌ (forced Professional)	✅	✅	Basic forces Professional; Standard/Pro allow Professional/Luxury/Minimalist/Playful.
Auto-convert units to US Standard (EN only)	✅	✅	✅	Keeps metric values and appends US equivalents in parentheses.
Enhance with Brand Soul	✅	✅	✅	Pulls your brand story and voice into the rewrite.
SEO Details editor (SEO title + meta description + SERP preview)	✅	✅	✅	Editable per locale; saved back to Shopify.
Save to Shopify (translations + SEO fields)	✅	✅	✅	Uses digest-based translations for non-primary locales.
Key Details (Nuance) / "Verified Japanese Value" panel	✅	✅	✅	Driven by backend discovered values; can append footer and persist as metafield.
Auto-reset when product description changes	✅	✅	✅	Detects manual changes and resets stale context/drafts.

Issues & FAQs

Troubleshooting

I can't select multiple locales.

Likely cause

Basic supports 1 locale per run, or additional markets aren't published in Shopify.

Fix

Publish additional markets/locales in Shopify settings.
Upgrade to Standard or Pro for multi-locale bulk runs.

Save failed or content didn't show up in Shopify.

Likely cause

Translation digests can become invalid if product content changes during save.

Fix

Avoid editing the same product in Shopify while saving from the app.
Re-run Optimize and try Save again.

Output is in the wrong language.

Likely cause

The target market on the Dashboard may not match what you expect.

Fix

Go to Dashboard and verify the Content Target Market setting.
Change target market to match your intended output language, then re-run Optimize.

Optimization takes a long time or seems stuck.

Likely cause

Complex products with long descriptions or multiple sections take more processing time.

Fix

Wait 30-60 seconds — the AI processes each section individually.
If it exceeds 2 minutes, refresh the page and try again.
Simplify very long descriptions by removing duplicate content before optimizing.

Generated content is too short or missing sections.

Likely cause

The source description may lack sufficient detail for the AI to expand.

Fix

Add more product details to the Shopify description (materials, dimensions, care instructions, usage).
Ensure the source text has clear section structure for best results.

Error: Shopify Access Token not found.

Likely cause

The app's connection to your Shopify store has expired or was revoked.

Fix

Go to your Shopify admin and reinstall or re-authorize the app.
Contact support if the issue persists after reinstalling.

FAQs

Does this overwrite my original product content?

It saves translations for selected locale(s) and related SEO fields. Your primary content remains the reference unless you intentionally update it.

Can I edit output before saving?

Yes — title, description HTML, and SEO fields are editable before saving.

Writing Studio

Hub for Product Rewriter, Content Templates, and Image Refinement — all your AI writing and visual tools in one place.

Guide

What

A central hub connecting three sub-features: Product Rewriter, Content Templates, and Image Refinement.
Navigate to any writing or visual tool from a single page.

How

Open Writing Studio from the navigation menu.
Choose a sub-feature: Product Rewriter, Content Templates, or Image Refinement.
Each sub-feature opens in its own workspace with full functionality.

Issues & FAQs

Troubleshooting

A sub-feature card shows as locked.

Likely cause

Some features require higher plan tiers (e.g. Image Refinement is Pro only).

Fix

Check the plan badge on each card to see what's required.
Upgrade your plan to unlock the feature.

FAQs

What's the difference between Product Rewriter and Content Templates?

Product Rewriter localizes your existing product title and description for global markets. Content Templates generate new content (FAQs, hero sections, blog posts, collection pages) from scratch.

Content Templates

Generate Product FAQs, hero sections, brand blog posts, and collection descriptions with AI-powered templates and your brand voice.

Guide

What

AI-powered templates that generate entirely new content for your products and store.
Four template types: Product FAQ, Hero Section, Brand Blog Post, and Collection Description.
Each template can be published directly to Shopify (product body, blog articles, or collections).
Optional product image upload to blend into generated hero banners.

How

Open Writing Studio → Content Templates.
Choose a template type (FAQ, Hero Section, Blog Post, or Collection Description).
Select a product (or multiple products for Collections).
Configure options: image style, topic, category, overlay text, etc.
Click Generate — review and edit the output.
Click "Publish to Shopify" to save the content to your store.

Deep dive

Product FAQ

Generates Q&A pairs from your product details — materials, care instructions, dimensions, etc.
Published as HTML appended to the product body in Shopify.
Select a product and click Generate. Edit the output, then Publish.

Hero Section

Generates a landing-page hero section with cinematic banner image.
Five image styles: Attractive (props & themed), Seasonal (current season), Minimalist (clean isolated), Informative (product name & logo), Monochrome (B&W editorial).
Upload a product image to blend it into the scene, or leave empty for a theme-based image.
Add optional overlay text (e.g. "Discover our new collection").

Brand Blog Post

Writes long-form blog posts about your craft, manufacturing process, artisan techniques, and more.
Enter a topic (e.g. "Our wood-kiln firing process") and optional category.
Published as a Shopify blog article with an AI-generated hero banner.
Upload a product image to blend into the hero, or leave empty for a theme-based banner.

Collection Description

Generates collection page copy with a hero banner image.
Select multiple products to include in the collection.
Enter a collection name and short description.
Creates a new Shopify collection with the generated description and banner.

Issues & FAQs

Troubleshooting

Generated content is blank or too short.

Likely cause

The source product may have very sparse description details.

Fix

Add more detail to the product description (materials, dimensions, care, origin).
Try clicking Regenerate for a fresh output.

Hero image doesn't include my product.

Likely cause

No product image was uploaded, so a theme-based image was generated instead.

Fix

Upload a product image using the image uploader before generating.
Use a clear product photo (PNG, JPG, or WebP, up to 10 MB).

Publish to Shopify failed.

Likely cause

Session or permission issue with the Shopify API.

Fix

Refresh the page and try publishing again.
If the error persists, reconnect from the Dashboard.

FAQs

Where does the FAQ appear on my store?

The FAQ HTML is appended to the product body in Shopify. How it displays depends on your theme.

Can I upload my own image for hero banners?

Yes — use the image uploader (PNG, JPG, or WebP, up to 10 MB) to blend your product into the generated scene.

What image styles are available?

Five styles: Attractive (props & themed background), Seasonal (current season), Minimalist (clean isolated), Informative (product name & logo overlay), and Monochrome (B&W editorial).

SEO

Edit SEO title/meta with SERP preview, apply CTR best practices, use competitor intel (Standard/Pro), and follow recommendations.

Guide

What

SEO Details lets you edit SEO Title + Meta Description per locale and preview how it may appear in Google.
All plans can receive recommendations; Standard/Pro can also enrich generation with competitor SERP context (best-effort).

How

Open SEO from the navigation, or run Optimize in Rewriter.
Select a product and click "Optimize SEO".
Edit SEO title and meta description while watching preview and length guidance.
Review competitor rankings (Standard/Pro) and CTR score.
Save to Shopify to persist SEO fields for that locale.

Deep dive

Improve CTR (click-through rate)

Lead with the primary keyword + clear product type.
Add one strong differentiator (material, craft detail, outcome) without stuffing keywords.
Keep it readable: titles ~70 chars, meta descriptions ~160 chars to avoid truncation.

Competitor info (Standard/Pro)

Standard/Pro can pull a small set of top Google results for a product keyword (product name + category).
This is used as context to guide copy and highlight differentiators (without copying).
If SERP integration is unavailable, competitor info may not appear (best-effort enrichment).

Recommendations (all plans)

Recommendations are guidance only (no auto-overwrite).
Includes competitive edge and buyer intent strategy suggestions based only on facts present in your description.
If the system cannot be confident without inventing facts, it may return empty recommendations — add real specifics and re-run.

Issues & FAQs

Troubleshooting

Competitor info doesn't show up.

Likely cause

Competitor enrichment is Standard/Pro and depends on SERP integration availability.

Fix

Confirm you're on Standard/Pro.
Treat competitor info as best-effort; you can still use SEO editor + recommendations without it.

Recommendations are blank or too generic.

Likely cause

Sparse source descriptions produce weaker recommendations (the system avoids inventing facts).

Fix

Add authentic details (materials, what's included, dimensions, care, origin/craft).
Re-run Optimize and review recommendations again.

SEO results seem off or not relevant to the product's language.

Likely cause

SEO uses your target market setting from the Dashboard to determine the search locale. If your product is in Japanese but the target market is set to English, the SEO agent will generate for the wrong market.

Fix

Go to Dashboard and set the target market to match the language of your product (e.g. JP for Japanese products).
Re-run SEO optimization after changing the target market.

FAQs

Will SEO edits change my product title on the page?

No — SEO title/meta are separate fields used for search snippets and sharing previews (theme/search behavior may vary).

Do I have to accept recommendations?

No — recommendations are optional guidance. You control what is saved.

My product is in Japanese but I want SEO for an overseas market. What should I do?

First rewrite your product into the target language using the Rewriter, then run SEO optimization. Rewritten content in the target language produces more accurate SERP analysis and keyword suggestions.

Japanese Value

Surface verified Japanese nuance/craft details and add them into your description as proof and differentiation.

Guide

What

Highlights craftsmanship/cultural nuance detected from the source text and explains why it matters to global buyers.
Designed to strengthen credibility without making up claims.

How

Run Optimize in Rewriter.
Open Japanese Value / Key Details panel.
Review evidence + explanation + suggested footer lines.
Insert the insight into your description and Save to Shopify.

Issues & FAQs

Troubleshooting

No insights detected.

Likely cause

The source text doesn't include clear craft/provenance/unique detail signals.

Fix

Add authentic details (materials, origin, method, care, what's included).
Re-run Optimize to re-detect nuance.

FAQs

Will it invent cultural claims?

It is designed not to. If a detail isn't present, it shouldn't be introduced as fact.

Optimization Preferences

Control tone, measurements, Brand Soul integration, and content cleanup so output matches your brand and avoids common localization mistakes.

Guide

What

Preferences that influence generation before you save to Shopify.
Includes: tone (Standard/Pro), EN measurement conversions, Brand Soul integration, and irrelevant content stripping.

How

Choose tone before Optimize (Standard/Pro).
Enable auto-convert units for English locales if needed.
Enable "Enhance with Brand Soul" to inject your brand context into rewrites.
Keep irrelevant-content stripping on for most stores; disable only when you intentionally include policy blocks in product descriptions.
Optimize, review, and regenerate if needed.

Deep dive

Tones

Basic: Professional tone only.
Standard/Pro: Professional, Luxury, Minimalist, Playful.
Use tone to match brand identity while keeping facts unchanged.

Measurements (EN only)

When enabled for English locales, the app keeps metric values and appends US equivalents (when available).
If the source has no measurable units, there may be nothing to convert.

Enhance with Brand Soul

When enabled, your brand story, pillars, and voice are pulled into the rewrite for richer storytelling.
Requires Brand Soul to be set up first (run the wizard from the Home page).
Works across all plans. Disabled by default until Brand Soul intelligence is generated.

Irrelevant content strip

Removes non-product boilerplate so the model focuses on product facts and selling points.
If you want policy content, prefer storing it in theme sections/pages rather than product descriptions.

Issues & FAQs

Troubleshooting

Tone selector is disabled.

Likely cause

Basic forces Professional tone.

Fix

Upgrade to Standard/Pro to unlock additional tones.

No conversions appear.

Likely cause

Conversions apply to English locales and only if the source contains measurable units.

Fix

Run for an en-* locale.
Ensure the description includes dimensions/weight/volume units.

It removed content I wanted to keep.

Likely cause

Stripping may remove policy/boilerplate blocks.

Fix

Disable stripping and re-run Optimize.
Or move policy content outside product descriptions (theme sections/pages).

"Enhance with Brand Soul" is greyed out.

Likely cause

Brand Soul has not been set up yet.

Fix

Go to the Home page and run the Brand Soul wizard first.
Wait for brand intelligence generation to complete, then return to Rewriter.

FAQs

Should I keep irrelevant content strip on?

Yes for most stores. Turn it off only if your product description intentionally includes required policy text that must remain.

What does "Enhance with Brand Soul" do?

It enriches the AI rewrite with your brand's story, tone guardrails, power words, and value propositions for more authentic, on-brand copy.

Multi Locale Editor

Edit drafts per locale and save translations safely (Basic: 1 locale at a time; Standard/Pro: multi-locale + bulk).

Guide

What

Per-locale editing and saving flow so each market gets tailored copy and SEO.
Standard/Pro can generate multiple locales in one run; Basic runs one locale at a time.

How

Select a locale tab/market.
Edit title, description HTML, and SEO fields for that locale.
Save to Shopify for that locale.
Repeat for other locales (or bulk-generate on Standard/Pro).

Issues & FAQs

Troubleshooting

I saw a digest/hash error during save.

Likely cause

Shopify translation registration can fail if primary content changes mid-save.

Fix

Avoid editing primary content in Shopify while saving translations.
Re-run Optimize and Save again.

Drafts/context reset unexpectedly.

Likely cause

The app detected manual content changes and reset cached drafts to avoid stale writes.

Fix

Re-run Optimize using the updated Shopify description.

FAQs

Why is Basic limited to one locale per run?

Multi-locale and bulk workflows are Standard/Pro features to support higher volume optimization across markets.

Marketing

Generate social media captions, ad copy, seasonal campaigns, email templates, and hero images — with optional Meta autonomous publishing.

Guide

What

A full marketing workspace with three tabs: Digital Marketing, Retail Campaigns, and Templates.
Generate Instagram hooks/captions + hashtags, ad banners, hero images, and seasonal campaigns.
Create email templates (launch, abandoned cart, welcome) and ad copy (Facebook/Instagram, Google Ads).
Outputs can be cached to Shopify metafields for reuse without regenerating.
Pro plan supports Meta (Facebook/Instagram) autonomous publishing.

How

Open Marketing from the navigation menu.
Choose a tab: Digital Marketing, Retail Campaigns, or Templates.
Digital Marketing: Select a product, generate social captions, ad banners, and preview content for Instagram/TikTok.
Retail Campaigns: View the seasonal retail calendar, get auto-generated campaign codes, and holiday-themed captions.
Templates: Generate one-click marketing content — launch emails, abandoned cart emails, welcome emails, FB/IG ads, Google Ads.
Save outputs to Shopify metafields for caching/reuse.
Pro: Connect Meta credentials in Dashboard to enable autonomous ad publishing.

Deep dive

Digital Marketing

Generate social media captions, hashtags, and overlay suggestions for Instagram/TikTok.
Create ad banners and hero images with AI.
Preview how content looks on social platforms before publishing.
Save generated hooks and captions to Shopify metafields.

Retail Campaigns

View upcoming retail events and holidays on the seasonal calendar.
Get auto-generated seasonal campaign ideas with discount code suggestions.
Generate holiday-themed captions and campaign concepts.
Use "Re-check" to refresh ideas when you need new angles.

Marketing Templates

Launch Email: Product launch announcement email.
Abandoned Cart Email: Cart recovery email with quality-focused messaging.
Welcome Email: New subscriber welcome email matching your store's personality.
Facebook/Instagram Ad: Social media ad copy optimized for engagement.
Google Ads: Search ad copy for Google with high-intent keywords.

Meta Integration (Pro)

Connect your Meta (Facebook/Instagram) account from the Dashboard.
Requires a long-lived Page access token with pages_manage_posts permission.
Once connected, ad templates can be published directly to your Meta page.
Connection status is visible in the Dashboard.

Issues & FAQs

Troubleshooting

Generate button is disabled / content looks cached.

Likely cause

Fresh cached outputs exist in Shopify metafields.

Fix

If available, use re-check/regenerate behavior.
Update the product description to refresh context and generate again.

Seasonal output looks generic.

Likely cause

Not enough product differentiation in the source.

Fix

Add specific differentiators (materials, use case, bundle contents).
Re-check Seasonal Campaign.

Meta publishing failed.

Likely cause

Invalid or expired Meta access token, or incorrect Page ID.

Fix

Go to Dashboard and update your Meta credentials.
Ensure the token has pages_manage_posts permission.
Verify the Page ID is correct (numeric ID from Facebook Page settings).

Social captions are in the wrong language.

Likely cause

The target market setting on the Dashboard doesn't match the intended language.

Fix

Go to Dashboard and set the Content Target Market to match your desired output language.
Re-generate captions after changing the target market.

Ad banner generation failed (403 or quota error).

Likely cause

You've exhausted your image credits for this billing period.

Fix

Check your image credit usage on the Dashboard.
Wait for the monthly reset, or upgrade to Pro for more credits.
Use text-only features (captions, emails) which don't require image credits.

Hashtags are not relevant or in the wrong language.

Likely cause

The AI generates hashtags based on the target market. Mismatched market settings produce off-target hashtags.

Fix

Ensure the target market matches your product's audience.
For Japanese products targeting Japanese buyers, set target market to JP.

FAQs

Where are marketing results stored?

They can be saved to Shopify product metafields so you can reuse them and avoid repeated generation.

How do I connect Meta for autonomous publishing?

Go to Dashboard → Meta Integration (Pro only). Enter your long-lived Page access token and Page ID, then save.

What email templates are available?

Three types: Launch Email (product announcement), Abandoned Cart Email (cart recovery), and Welcome Email (new subscriber).

Price Scout

Analyze competitor pricing from Google search results and get AI-powered pricing recommendations.

Guide

What

Pulls competitor pricing data from Google Shopping for your product name and category.
The product's "Product Type" in Shopify is appended to the search query to find relevant competitors — an incorrect or generic product type (e.g., "General") will reduce result quality.
Provides AI-powered pricing recommendations based on competitor analysis.
Pro plan can auto-apply recommended prices directly to Shopify.

How

Open Price Scout from the navigation menu.
Select a product.
Ensure the product has an accurate Product Type set in Shopify (e.g., "Japanese Cider" not "General"). This is used to search for relevant competitors.
Click "Scout Prices" to analyze competitor pricing.
Review competitor prices and the AI recommendation.
Optionally apply the recommended price to Shopify (Pro plan).

Issues & FAQs

Troubleshooting

No competitor prices found.

Likely cause

The product name may be too specific, or the Product Type in Shopify is set to "General" or is missing. Price Scout uses the product title + product type to search Google Shopping.

Fix

Set an accurate Product Type for the product in Shopify (e.g., "Sake Set", "Ceramic Bowl", "Green Tea"). Avoid generic values like "General".
If the product name is very long or specific, Price Scout automatically retries with a shorter version.
For Japanese products targeting overseas markets, first rewrite the product into the target language, then run Price Scout.

Price recommendation seems too high or too low.

Likely cause

The AI recommendation is based on available competitor data which may not cover your exact market segment.

Fix

Use the recommendation as guidance alongside your own market knowledge.
Adjust the price manually if the recommendation doesn't fit your strategy.

Competitor results are from the wrong country (e.g. US results for a Japanese product).

Likely cause

Price Scout uses your target market setting from the Dashboard to determine which Google locale to search. If the target market doesn't match the product's language, results will be from the wrong region.

Fix

Go to Dashboard and set the target market to match the language of your product (e.g. JP for Japanese products, EN for English products).
Re-run Price Scout after changing the target market.
For best results, always match the target market with the primary language of your product descriptions.

FAQs

Does it change my price automatically?

No — price analysis is informational. On Pro, you can optionally click to apply a recommended price, but it never changes automatically.

How often should I scout prices?

Scout when launching a new product, adjusting pricing strategy, or when you suspect competitor prices have changed significantly.

My product is in Japanese but I want pricing for an overseas market. What should I do?

First rewrite your product into the target language, then run Price Scout. The agent uses product text to find relevant competitors, so content in the target language produces more accurate pricing results.

Missions

Run multi-agent AI pipelines that chain Rewriter, SEO, Marketing, Pricing, Image Refinement, and Visual Marketing into automated workflows.

Guide

What

Missions are multi-step AI pipelines that process a product end-to-end by chaining multiple agents together.
Choose from preset missions (ready-made combinations) or build custom pipelines with any agent combination.
Run in auto-flow (all agents run sequentially) or step-by-step mode (approve each agent's output before continuing).
Mission results are saved to Shopify: translations, SEO fields, metafields, blog articles, collections, and media.

How

Open Optimize from the navigation menu.
Choose a preset mission or select "Custom Mission" to build your own pipeline.
Select a product for the mission.
For blog missions: enter a topic and optional category. For collection missions: name the collection and select products.
Click "Launch Mission" to start.
In auto-flow: watch progress as each agent runs. In step-by-step mode: review and approve/regenerate/skip each step.
When complete, results are automatically saved to Shopify.

Deep dive

Preset Missions

Basic: Social Hype-Man (Rewriter → FB/IG Ad), New Arrival Blast (Rewriter → Launch Email), Welcome Journey (Rewriter → Welcome Email), Artisan Storyteller (Rewriter → Hero Section).
Standard: Competitor Rebuttal (SEO → Product FAQ), Abandoned Cart Fix (PriceScout → Abandoned Cart Email), SEO Content Factory (SEO → Blog Post), Collection Refresher (SEO → Collection), Google Ads Shield (SEO → Google Ads), Market Awareness Audit (SEO → PriceScout).
Pro: Full Launch (all 6 agents), Visual Ad Blitz (Marketing → Visual Marketing).

Custom Missions

Add any combination of agents: Rewriter, SEO, Marketing, PriceScout, Image Refinement, Visual Marketing.
Reorder agents by dragging them up/down in the pipeline.
Select optional templates for each step (e.g. Product FAQ, Blog Post, Launch Email).
Some agents are plan-gated (Image Refinement and Visual Marketing require Pro).

Auto-flow vs Step-by-step

Auto-flow: All agents run in sequence automatically. Results stream in real-time.
Step-by-step: Each agent pauses after completing. Review the output, then Continue, Regenerate, or Skip.
Step-by-step is recommended for your first few missions to understand how each agent contributes.

Mission History

Recent missions are shown below the mission builder.
Each mission shows: status (Completed, In Progress, Error, Awaiting Approval), agents used, product, and time.
Click "Resume" on an in-progress or awaiting-approval mission to continue where you left off.
Click "View Full Details" to see the complete output of a completed mission.

Missions by Plan

Feature	Basic	Standard	Pro	Notes
Missions per month	1/month	3/month	Unlimited	Free plan: 3 lifetime credits.
Text agents (Rewriter, SEO, Marketing, PriceScout)	✅	✅	✅	Available across all paid plans.
Image agents (Image Refinement, Visual Marketing)	❌	❌	✅	Pro only. Uses image credits (150/month).
Custom pipeline builder	✅	✅	✅	Agent availability depends on plan.
Step-by-step approval mode	✅	✅	✅	Optional — auto-flow is the default.

Issues & FAQs

Troubleshooting

Mission failed or got stuck.

Likely cause

A backend agent encountered an error or timed out.

Fix

Check the mission timeline for error details.
Try launching a new mission with the same configuration.
If it keeps failing, the product may have insufficient data — add more product details.

An agent was skipped automatically.

Likely cause

The agent may not be available on your plan, or a prerequisite agent's output was empty.

Fix

Check plan availability for each agent.
Ensure the product has enough content for all agents to work with.

Mission counter shows 0 remaining.

Likely cause

You've used all missions for this billing period.

Fix

Wait for the monthly reset on your billing date.
Upgrade to a higher plan for more missions (Pro = unlimited).

403 Forbidden when launching a mission.

Likely cause

Mission or image credits are exhausted for your plan.

Fix

Check mission and image credit usage on the Dashboard.
Image-only missions (Image Refinement, Visual Marketing) use image credits, not mission credits.
Full missions use both mission credits and rewriter credits.
Upgrade your plan for more credits.

Visual Marketing / Image Refinement step failed.

Likely cause

No product image URL available, or image credits are exhausted.

Fix

Ensure the product has at least one image in Shopify.
Check image credit usage on the Dashboard.
Upload a custom image when launching the mission.

Rewriter output saved but SEO fields are empty.

Likely cause

The SEO agent may have failed or produced incomplete output.

Fix

After the mission completes, open the SEO page for the product and run a manual SEO optimization.
Check if the product has enough description content for SEO generation.

FAQs

Does the mission save results to Shopify automatically?

Yes — when a mission completes, results (translations, SEO, metafields, blog articles, collections) are saved to Shopify automatically.

Can I resume a mission that was interrupted?

Yes — find it in Mission History and click "Resume" to continue from where it stopped.

What happens if I skip an agent step?

The mission continues to the next agent. The skipped agent's output won't be included in the final results.

Which preset mission should I start with?

For your first mission, try "Social Hype-Man" (Basic) or "Full Launch" (Pro) to see how missions chain agents together.

My product content is in Japanese — how do I get accurate SEO or pricing analysis for overseas markets?

First rewrite the product into the target language, then run SEO or PriceScout. Rewritten content in the target language produces more accurate SERP and competitor pricing results.

Bulk Upload

Upload up to 10 products via CSV to optimize in one batch — text-only or full launch with images. Pro plan only.

Guide

What

Upload a CSV file with up to 10 products (title, description, category, target market) to process in one batch.
Hard limit: maximum 10 products per upload.
Two modes: Text-only (Rewriter → SEO) and Full Launch (Rewriter → Image Refinement → SEO).
Full Launch mode requires a ZIP file containing products.csv and an images/ folder.
Products are created as drafts in Shopify automatically as each one completes.
Requires Pro plan. Image credits are checked before starting Full Launch batches.

How

Navigate to Missions and select a bulk mission (Bulk Text Upload or Bulk Full Launch). Pro plan required.
Choose a mode: Text-only (.csv file) or Full Launch (.zip file with CSV + images).
Prepare a CSV file named products.csv with required columns: row_id, product_name_ja, description_ja, category, target_market.
For Full Launch: add an image_ref column to the CSV pointing to filenames in the images/ folder, then package everything in a ZIP.
Configure preferences: tone profile, Brand Soul, US unit conversion, and target market.
Click "Launch Bulk Mission" to start processing.
Products are processed sequentially. Monitor progress on the status page — you can leave and come back anytime.
Completed products are automatically created as drafts in Shopify.

Deep dive

CSV Format

Required columns: row_id, product_name_ja, description_ja, category, target_market.
row_id: a unique identifier for each product row.
product_name_ja: the Japanese product name.
description_ja: the Japanese product description.
category: the product type (e.g. "Tableware", "Clothing").
target_market: locale code (e.g. "en", "zh-TW", "ko").
For Full Launch: add an image_ref column with the filename of the product image in the images/ folder (e.g. "matcha_powder.jpg").

Full Launch (ZIP) Structure

ZIP must contain a products.csv file and an images/ folder.
Each row's image_ref value must match a file in the images/ folder.
Supported image formats: JPEG, PNG, WebP.
Each product uses 1 image credit from your monthly allowance (150/month on Pro).

Limits and Credits

Maximum 10 products per upload (enforced on both frontend and backend).
Each product consumes 1 mission credit (Pro plan has unlimited missions).
Full Launch: each product additionally uses 1 image credit. The system checks remaining image credits before starting and rejects the batch if insufficient.
Pro plan provides 150 image credits/month and unlimited mission credits.

Issues & FAQs

Troubleshooting

"Maximum 10 products per upload" error.

Likely cause

The CSV contains more than 10 data rows.

Fix

Reduce the CSV to 10 products or fewer.
Split larger batches into multiple uploads of up to 10 products each.

"Batch requires N image credits but you have M remaining."

Likely cause

Your image credit balance is too low for the number of products in the Full Launch batch.

Fix

Reduce the number of products in the CSV.
Switch to Text-only mode (no image credits needed).
Wait for your monthly image credit reset.

"CSV is missing required column(s)" error.

Likely cause

The CSV headers don't match the expected column names.

Fix

Ensure the CSV has all required columns: row_id, product_name_ja, description_ja, category, target_market.
For Full Launch mode, also include an image_ref column.
Column names are case-sensitive.

"Image file not found in images/ folder" error.

Likely cause

An image_ref value in the CSV doesn't match any file in the ZIP's images/ folder.

Fix

Verify that each image_ref value exactly matches a filename in the images/ folder (e.g. "photo.jpg", not "images/photo.jpg").
Check for typos or case differences in filenames.
Ensure the images/ folder is at the root level of the ZIP.

Some products fail while others succeed.

Likely cause

Individual products may fail due to API errors or issues with specific product data.

Fix

Check the batch status page for specific error messages per product.
Re-upload a new CSV with only the failed products.
Ensure all products have non-empty titles and descriptions.

"This feature requires the Pro plan" error.

Likely cause

Bulk upload is exclusively available on the Pro plan.

Fix

Upgrade to the Pro plan ($199/month) to unlock bulk upload.

FAQs

How many products can I upload at once?

Maximum 10 products per upload. This is a hard limit enforced by both the app and the server. For larger inventories, split products into batches of up to 10.

Can I upload Japanese product data?

Yes — the CSV should be UTF-8 encoded. Japanese text in product_name_ja and description_ja columns is fully supported. Set the target_market column per row to control the output language.

What's the difference between Text-only and Full Launch?

Text-only uploads a .csv and runs Rewriter → SEO. Full Launch uploads a .zip with images and runs Rewriter → Image Refinement → SEO. Full Launch uses image credits in addition to mission credits.

What happens if some products fail mid-batch?

Products that have already been processed keep their results and are created in Shopify. Failed products are tracked in the status page. Credits are consumed per completed product.

Which plan includes bulk upload?

Bulk upload is a Pro plan exclusive feature ($199/month). It is not available on Free, Basic, or Standard plans.

Dashboard

Monitor your plan, track usage and credits, manage Meta integration, configure language and target market — all from a single view.

Guide

What

Your operational command center: plan status, usage tracking, feature availability, and integrations.
Track missions used, image credits, and monthly product rewrites.
Configure content target market and app language.
Manage Meta (Facebook/Instagram) integration for autonomous ad publishing (Pro).

How

Open Dashboard from the navigation menu.
Review your plan status, total products optimized, and active markets.
Check the Usage Summary for mission credits, image credits, and rewrite counts.
Set your Content Target Market to choose which locale AI content targets.
Switch App Language between English and Japanese.
Pro: Set up Meta Integration with your access token and page ID for autonomous publishing.

Deep dive

Usage Summary

Missions: Shows used/total missions for the current billing period. Free plan has lifetime credits; paid plans reset monthly.
Images: Shows used/total image credits (Pro only, 150/month).
Product Rewrites: Shows used/total rewrites for the current month.
Reset date is displayed for monthly quotas.

Content Target Market

Choose which market your AI-generated content targets (e.g. English US, Traditional Chinese Taiwan, Korean, etc.).
This affects language, cultural tone, and competitor analysis across all features.
12 supported markets: en, zh-TW, ko, de, fr, es, it, pt, th, vi, zh-CN.

App Language

Switch the app UI between English and Japanese.
This applies globally across all pages — navigation, labels, buttons, tooltips.
Content generation language is controlled separately by Content Target Market.

Meta Integration (Pro)

Connect your Facebook/Instagram page for autonomous ad publishing.
Enter a long-lived Page access token (with pages_manage_posts permission) and your numeric Page ID.
Once connected, marketing ad templates can be published directly to your Meta page.
Connection status shows as Connected/Not connected in the Dashboard.

Grace Period

If you downgrade or cancel, a grace period keeps your current plan active until the end of the billing cycle.
During grace period, all features of your previous plan remain accessible.
After grace period ends, features revert to the new plan level.

Issues & FAQs

Troubleshooting

Authentication error / reconnect banner.

Likely cause

Backend sync/auth issue for the shop session.

Fix

Click "Reconnect" or "Refresh Session" and return to the dashboard.
Retry the action after re-auth completes.

Usage numbers seem wrong.

Likely cause

Usage data may take a moment to sync after operations.

Fix

Refresh the page to get the latest usage data.
If usage still seems incorrect, contact support with your shop domain.

Locked features I expected to have.

Likely cause

Plan sync may be delayed, or the feature requires a higher tier.

Fix

Check your current plan in the Dashboard header.
If you recently upgraded, refresh the page to sync the latest plan.
Review the locked features section to see which plan is needed.

FAQs

Does Dashboard change store content?

No — Dashboard is informational and configurational. It helps you monitor, configure, and decide what to do next.

What happens during grace period?

Your previous plan features remain active until the end of your current billing cycle. After that, your plan reverts to the new level.

How do I change the app language?

In the Dashboard, find the App Language section and click the toggle to switch between English and Japanese.