Invenio user guide

Plain-text guide for the Invenio Shopify app. Public pages live at /docs.

# Getting started

Getting started

Invenio is an embedded Shopify app. Open it from Shopify admin, Apps, Invenio. You work inside your store. The live app host is https://invenio.srv1173388.hstgr.cloud.

This guide matches what the app actually does in v2.6.7.

First-time setup

Home shows a setup checklist until all three items are done for this store:
Store profile filled (business name and at least one town)
Target keywords set (at least one keyword)
NeuronWriter connected (an API key on the host plus a project id)

The project id can come from NEURONWRITER_PROJECT_ID on the server, or you can save it on Products under NeuronWriter project.

Fill Home settings

On Home, scroll to Local SEO settings:
Who, What, Where. These rank goals are the root input for article titles, article content, and catalog copy. Thin product titles borrow healthy assumptions from these fields.
Target keywords. One search phrase per line. If the phrase already includes the town, Invenio keeps it as typed.
Towns. One town per line. Used for local pages, blog topics, and NeuronWriter queries when the keyword does not already include the town.
Business name, street, ZIP, phone, hours, pickup, store bio. Saved as facts the writer may state. Do not name other businesses.
DataForSEO location. City and state for volumes and rank checks, for example Ringgold, GA. Save looks up DataForSEO names such as Ringgold,Georgia,United States, offers matches, and shows the resolved name and code.
Audience mode. Local storefront or ships nationwide. Auto is fine for most stores.
Posts per month. Default 8 (1 to 30). Shopify publishes that many scheduled articles per calendar month. Planned topics in the Blogs queue do not count until they are built. Extra selected ideas wait for next month.
Pause workers. Stops scheduled runs and Run now until you uncheck it.
Daily email digest. On by default. Around 7:00 AM in the store timezone, Invenio POSTs a last-24-hours summary (JSON plus ready HTML) to the n8n digest webhook. Send test digest now posts the same payload without waiting.

Click Save settings.

Home keeps the first 3 unique keywords and the first 8 unique towns.

Turn on the theme embed

JSON-LD does not appear on the storefront until the Invenio local SEO app embed is enabled.
Open Schema in Invenio, or open the theme editor, App embeds.
Enable Invenio local SEO.
Save the theme.

Invenio does not edit theme files. Optional: add the Invenio Shop by Category app block on article or blog templates for category shortcuts.

Optional: Search Console

On Rankings, click Connect Search Console. Google opens in a new window (or the top window if a popup is blocked). After you approve read-only Search Console access, you return to Rankings. Invenio picks the property that matches this store's domain, or asks you to choose if none match. This spends no credits.

What to do next
On Products, save the NeuronWriter project id if it is not already set.
Select a few products, click Generate, then open each product and approve the draft.
On Blogs, create a NeuronWriter analysis only after you confirm (or reuse an existing query if the page says one already exists), then click Build scheduled posts.
On Schema, save the types you want and confirm the embed is enabled.
On Rankings, set a monthly rank budget if you want daily position checks.

Home itself does not call NeuronWriter or OpenAI when it first loads. It does not spend credits.

# Home

Home

Home is the store profile and control page. The left nav label is Home. There is no separate Settings tab. Store settings live here under Local SEO settings.

Setup checklist

If the store is missing a business name and town, keywords, or NeuronWriter, Home shows a checklist with Done or To do for each item. Links jump to the store profile, target keywords, or the NeuronWriter project field on Products.

The checklist hides when all three items are complete.

Suggested topics

After the first paint, Home loads tags from this store's blogs that match the store category or a target keyword. Run now can use those tags as extra topics when a ready NeuronWriter query already exists.

If no tags match yet, add overlapping tags on blog posts in Shopify.

Run now

Run now starts the background workers for this store: NeuronWriter research (reuse only), content, and meta. It does not create a paid NeuronWriter analysis.

Run now is blocked when:
Pause workers is checked
You have not saved at least one keyword and one town
A run is already in progress

Watch the activity log for progress. This month's published post count loads after the first paint.

NeuronWriter analyses on Home

Scheduled jobs and Run now reuse ready queries. They never create a paid analysis unless you click Create missing NeuronWriter analyses and then Confirm create analyses.

That confirm step can create one analysis per keyword and town pair that does not already have a ready query. It uses your monthly NeuronWriter plan (default 75 new analyses per month).

Local SEO settings

See Settings (/docs/settings) for every field. Save settings writes them for this store only. DataForSEO location, monthly cap, Test connection, month-to-date spend, the Daily email digest toggle, and Send test digest now live here too. Opening Home does not call DataForSEO.

Search Console and Rankings

Home shows whether Search Console is connected (from stored data only) and a Rankings card with tracked keywords and the last check. Connect and Check now live on Rankings. Competitors compares Google Business Profiles. Opening Home does not call Google, Serper, or DataForSEO.

This month

Shows blog posts built or scheduled this calendar month against the posts-per-month cap (default 8). Home, Blogs, and Reports use the same count. Planned topics from the Blogs content planner do not count until they are built. Extra selected ideas stay queued for next month. Also shows whether workers are paused or idle, the last run time, and the last run error if one exists.

If ZIP and Where or Towns look like different US states (for example ZIP 81416 is CO while Ringgold, GA is 30736), Home shows a warning. Saved values are not changed. Generation uses the profile city and state as written.

Activity log

Shows the latest 5 worker events (publish, skip, error). Click View all to expand. Each row can include a link to the store page that changed.

Home's first load only reads store settings. Activity and the post count load afterward. Opening Home does not spend Generate, Optimize, or NeuronWriter quota.

# Products

Products

Products lists this store's catalog and writes SEO copy after you review it.

Monthly quotas

The page shows:
Generate (OpenAI). Default 350 calls per store per month. Shared with Collections, bulk Image alt suggestions, and Local pages.
Optimize (NeuronWriter). Default 10 runs per store per month.

If OPENAI_API_KEY is missing, Generate writes stub copy you can still review. If NEURONWRITER_API_KEY is missing, Optimize writes a stub draft.

NeuronWriter project

Optimize uses one NeuronWriter project. Set NEURONWRITER_PROJECT_ID on the host, or save a project id on this page. The Home checklist treats a saved id plus an API key as connected.

Filters

Search by title or tag, pick a tag, group by none / category / tag, and filter by Shopify category. Changes stay inside the embedded app and keep the shop and host query params. On mobile the same filters apply in the page. Picking a tag such as Sangria hides products that do not have that tag.

Generate and Optimize
Select up to 10 products. An 11th checkbox is blocked.
Click Generate or Optimize in the page header.
Click Review copy in the SEO column, or open the product title, when a draft is ready to review.
Compare current vs proposed meta title, meta description, and description.
Click Approve and write to Shopify, or Discard draft. Discard leaves Shopify unchanged.

Generate writes meta title, meta description, and description from OpenAI and this store's facts. Keywords come from Shopify category, product type, tags, and metafields, not only the Home target keywords. A store-wide keyword is used only when that product actually supports it.

Optimize takes generated copy, or raw product data if you have not generated yet, and revises toward the top 1 competitor score in NeuronWriter.

You must approve a diff before anything is written to Shopify. Products are backed up to JSON before a catalog write.

Image alt Preview

Each row has Preview. That sends the product photos to OpenAI vision with title, product type, category, collection, and store town, then shows the 125-character alt. Save writes it with Shopify fileUpdate. Cancel drops the preview. It does not use the Generate quota.

For a review-first batch of missing alt text, use the Image alt (/docs/image-alt) tab.

Product editor

Open a product to edit title, handle, description, SEO, and each image's alt text. Generate alt text on a card writes that one image immediately and says whether Save is still needed. Save uses the same write path.

Generate and Optimize on the editor spend 1 of the matching monthly quota and create a draft for this product only.

Check score

If a ready NeuronWriter query matches this product, Check score runs evaluate-content on the current Shopify copy and shows the content score. That call does not create a query and does not spend Generate, Optimize, or analysis credits. If no ready query exists, the page says so and does not offer a score.

# Collections

Collections

Collections works like Products for this store's collection pages.

Quotas

Generate and Optimize share the same monthly caps as Products: 350 Generate (OpenAI) and 10 Optimize (NeuronWriter) per store per month. Select up to 10 collections per run.

The NeuronWriter project id on this page is the same store-wide project used on Products.

Generate and Optimize
Select collections.
Click Generate or Optimize.
Open a collection when the draft is ready.
Approve the diff to write meta title, meta description, and description to Shopify, or discard it.

Keywords are taken from the collection title and from the products in that collection (categories, types, tags). A Home target keyword is applied only when the collection actually supports it. Example: Red Wine can get Winery. Wine slushies or fruit wine are skipped unless that collection supports those terms. If none of the store keywords fit, Invenio uses collection-derived keywords and shows the source on the Keywords line.

Image alt

Each row has Preview for the collection image, then Save or Cancel. Bulk missing-alt work for products is on Image alt (/docs/image-alt).

Collection editor

Open a collection to edit its copy, review a Generate or Optimize draft, and write image alt. Approve still happens before Shopify is updated.

Bottom of page

Generate bottom content (on demand) writes a 300 to 600 word description plus a 4 to 6 item FAQ into a preview. The editor shows Saved on the collection when those metafields exist, and Draft, not saved only for an unsaved preview. Those two banners never show together. Save bottom content writes invenio.bottom_html and invenio.bottom_faq. The main collection Save writes title and description only. It does not publish a pending bottom draft. If the bottom write fails, the draft is kept and the error is shown. Nothing auto-publishes.

Add the Collection page bottom theme app section under the Product grid (Add section, then Apps). On Frida Rothman, if the product grid does not accept @app blocks, add it as a standalone app section under Product grid. That section renders server-side and is the target placement. The Collection bottom app embed is a fallback: when the section is already on the template it outputs no markup and no FAQPage schema. Otherwise the embed stays visibility: hidden until JS inserts it after the .shopify-section that holds the product grid (including empty 0-product collections), or before the footer shopify-section group, never a bare <footer> and never inside the grid. Copy uses readable width and theme fonts. The FAQ is an accordion. Generated description HTML uses block elements and spacing so words do not run together.

FAQ answers come from verified store facts only (address, hours, phone, pickup, collection products, policy pages). Prices, shipping times, guarantees, and health claims are not invented. Internal links are 3 to 6 real collections, pages, or articles.

Generate for missing on the Collections list shows the missing count, Generate credit cost, and estimated dollar cost, then creates drafts only. Open each collection to review and Save.

If a ready NeuronWriter query matches this collection, Check score runs evaluate-content on the current Shopify copy and shows the content score. That call does not create a query and does not spend Generate, Optimize, or analysis credits.

# Blogs

Blogs

Blogs schedules real Shopify articles. Invenio creates them unpublished with a future publish date. Shopify publishes them when that date arrives.

Store bio and Content Planner

Blogs is the entry point for the content plan.
Store bio auto-builds a detailed bio from the Admin API (shop description, published theme homepage, Online Store About pages), business details, address, hours, towns, keywords, merchandise collections, and best-known products. Home page, Frontpage, and Signs collections are skipped. Auto-build is free. The merchant edits the textarea and saves the bio per store. The bio is the main prompt for planning.
Generate content plan builds a lateral plan from the store bio and towns with Claude Opus (INVENIO_PLANNER_MODEL, default claude-opus-5-5). ANTHROPIC_API_KEY is required. If the key is missing or Anthropic returns an error, Blogs shows the HTTP status and message. The planner does not invent template ideas or pad with hardcoded titles. Most ideas are local-life and audience topics. About 20 to 25 percent are buying guides. Town-swap duplicates and forced commercial keywords are dropped after the model responds. Each idea stores a type (local-life, audience, buying-guide). Features match the idea topic from the catalog. The keyword is blank or secondary unless it matches the topic and town. The prompt forbids invented venue names, hours, or events. Scheduled and auto posts use this plan only. An admin diagnostics panel shows whether the Anthropic key is present, plus the last LLM provider, model, status, and error.
Tick ideas with checkboxes (or Select all) and click Build selected. Ideas that fit this month say Can build now. Extra ideas say Next month. Selected ideas go into the existing blog pipeline as unpublished drafts. Unpicked ideas stay saved. Each idea uses the same status source as Home and Blogs (Planned, Building, Draft, Scheduled, Published, Missed). There is no publish without the existing approval flow.
Build selected grounds the writer in the bio and fact sheet, links real product and collection handles, and runs a light quality gate (no em dashes, no banned filler such as look no further / must-have / elevate, no unbacked policy, safety, or material claims, no cut-off text). Target length is 900 to 1400 words without padding.

NeuronWriter is not used by Store bio, Generate content plan, or Build selected.

Store inputs

The page shows the Home profile summary, how many posts you have used this month, and suggested topics from:
Home keywords and towns
Matching blog tags
Collection titles
The background content planner (collections, About page, homepage offer, store profile)

Posts this month counts built or scheduled Shopify articles only. Planned topics do not use a slot until they are built. The cap is the posts-per-month value on Home (default 8, 1 to 30 per calendar month). After one built post with a cap of 8, the page shows 1 of 8 remaining. Extra selected ideas stay queued for next month.

Build without NeuronWriter writes posts with OpenAI from the store profile, towns, suggested topics, the content plan, and blog tags. It does not need a ready query and never creates a NeuronWriter analysis. Build with NeuronWriter still requires a ready query and only reuses it. The "topics ready" count matches the Suggested topics Ready query badges.

NeuronWriter analyses

NeuronWriter plans include 75 analyses per month by default (INVENIO_QUERY_CREATE_MONTHLY_CAP). The page shows how many Invenio created this month, and remaining analyses when the NeuronWriter API returns that number.

Create 1 NeuronWriter analysis (uses 1 analysis) checks for an existing query first. If one already exists (ready or still running), the page shows a banner such as A NeuronWriter query for fruit wine already exists, reusing it and does not ask you to confirm. If none exists, Confirm: this uses 1 analysis is the only click that creates a paid query. A success or error banner always stays on the page (plus a toast). Invenio never creates a duplicate query. Scheduling never creates an analysis on its own.

Build scheduled posts

The page shows how many Generate credits the next OpenAI-only build will use (1 per article) and how many Generate credits remain (default 350).

Build without NeuronWriter writes unpublished Shopify articles from the planned topic (title, intent, format, keywords, CTA) plus the store fact sheet. The writer opens with a 40 to 60 word answer, uses question-style H2s, follows the format template for that intent, links 2 to 5 catalog URLs, and ends with a short FAQ. Local hours and visit sections appear only in local audience mode. Code checks word count, SEO title (50 to 60 characters), meta (140 to 155), catalog links, fact-sheet prices, em dashes, and product adjectives that are not on the fact sheet. Up to 2 fix passes run with the measured numbers. Those retries do not spend extra Generate credits. If the post still fails, Invenio saves it as a Shopify draft and flags it in the queue.

It requests a Pixabay featured image when PIXABAY_API_KEY is set (Unsplash or Pexels if that is the first configured key). SEO title and meta description write to Shopify article metafields global.title_tag and global.description_tag. The slug becomes the article handle and never includes invenio. The excerpt becomes the Shopify summary. HTML is sanitized (no markdown fences, no H1 in the body). It never creates a NeuronWriter query.

Build with NeuronWriter runs only for topics that already have a ready query.

Both stay within this month's posts-per-month cap (default 8, set on Home). A notice appears if no stock photo key is configured.

Inline product and collection images in the article body use inline styles (max-width:320px) so Shopify themes cannot blow them up. The featured image is constrained (max-width:720px) with a Pixabay credit line directly under it: Photo credit: Name / Pixabay, linked to the Pixabay image page. Shop-the-collection items render as a simple card grid (image, then the link text under the image).

Content planner

A background planner keeps the Scheduled queue filled with upcoming topics. It always plans 8 store-unique topics, even when fewer posts are needed this month. Posts needed only decides which topics are scheduled first.

The planner builds keyword clusters from search modifiers (how to, best, vs, gift, near the town), expands with niche terms from the catalog, and assigns one intent per topic: how-to, informational, comparison, buyer guide, seasonal, gift, or local. Each topic maps to a real product or collection CTA. Topics whose primary keyword is owned by a collection, product, page, home page, or earlier post are dropped. $0, hidden, unavailable, and discontinued products are not used as CTAs.

Scoring is 100 points: keyword fit 30, commercial bridge 25, uniqueness 20, timing 15, local 10. When DataForSEO credentials are set, search volume and CPC for the store location add a bonus and can reorder topics. Volume is cached 30 days per keyword and location. Each month includes at least one traffic topic (how-to or informational) and one sales topic (buyer guide, comparison, or gift). Gift-heavy stores still get at least 2 non-gift topics. Audience mode is local storefront vs ships nationwide. Auto-detect uses hours, pickup, and shipping language on Home, and you can override it there.

The plan is validated in code (8 topics, unique primary keywords, no do-not-target overlap, real CTAs). If it fails, Invenio re-asks once. Refresh plan uses at most two gpt-4o-mini calls. It never calls NeuronWriter. Find competitor gaps is on demand. It compares the top 3 local competitors from rank history with DataForSEO Labs ranked keywords and adds missing keywords as planned suggestions. Phrases that are numeric noise, out-of-area places, directories, national chains, or off-niche for the store's keywords and categories are dropped, and near-duplicates are merged. The page shows a loading state, then a result with the count, examples, or error, and writes an activity log row. If credentials are missing or the monthly cap is hit, the button does nothing harmful.

Planned rows appear in the Scheduled queue with planned dates, intent, format, search volume, and CPC. If no store location is set, volumes use the United States. Build without NeuronWriter turns this month's remaining planned rows into unpublished Shopify articles. Next month stays planned until that month.

Catalog links

When a post is generated or rewritten, Invenio inserts 2 to 5 relevant products and 1 to 2 collections. Matching uses Shopify category, product type, tags, and title against the post topic and NeuronWriter terms. Store-wide keywords are not forced onto unrelated products. The same URL is never linked twice. Anchors are descriptive.

The scheduled queue lists those links. On an unpublished article you can Remove link before Shopify publishes it. That edits the unpublished article only.

Backlink suggestions

Older published Invenio posts that could link to the new post appear as suggestions only. Published posts are not edited.

Queue actions

Each row shows title, status, publish date, keyword, town, score, and a link to Shopify admin. Planned rows also show search intent. You can change the publish date or remove a built article from Shopify. Refresh formatting re-renders an existing Invenio-built article with the current template (small images, Photo credit: Name / Pixabay under the image, links under images, no body H1). It does not call an LLM and does not spend credits. If the refresh would write an empty body or cut more than half the visible text, Invenio aborts and shows an error. Restore article writes the stored generated HTML back to Shopify (no AI) and applies the current template. Posts built before v1.6.9 do not have a stored body, so restore is not available and those articles must be rebuilt. Removing a post that has not published yet returns that slot to this month's post quota. Planned rows do not have Shopify admin actions until they are built. Built posts are created unpublished with a future publish date.

# Content Planner

Content Planner

Content Planner is a dedicated ideas board for upcoming content. It uses the same Blogs content plan (Claude Opus when set). It does not call NeuronWriter from the browser.

Ideas list

The page heading is Content plan - ideas. Each idea shows the primary keyword, optional additional keywords, Person, and Deadline.
Generated ideas come from Generate ideas, which runs the existing Blogs content-plan refresh.
Manual ideas come from New idea.
Gap ideas may already exist from competitor gap suggestions on Blogs.

Manual ideas stay on the board when you regenerate the plan.

New idea

Click New idea, then fill:
I would like to rank/create content for (required keyword)
Additional keywords (optional)

Save adds the idea to the shared content plan with source manual.

Person and Deadline

Use Assign person or the deadline control on an idea card to update management fields. Delete removes that planned idea from the board.

Blogs

The main Content Planner for merchants is now on Blogs: store bio, Generate content plan, idea checkboxes, and Build selected. This page remains the ideas board for manual ideas, person, and deadline. Blogs still owns building, scheduling, and NeuronWriter confirmation. Open Blogs when you are ready to turn an idea into a draft.

# Image alt

Image alt

Image alt writes SEO alt text for catalog photos. There are two paths.

Bulk image SEO (review first)

The top of the page counts product images that are missing alt text and shows the Generate credit cost (1 credit per image). Nothing is written to Shopify until you review and apply.
Click Generate suggestions. Invenio builds a batch of 5 suggestions at a time. Each suggestion includes alt text and a descriptive file name. This spends Generate credits.
Review the proposed alt and file name.
Apply selected writes the chosen drafts. Discard all suggestions drops them.

If more images remain, generate again. Apply is the only step that updates Shopify for this path.

Catalog images (write now)

The table lists products and collections with their current featured-image alt. Preview sends that photo to OpenAI vision with:
Original title
Product type
Category
Collection
Store town

Then it writes alt text with Shopify fileUpdate (and product media update for products), reads it back, and shows Saved when the write verified. This path does not spend the Generate quota.

You can also generate alt text on a product or collection editor, or from the Preview button on those list pages. Review the 125-character alt, then Save or Cancel. Location filler such as Perfect for ... in Shawnee is stripped.

If OPENAI_API_KEY is missing, Invenio writes stub alt text from the title so you can still see the flow.

# Schema

Schema

Schema controls JSON-LD that the Invenio local SEO theme app embed injects on the storefront. Invenio never edits theme files.

App embed

The page shows whether the embed is enabled on the published theme, the theme name, and a link to the theme editor. Enable the app embed in the theme editor opens the published theme with activateAppId={client_id}/local-seo (local-seo is the app embed block handle). After you deploy the invenio-seo-schema extension, that link highlights Invenio local SEO under App embeds. Save the theme.

If the live theme or storefront already outputs overlapping schema, Invenio warns about duplicates.

Types you can toggle
Organization. Business name, URL, E.164 telephone, and ISO country. Turn this off to suppress Invenio Organization when the theme already outputs one. Merge Organization sameAs keeps Invenio Organization and adds sameAs instead of skipping it. If the live theme already has Organization, Invenio warns about duplicates.
LocalBusiness. Name plus town and address. Hours such as M-F 10am-9pm are stored as schema.org Mo-Fr 10:00-21:00 (or openingHoursSpecification). Telephone is E.164 (+1...). addressCountry is ISO US.
Product. Name, image, description, sku, brand, offers (price, currency, availability), and url. Invenio writes Product schema only when the theme does not already output Product.
Article / BlogPosting. Author and publisher Organization, datePublished, dateModified, image, about entities, mentioned products, and isPartOf Blog. Built from article metafields set by Invenio. No HowTo schema.
BreadcrumbList. Product: Home > Collection > Product. Also page, blog, and article (Home > Blog > Post).
FAQPage. Only when a post has a visible FAQ section. Empty FAQ markup is never emitted.

Save schema settings writes the toggles to Invenio and to shop metafields. The embed reads those metafields on the storefront.

Preview

Sample JSON-LD for this store appears after you save a store profile and the catalog has a product or article. Use Google's Rich Results Test on a live product or article URL after the embed is enabled.

Schema toggles do not spend credits.

# Audit

Audit

Audit has a catalog SEO scan, Checkbot-style SEO checks, a Pages template scan, a slug checker, and an on-demand storefront speed pull. None of these spend Generate or NeuronWriter credits.

Catalog issues

Read-only scan of products, collections, and articles:
Missing meta title
Missing meta description
Duplicate meta title or description across the scanned items
Title over about 60 characters
Description over about 160 characters
Thin body copy (under about 50 words)
Missing alt text when an image is present

Open issues show as a count, then one card per item. Fix the item on Products, Collections, Blogs, or Image alt. This catalog scan does not write to Shopify. The monthly report's audit number is still this live open-issue count.

SEO checks

Grouped Errors and Warnings with counts. Each row links to the Invenio editor or Shopify admin:
Missing or duplicate title tags and meta descriptions
Title or meta length
Broken internal links (paths that are not a current product, collection, page, or article)
Redirect chains
Missing image alt (Warning only)
Missing canonical (when page HTML is present)
noindex on a live page

Pages

Read-only list of Online Store pages and every templates/*.json or templates/*.liquid file on the main theme. Pages use title, handle, body or bodySummary, templateSuffix, and global title_tag / description_tag metafields for SEO (not Page.seo). Templates come from theme(id).files with filenames: templates/*, paginated, on the MAIN role theme (read_themes). Section Liquid is loaded in a second sections/* plus blocks/* pass so JSON templates can be judged on what they render. Each template shows the sections it uses and which pages use it. H1 flags are hidden on Audit Pages. The page shows a small H1 checks coming later note.

Slug checker

Rescan slugs loads product, collection, page, and blog article handles through the Admin API and stores the result with a last-scanned time. Opening Audit does not scan Shopify again until you rescan. If the scan fails, Audit stays on this page and shows the error next to the checker. It does not crash to Application Error.

By default it flags only clearly bad handles:
copy-of prefixes
Trailing copy numbers such as -1 or -2
Random IDs or hashes
Handles over about 60 characters
Underscores or uppercase
Duplicate handles

Missing mapped keyword is an advisory note for collections, pages, and articles (invenio- tags, local page town, or a matching store keyword). Product handles are never flagged for a missing store keyword. Product keywords come from the product's own category, type, and tags, and those values are not prepended onto a product name slug.

Suggestions keep stop words that are part of a product name or title (georgia-on-my-mind). Long article slugs shorten to a coherent phrase from the main keyword plus location (best-kids-clothing-stores-grand-junction), not a chopped word list.

If Search Console shows clicks or impressions on that URL in the last 90 days, the row says Leave as is (has traffic) and has no Apply button. Low or no traffic rows have Apply, which renames the handle and creates a 301 redirect. Apply selected does the same for checked rows after you confirm. Undo puts the old handle back and deletes that redirect. Nothing is renamed until you click Apply.

Connect Search Console on Rankings so traffic locks can run. Without it, every weak handle is treated as no traffic.

Storefront speed

Pull speed data loads the latest Watchtower Lighthouse run for this shop. It queries shop { primaryDomain { host } }, the myshopify domain, and the shop domains list, then tries each host with and without www. Tried domains lists every host it used. It is on demand. Nothing is scheduled.

Run speed test in Watchtower calls POST {WATCHTOWER_API_URL}/api/runs with the primary host only, then polls GET /api/runs for that run. A development store with only a myshopify host is expected when no custom domain is connected. Password-protected stores cannot be tested. If the run is still going, pull again when it finishes. If a pull finds no match, Audit lists the domains it tried and links to Watchtower.

The host needs:
WATCHTOWER_API_URL set to the Lighthouse base, such as https://cornflowerblue-lapwing-804525.hostingersite.com/lighthouse
WATCHTOWER_API_KEY if Watchtower requires a shared secret (Authorization: Bearer and X-Watchtower-Key)

If WATCHTOWER_API_URL is unset, Invenio uses that public Lighthouse URL. Invenio reads GET {WATCHTOWER_API_URL}/api/runs and keeps performance score, LCP, CLS, INP or TBT, FCP, mobile and desktop when Watchtower sends a device, and the run date.

# Crawl

Crawl

Crawl opens an Internal Linking review built from a live fetch of your own storefront. Invenio seeds URLs from Admin catalog data (home, collections, pages, blog articles, products), requests HTML from your primary domain, and scores internal links in the app. It does not call Semrush or import an external campaign.

What you see
Linking score for the current crawl
Pages crawl depth from the homepage
Incoming and outgoing internal-link histograms
Strong / medium / weak Internal LinkRank distribution
Errors, warnings, and notices for common link problems
Top pages by Internal LinkRank (ILR), with outgoing link counts

Unique Pageviews stay blank until a separate analytics connection exists. Opening Crawl spends no Generate or NeuronWriter credits.

# Local pages

Local pages

Local pages draft one unpublished Shopify page per town from the Home store profile.

Cost

Each new page costs 1 Generate credit. Regenerating an existing page also costs 1 Generate credit. The page shows remaining Generate credits before you click. One explicit click per town. Already drafted pages are not rewritten until you click Regenerate.

What gets written

Copy is unique per town and grounded in real store facts (who, what, where, bio, hours, address, phone, and real products or collections). NeuronWriter is reused when a ready query already exists. A new NeuronWriter analysis is never created here.

New pages use a clean handle such as sweet-southern-wine-ringgold or ringgold. Handles never include invenio. Opening Local pages, or clicking Regenerate page, renames any remaining Invenio-created handle that still contains invenio and adds a Shopify URL redirect from the old path (for example /pages/invenio-local-ringgold to /pages/sweet-southern-wine-ringgold). Invenio tracks generated pages in its database and with an invenio.local_page_town metafield, not by a handle prefix.

The Shopify page is created unpublished. Publish it yourself when the copy looks right.

Generated HTML is cleaned before it is written to Shopify: markdown code fences around the HTML are stripped, and a leading heading that repeats the page title is removed so the theme does not show the title twice. Regenerating an existing page runs that same cleanup on the new draft. Existing pages are not rewritten automatically.

Towns

Towns come from Home (the Towns list, or Where if Towns is empty). Add towns on Home first if this page is empty.

Each town is labeled with its own keyword: a keyword that already names that town, or a keyword without a town plus the town. Johnson County does not reuse a Shawnee keyword. Existing pages show a free Preview of the current body before Regenerate page (1 credit).

If a town already has a drafted page, Invenio shows the title, keyword, handle, and a free preview. Click Regenerate page (1 credit) to rewrite that Shopify page and spend 1 Generate credit. If the handle still contains invenio, regenerate also assigns a clean handle and keeps a redirect from the old URL. Invenio does not regenerate local pages on its own.

# Keyword Gap

Keyword Gap

Keyword Gap finds keywords local competitors rank for that this store does not already own. Results are limited to the store niche (Home target keywords) and nearby towns.

Data source

Invenio uses DataForSEO from competitor domains already in rank history. It does not call Semrush and does not import Semrush keyword lists or scripts.

Run a rank check on Rankings first so local competitor domains exist. Then open Keyword Gap and click Find gaps.

Table

The table shows keyword, search volume, CPC, competitor domain, and rank for shared competitor keywords that pass the niche and nearby-town filter.

Send to Local pages and Rankings

Select rows, then click Send to Local pages & Rankings. Chosen keywords become planned topics on the content plan (with a nearby town when the keyword includes one) and tracked keywords on Rankings.

Use Local pages to draft town landing pages. Use Rankings to check positions for the new tracked terms. Blogs can still use Find competitor gaps to add every filtered gap as planned topics without opening this page.

# Rankings

Rankings

Rankings shows stored positions. Opening this tab does not call Serper or DataForSEO and does not spend the rank budget. Home also links here and shows Search Console connection status.

How tracking works

A server scheduler (not page load) stores one snapshot per tracked keyword around 6:00 AM in the store timezone: map pack rank, local organic position, URL found, and source, next to Search Console metrics when connected. DataForSEO uses serp/google/organic/live/advanced at depth 20 from the store's resolved location. Check now runs the same job, limited to once a day, and counts as that day's run. Rankings shows last run, next run, and a per-store Daily rank check toggle (on by default). Invenio never scrapes Google results pages. Drop alerts still fire when a keyword falls 3 or more places. Calls skip and log when the shared DataForSEO cap is hit.

SERP providers, if configured on the host:
Serper (SERPER_API_KEY)
DataForSEO (DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD)

Whichever is set is used. If neither is set, the daily job skips SERP calls.

Monthly rank budget

Each store has a monthly rank-check budget. The default is $30. The page shows:
The SERP provider
Estimated cost of the next daily run
Spent, remaining, and cap for this month

Save a new cap under Monthly rank budget (USD). The job stops when the cap is reached.

Typical provider costs used in estimates: about $0.01 per keyword for Serper and about $0.02 for DataForSEO.

Search Console

See Search Console (/docs/search-console). When connected, Rankings shows clicks, impressions, and average position for this month. Connect spends no credits. Invenio matches the store's primary domain to a Search Console property. If none match, pick one from the dropdown. Change property is always available after connect.

Movers, alerts, keywords, competitors
Movers. Keywords that went up or down between stored snapshots.
Drop alerts. A drop of 3 or more places. Open Re-write opens the matching product, collection, or Blogs page and spends no credits.
Keywords. Position, trend (needs two daily snapshots), and a re-write link.
Competitors. Top result pages from the latest snapshot, with word count, headings, and key terms from a light crawler (robots.txt, rate limits, timeouts).

The monthly report uses these stored numbers when they exist. It invents nothing.

Keywords show map pack rank (from Maps at the store location) and local organic rank. Generated blog posts and local pages are tracked as keyword rows. Improve this page opens Re-write. Write new post for this keyword opens Blogs with that topic. Check rank now stores today's local ranks. A trend chart needs two saved checks on different days.

Local competitors on this page are map pack businesses only. Wikipedia, directories, and listings outside the store area are filtered out.

Map pack grid

For each target keyword, Check map grid runs DataForSEO Maps live from a grid of coordinates around the store (geocoded from the street address or resolved location). Default is 5x5 at about 1 mile. You can save 3x3, 5x5, or 7x7 and the spacing. The page shows the estimated cost before you run (cells times $0.002). Check map grid is limited to once a week per keyword and uses the DataForSEO monthly budget per store.

A heatmap sits on an OpenStreetMap map. Each point is a rank number, 20+ (searched, not in the top 20), or error (the DataForSEO call failed; hover shows the reason). Average rank uses only successful points and scores 20+ as 21. Coverage looks like found in 1 of 25, 0 errors. Failed points get Retry failed points and do not wait for the weekly lock. Opening Rankings does not run the grid.

DataForSEO Maps live accepts only one task per POST. Invenio calls once per cell (not 25 tasks in one request) and stores the per-point status code and message in the run. Zoom is sent as 14z.

# Competitors

Competitors

Local competitors now live on Rankings. The old Competitors tab redirects there. Opening Rankings does not call DataForSEO.

How it works

Refresh (once a week) plus a monthly cron:
Maps live for up to 3 target keywords, from the store location.
business_data/google/my_business_info/live for this store (matched by name plus city, or the Place ID / CID saved on Home) and for up to 3 map-pack competitors.
business_data/google/reviews/live with a sample of 20 reviews to estimate review velocity (reviews in the last 30 days).

All calls use the per-store DataForSEO monthly budget and log cost from the API response. If credentials are missing or the budget is used up, the job skips.

Estimated cost for a typical refresh (3 keywords, this store plus 3 competitors) is about $0.04. Actual billed cost can differ; Home shows month-to-date spend.

What you see
A comparison of rating, review count, review velocity, categories, photos, hours completeness, website, attributes, and posts.
Gaps such as a competitor with 3x your reviews and a category you lack.
Recommended actions (reviews, hours, photos, posts, website, categories).

Save an optional Google Place ID or CID on Home if the name plus city match is wrong.

# Reports

Reports

Reports is a monthly client summary built only from real Invenio records. Counts are zero when nothing was stored. The page does not invent metrics.

What it includes
Store name and calendar month
Products and collections with approved copy
Generate applies and Optimize applies
Posts this month (same built-or-scheduled count as Home and Blogs)
Image SEO applies
Local pages drafted
Schema types enabled
Current open audit issues (live scan, not a historical snapshot)
SEO writes applied this month (approved copy plus image SEO)
Rank tracking snapshots, keywords tracked, and average stored position when snapshots exist
Search Console note, plus average position when the store is connected

Print or PDF

Click Print or save as PDF. Your browser print dialog can save a PDF. The nav and the print button are hidden on the printed page.

Search Console numbers appear only after you connect Search Console (/docs/search-console). Until then the report says so instead of filling in fake clicks.

# Settings

Settings

Invenio has no separate Settings tab in the nav. Store settings are on Home under Local SEO settings. A few other settings live on the tab they belong to.

Home: Local SEO settings
Who. Who the store is. Used as the rank-goal "who".
What. What the store sells. Used as the rank-goal "what".
Where. Where you serve customers. Towns are used if this is empty.
Target keywords. One phrase per line. First 3 unique lines are kept.
Towns. One town per line. First 8 unique lines are kept.
Business name. Optional. Defaults to the Shopify shop name.
Street, ZIP, phone, hours, pickup. NAP and pickup facts for schema and copy. Home warns when ZIP and Where or Towns look like different states. The saved values stay as you entered them.
Audience mode. Auto, local storefront, or ships nationwide. Auto treats hours or pickup as a local storefront and treats shipping language (or empty hours and pickup) as nationwide. Nationwide posts skip hours and directions. Local DataForSEO calls use this store's location. Nationwide uses the United States.
DataForSEO location. City and state, for example Ringgold, GA. Abbreviations expand to DataForSEO names such as Ringgold,Georgia,United States. Save looks up matches, caches the location_code, and shows the resolved name and code. If the city is missing, Invenio uses the nearest DMA, state, or the United States. Adding a store such as PrintingOne means filling keywords, location, and audience. Existing stores keep theirs.
Google Place ID and CID. Optional. Used to match this store's Google Business Profile on Competitors and the map pack grid.
Monthly DataForSEO budget per store. Default $10. Resets each calendar month. Month-to-date spend is shown on Home, Rankings, and Settings. Calls skip when this store's spend would exceed the budget.
Store bio / brand facts. Facts the writer may state. Do not include other businesses.
Publishing cadence. Monthly.
Posts per month. The store limit, default 8 (1 to 30), set on Home. Built or scheduled Shopify articles this calendar month use that cap. Planned Blogs topics do not count until built. Extra selected ideas stay queued for next month. Help chat answers use this shop setting, not a fixed "4 posts" default.
Pause workers. Stops scheduled runs and Run now.
Daily email digest. On by default. Around 7:00 AM in the store timezone, Invenio POSTs last-24-hours ranks (current position plus change; new ranks count as improved), map grid run stats, posts, collection saves, slug changes, audit counts, spend, plain-English errors, and Next steps with admin links. The time range uses the store timezone. Send test digest now posts a test_digest without waiting for 7:00 AM. Sign the POST with header X-Invenio-Secret.

Click Save settings. These rank goals (who, what, where, plus target keywords) are the root input for article titles, article content, and catalog copy.

Products and Collections: NeuronWriter project

Save the NeuronWriter project id used for Optimize and for blog analyses. You can also set NEURONWRITER_PROJECT_ID on the host.

Schema: JSON-LD toggles

Organization, LocalBusiness, Product, Article/BlogPosting, BreadcrumbList, and FAQPage. See Schema (/docs/schema).

Home: DataForSEO

Optional store login and password override. The password is stored encrypted with the app secret and masked in Settings. Test connection calls DataForSEO /v3/appendix/user_data and shows the account balance. If no host or store credentials are set, keyword volumes, daily rank, competitor gaps, and writer SERP briefs do nothing.

Rankings: budget and Search Console

Monthly DataForSEO budget per store (default $10) and Connect Search Console. See Rankings (/docs/rankings) and Search Console (/docs/search-console).

Host-only settings

API keys, monthly caps, and scheduler flags live in the app host environment, not in the embedded UI. Merchants do not edit those. See Credits and limits (/docs/credits). Global DataForSEO login and password are DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD. Watchtower speed on Audit uses WATCHTOWER_API_URL and optional WATCHTOWER_API_KEY. The daily digest webhook defaults to https://n8n.srv1173388.hstgr.cloud/webhook/invenio-daily-digest. Override with N8N_DAILY_DIGEST_WEBHOOK_URL. The secret is N8N_DAILY_DIGEST_SECRET or, if that is unset, N8N_DOCS_CHAT_SECRET.

# Credits and limits

Credits and limits

Quotas reset each calendar month and are enforced on the server for each store.

Generate (OpenAI)

Default 350 calls per store per month (INVENIO_GENERATE_MONTHLY_CAP).

One Generate credit is spent when you:
Generate a product (1 per selected product)
Generate a collection (1 per selected collection)
Generate bulk Image alt suggestions (1 per image in the batch)
Draft a local page (1 per page)
Regenerate a local page (1 per page)
Build scheduled posts without NeuronWriter (1 per article). Writer fix-pass retries for that article do not spend extra Generate credits.

Per-row Preview (then Save) and editor Generate alt text write alt text but do not spend this Generate quota.

If the cap is reached, Invenio refuses the run and tells you how many remain.

Optimize (NeuronWriter)

Default 10 Optimize runs per store per month (INVENIO_OPTIMIZE_MONTHLY_CAP). One run per selected product or collection. Optimize is a scarcer pass toward the top competitor score.

NeuronWriter analyses (75 per month)

Creating a new NeuronWriter query uses an analysis on your NeuronWriter plan. Invenio's default display cap is 75 per month (INVENIO_QUERY_CREATE_MONTHLY_CAP).

Analyses are created only after an explicit confirm:
Home: Create missing NeuronWriter analyses, then Confirm create analyses
Blogs: Create 1 NeuronWriter analysis, then Confirm: this uses 1 analysis

Run now, Optimize (which uses an existing project), Local pages, and Build with NeuronWriter reuse ready queries. They do not create a new analysis by themselves. Build without NeuronWriter never calls NeuronWriter. The Blogs content planner uses one gpt-4o-mini call per refresh and never creates a NeuronWriter query. Product and collection Check score calls NeuronWriter evaluate-content on a ready query only. That does not create a query and does not spend Generate, Optimize, or analysis credits.

Blog posts per month

Home Posts per month is a per-store setting (default 8, 1 to 30) for built or scheduled Shopify articles per calendar month. The Blogs page count uses those articles, not planned topics. After one successful build with a cap of 8, the page shows 1 of 8 used. Extra selected ideas wait for next month.

Rank budget

Home and Rankings share one DataForSEO monthly budget per store (default $10). Keyword volumes, daily rank, competitor gaps, writer SERP briefs, Google Business comparison, and the map pack grid log cost from the API response in sub-cent precision. Spend updates after a grid run. Opening Rankings does not spend it. Calls skip when this store's spend would exceed the budget or when no credentials are set.

A 5x5 map grid is about $0.05 (25 Maps live calls at $0.002). A competitor refresh (3 keywords, this store plus 3 listings) is about $0.04.

Search Console connect and Open Re-write spend no rank budget and no Generate or Optimize credits.

Other limits
At most 10 products or 10 collections per Generate or Optimize run
At most 4 blog posts published per store per calendar month
At most 3 target keywords and 8 towns saved on Home
Audit is free
Schema saves are free
Reports are free
Daily email digest POSTs are free (no Generate or DataForSEO spend)

If OpenAI or NeuronWriter keys are missing, Generate, Optimize, and image alt can still create stub drafts for review. Stubs are labeled. Approve still writes to Shopify, so read them first.

# Search Console

Search Console

Connect Google Search Console so Rankings and Reports can show real clicks, impressions, and average position.

What you need

The app host must have GSC_CLIENT_ID and GSC_CLIENT_SECRET. The Google OAuth redirect URI is:

https://invenio.srv1173388.hstgr.cloud/auth/gsc/callback

(or {SHOPIFY_APP_URL}/auth/gsc/callback on another host)

Google is asked for read-only Search Console access (webmasters.readonly). Invenio does not change your Search Console property.

If those env values are missing, Rankings tells you to set them. There is no Connect button until they are set.

How to connect
Open Rankings.
Click Connect Search Console.
Google sign-in opens in a new window. If the popup is blocked, Invenio opens Google in the top window instead. This avoids a 403 inside the Shopify iframe (Google refuses OAuth in that iframe).
Approve access.
You are sent back to the embedded Rankings tab. A toast says Search Console connected, or asks you to choose a property.

The callback route is not behind Shopify admin auth. A signed state value carries the shop so the connection is stored on the right store.

After Google returns, Invenio lists every Search Console property on that Google account (sites.list). It selects the one that matches this store's primary domain (sc-domain:example.com, https://example.com/, or the www variant). If none match, it does not pick the first property. Rankings shows a dropdown so you can choose. Change property stays available after connect. The choice is stored per shop.

After you connect

Rankings shows the property URL, clicks this month, impressions, and average position. Reports uses the same stored numbers when they exist.

Change property on Rankings opens the stored property picker. If no properties are stored, it opens Google in a new window outside the iframe, same as Connect. Disconnect removes the connection.

Connect and disconnect spend no credits.

# Troubleshooting

Troubleshooting

Home in the Shopify left nav asked me to log in

That was a v1.6.4 bug. Shopify's left-nav Home control loaded /app as a document request without shop or host and without the App Bridge session token header. authenticate.admin then sent the iframe to /auth/login. The shop-domain form ran inside the iframe, and accounts.shopify.com refused to connect.

v1.6.5 registers Home with App Bridge (NavMenu plus rel="home") so the click stays a client navigation. If /app still arrives without params, Invenio recovers shop and host from the referer or host param. If /auth/login is opened inside the admin iframe, Invenio bounces to the top-level admin app URL instead of showing the login form.

The app opens a blank page after I click a filter or link

Stay inside Invenio's nav and in-page filters. Those keep the Shopify shop and host query params. A raw bookmark to /app without those params, or a GET form that drops them, can open a blank 200 page in the embedded app.

Search Console says 403 or Google will not open

Do not expect Google to load inside the Shopify iframe. Use Connect Search Console on Rankings. It opens a new window, or the top window if the popup is blocked. The callback is /auth/gsc/callback and must be listed on the Google OAuth client.

If the Connect button is missing, GSC_CLIENT_ID and GSC_CLIENT_SECRET are not set on the host.

Search Console shows the wrong site

Invenio lists every property on the Google account and selects the one that matches this store's primary domain. It does not take the first property. If the wrong site is stored from an older connect, open Rankings and click Change property. If no property matches the store domain, the dropdown appears until you pick one.

Generate or Optimize is blocked

You may have hit the monthly cap (350 Generate or 10 Optimize), selected 0 items, or selected more than 10. The error says how many remain. Quotas reset on the calendar month.

Drafts look like placeholders

Missing OPENAI_API_KEY stubs Generate and image alt. Missing NEURONWRITER_API_KEY stubs Optimize. The draft is marked stub. Review it before you approve.

Run now does nothing useful

Uncheck Pause workers. Save at least one keyword and one town. If a run is already running, wait for it to finish. Run now will not create NeuronWriter analyses; confirm those separately on Home or Blogs.

Scheduled posts were skipped

Build scheduled posts only writes topics that already have a ready NeuronWriter query. Create and confirm an analysis first. Also check the posts-per-month cap (max 4).

Schema is not on the storefront

Enable Invenio local SEO in the theme editor, App embeds, then save the theme. Saving toggles in Invenio is not enough if the embed is off. Invenio does not edit theme files.

Local page handle looks old

New pages use a clean handle without invenio. Opening Local pages or clicking Regenerate page renames older handles such as /pages/invenio-local-ringgold and adds a Shopify URL redirect to the new path. Invenio finds pages by metafield and database row, not by handle prefix.

Local page body shows markdown fences or the title twice

OpenAI sometimes wraps HTML in markdown fences and repeats the page title as an h1. New drafts strip those fences and drop a leading h1 that matches the title. Already drafted pages are not rewritten automatically. Open Local pages and click Regenerate page for that town (1 Generate credit).

Image alt on a product editor did not stick

Use the per-image Generate alt text button and wait for that card's Saved or error state. v1.6.4 writes that card immediately. Click Save if the editor still says Save is needed.

Rankings never shows positions

The daily DataForSEO rank check writes snapshots around 6:00 AM in the store timezone when credentials exist and Daily rank check is on. The Rankings tab does not fetch SERP on load. Use Check now (once a day) to seed target keywords and store positions. The host needs DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD (or a store override), a monthly DataForSEO cap with room left, and tracked keywords. Serper still works if DataForSEO is not set.

Product filters ignore my tag

Choose the tag from the Tag select or the tag search field. The list filters in the page. v1.6.4 applies that filter immediately and keeps you in the embedded app.

Refresh formatting emptied a blog article

v1.6.8 could wipe a v1.6.7 refreshed article when the Pixabay hero was Shopify article.image and the credit sat in a trailing paragraph. v1.6.9 refuses empty or shorter-than-50% writes. If Invenio stored the original generated HTML (posts built on v1.6.9 or later), use Restore article. Older posts such as Fruit Wine at Georgia Winery in Ringgold, GA were not stored and must be rebuilt.

Help chat is missing

The floating Help button always shows a link to this guide. The chat box appears only when the host has N8N_DOCS_CHAT_WEBHOOK_URL. If chat is on and a question fails, the panel shows the error from the app. You can still open /docs.

# FAQ

FAQ

Does opening a tab spend credits?

No. Home, Audit, Rankings, Reports, and Schema do not spend Generate, Optimize, or rank budget when you open them. Product and collection Check score also spends nothing: it only runs NeuronWriter evaluate-content when a ready query already exists. Credits are spent only when you start Generate, Optimize, bulk image suggestions, a local page, a confirmed NeuronWriter analysis, or when the daily rank job runs.

What is the difference between Generate and Optimize?

Generate writes first-pass copy with OpenAI (350 per month). Optimize runs a NeuronWriter revision toward the top competitor score (10 per month). You can Optimize without generating first. Both need your approval before Shopify changes.

Why do I have to confirm NeuronWriter twice?

The first click only prepares a token when no query exists yet. If a query for that topic already exists, the first click reuses it and shows a banner such as A NeuronWriter query for fruit wine already exists, reusing it. The second click creates the paid analysis only when none exists. Run now and the scheduler are not allowed to create analyses in the background.

How many blog posts will publish?

The store's Posts per month setting on Home (default 8), not a fixed 4. Shopify publishes the unpublished article on the scheduled date. Planned topics in the Blogs queue do not count against that cap. Build without NeuronWriter can fill remaining slots this month without creating a NeuronWriter query. The planner also shows next month's planned posts.

Can I edit copy before it goes live?

Yes. Product and collection drafts show a current vs proposed diff. Blog posts are unpublished Shopify articles you can edit in Shopify admin. Local pages are created unpublished. Regenerating a local page rewrites that Shopify page only after you click.

Does Invenio change my theme?

No. JSON-LD is injected by the Invenio local SEO app embed. You enable that embed in the theme editor. Theme files are not edited.

What does the Help button do?

It stays on every embedded app page. It opens a panel with a link to /docs. If the host configured the docs chat webhook, you can ask a question. That question is posted to /app/help-chat while you are signed into the app, then forwarded to the webhook. If the webhook is not set, you still get the docs link.

Where is Settings?

On Home, under Local SEO settings. DataForSEO location, cap, Test connection, Place ID, CID, and an optional encrypted login override are on Home too. Home also shows Search Console connection status. NeuronWriter project is on Products (and Collections). Rank budget, Connect Search Console, Check now, the map pack grid, and local competitors are on Rankings. Schema toggles are on Schema.

Home in Shopify admin asked for my shop URL

That should not happen inside the embedded app. If it does, reopen Invenio from Apps in Shopify admin. Home stays on App Bridge navigation and will not show the login form in the iframe.

Who can see /docs?

Anyone with the URL. /docs does not require Shopify login. The embedded app still requires Shopify admin auth. /docs/llms.txt is the same guide as one plain-text file for the help chatbot.