Quickstart

From signup to first AI Readiness Score in under ten minutes.

1. Create an account

Sign up at app.heylumio.ai/signup with email and password, or with Google. Every new workspace starts on the Free plan — 50 products, scoring and Schema Health unlocked, no credit card required.

After verifying email, the onboarding flow asks for an organization name, a workspace name, and an optional store URL.

2. Set up the brand profile

The dashboard opens with a guided setup. Start with the brand profile so every score and enrichment has the context it needs:

  • Product vertical — Pick a primary category (Apparel, Electronics, Health & Beauty, etc.). The scoring engine weights dimensions and generates category-specific attributes based on the vertical.
  • Brand adjectives — Pick 2–5 words that define the brand voice (Premium, Sustainable, Playful, etc.). These shape the tone of generated content.
  • Customer persona — Write 2–5 sentences describing the ideal customer. Specifics matter: “Women aged 25–40 who shop for organic skincare on Instagram” beats “health-conscious consumers.”

The brand profile lives at Brand Profile in the sidebar and can be edited any time.

3. Import the catalog

Two paths:

  • Shopify — If a Shopify store is connected (see Shopify Integration), open Catalog, choose the Shopify tab, and click Sync from Shopify. Lumio imports products from the Shopify Admin API in paginated batches.
  • Sitemap — Otherwise, paste the store URL. Lumio fetches sitemap.xml, follows child sitemaps, identifies product URLs, fetches each page, and extracts JSON-LD structured data.

Either path runs as a background job. The previous active catalog is archived (not deleted) before the new import starts. If the import fails, the archived catalog is restored automatically.

4. Score the catalog

From Scores, click Score catalog to run the AI Readiness evaluation. Each product is scored across six dimensions:

  • Identifier coverage — GTINs, MPNs, brand, model
  • Title quality — Structure, specificity, attribute density
  • Description density — Depth and attribute richness
  • Conversational fields — Q&A pairs, usage scenarios
  • Availability precision — Stock and pricing accuracy
  • Schema completeness — JSON-LD markup quality

Scoring runs in the background through Anthropic’s Message Batches API for cost-efficient bulk processing. Products are batched at 500 per request. An email arrives when scoring finishes — no need to keep the page open.

If a scoring job is interrupted, the next run resumes from the last completed product. No work is lost.

5. Audit Schema Health

Open Schema Health to see a Schema.org audit of every product’s JSON-LD. This runs against the raw data captured during scanning, so it consumes no AI tokens. Issues are categorized by severity (critical, warning, info) and by relevance (Google, AI agents, both).

Schema Health is available on every plan, including Free.

6. Enrich the catalog

Once products are scored and the brand profile is filled in, Enrichment unlocks (Professional and above). Click Enrich catalog to generate five content types per product:

  • Optimized titles in [Brand] + [Product Type] + [Key Attribute] + [Variant] format
  • Attribute-dense descriptions that answer the questions AI agents ask
  • Q&A pairs matching real shopper queries
  • Usage scenarios for intent matching (“Best for…”, “Ideal if…”)
  • Category attributes specific to the vertical

Enrichment also runs as a background batch job. Per-product re-enrichment is available from the Scores or Enrichment view for fast iteration.

7. Deliver the content

For Shopify, open Feeds and click Push to Shopify. Lumio writes enrichments to product metafields, and the theme extension merges that data with live Shopify data (price, availability) to render JSON-LD on the storefront.

Progress streams over Server-Sent Events as each batch completes. A feed record captures the push results.

For other platforms, JSON-LD feed export is on the roadmap.

How usage is measured

Lumio bills per workspace on flat plans with product limits, not credits. The Free plan caps at 50 products. Professional and Elite include higher limits and per-product overage above the limit. Token costs for scoring and enrichment are absorbed into the plan price.

The current product count and limit appear on Manage (workspace settings).

Next steps