📖Knowledge Base

App Documentation

Complete technical guide, Schema.org specifications, GraphQL reference, and configuration manual for 9Teen AI SEO.

Getting Started

Architecture & Theme Safety

9Teen AI SEO is built exclusively using Shopify's modern Theme App Extension and Admin GraphQL API architectures. This design guarantees that no proprietary app JavaScript or modified Liquid code is ever hard-coded into your primary theme files.

Core Architectural Principles:

  • Theme Purity: When you enable our Schema generator, Shopify renders the script via Theme App Embed blocks (theme-seo-embed). If you change or update your Shopify theme, your structured data seamlessly persists without re-installation.
  • Zero Performance Degradation: Schema.org JSON-LD scripts are serialized static payloads embedded into the DOM. They do not block the critical rendering path, do not load heavy client-side JavaScript bundles, and maintain 100/100 Core Web Vitals (LCP, INP, CLS).
  • Catalog Metadata Direct Injection: Meta titles, meta descriptions, and image ALT tags are synchronized directly into Shopify's native database via GraphQL mutations. They are stored as official Shopify catalog attributes, ensuring native checkout and sitemap compatibility.