Pagewise User Manual

About Pagewise

Pagewise solves one problem: it turns the manual busywork scattered across keyword research, copywriting, page building, publishing, analytics, and page fixes into a single closed-loop pipeline. You maintain the AI's writing material in the knowledge base (pain points, scenes, selling points, internal links), generate a complete landing-page draft with one click, review and refine it in the visual editor, publish it as a real page on your storefront, then track every page's performance with Search Console and GA4 data and work through the prioritized optimization queue the app builds for you.

Modules at a glance

Quick start

2.1 Open the app

In the Shopify admin, click Pagewise in the "Apps" list on the left. The app opens embedded in the admin and lands on Home. If you visit the app URL directly with an expired session, you'll see the "Log in to Pagewise" page first — enter your store domain (like my-store.myshopify.com) to continue installing or logging in.

2.2 Complete the setup wizard (~5 minutes)

On first use, click "Resume setup" on the first item of the Home quick-start guide to enter the 6-step wizard. You can leave at any point — completed steps are kept when you return. "Skip setup" in the top-right marks the wizard as done, but you'll still need to finish the remaining configuration on each screen.

1. Brand & market — Enter your brand name, pick the primary market (🇺🇸 United States or 🇩🇪 Germany — this decides the language of generated pages), and click "Continue".
2. Sync products — Click "Sync my products"; the "Continue" button unlocks once the "N products synced" badge appears.
3. Page storage — The app checks whether your theme supports app pages; click "Create page storage" and continue once "Pages will be stored as: …" appears. If it warns your theme may not be supported, switch to an Online Store 2.0 theme and click "Re-check theme".
4. Brand look — Click "Suggest from my theme" to pull colors automatically, or adjust the primary, accent, background, and text colors plus heading / body fonts by hand, then click "Save & continue".
5. AI knowledge base — Click "Generate from my catalog": AI reads your product catalog and drafts three lists — pain topics, scenes, selling points. Review line by line and remove anything off-target ("Regenerate" if you're unhappy), click "Apply to knowledge base", then click "Import site pages" in the internal-links area.
6. Sample page — Click "Generate sample page" (~20 seconds, sometimes longer; it runs in the background so you can leave the page). When it succeeds, click "View pages" to review the draft, then click "Finish".

Screenshot placeholder Setup wizard: step 5 "AI knowledge base" — the editable pain topics / scenes / selling points lists after generation images/onboarding-wizard.png

2.3 Typical end-to-end workflow

1. Finish the setup wizard above (brand → products → storage → look → knowledge base → sample page).
2. Open "Knowledge" and complete your material: enter or AI-draft pain topics, target scenes, and service features; on the "Internal links" tab, click "Import site pages".
3. Open "Generate": pick the target market, a pain topic, and a target scene, select 4 featured collections, and click "Generate draft with AI".
4. Check the parameters in the "Confirm AI generation parameters" dialog, click "Confirm and generate draft", and wait 1–5 minutes (it runs in the background — you can leave the page).
5. Find the new draft under "Pages" and click "Edit" to open the editor: adjust sections, replace each section's placeholder images with real ones (AI doesn't generate images yet), polish with "AI rewrite", fill in the SEO title and description, save, and preview.
6. When it looks right, click "Publish" in the editor — the page becomes a real storefront page that customers and search engines can reach.
7. Connect your data: configure daily auto-sync under Settings → Google auto-sync, or upload GSC / GA4 exports manually.
8. Day to day, watch the data and mine keyword opportunities under "Search Console" (with one-click "Generate a page for this query"), and work the prioritized queue under "Monitor & Insights" — closing the loop.

Home & navigation

Home is the first stop after opening Pagewise: the quick-start guide walks you through initial setup, feature tiles jump straight to the core modules, and the Overview block (key metrics, conversion funnel, crossover insights, next batch priority) plus recent pages keep you on top of pages and traffic at all times.

Left navigation

The nav is a flat list of 6 items: Pages · Search Console · Monitor & Insights · Knowledge · Templates · Settings. Analytics live in the Overview block on Home — there is no separate dashboard screen.

Interface overview

Screenshot placeholder Home: quick-start guide + three feature tiles + Overview (stat cards, conversion funnel, crossover insights, next batch priority) images/home-overview.png

Pages

"Pages" is the ledger of every generated / published page: see each page's market, category, status, and recent search performance (impressions / CTR) in one place, and do the day-to-day maintenance — change status, open the editor, preview, view details, delete — plus pull the store's existing pages in with one click for unified management.

Page statuses

Interface overview

Screenshot placeholder The Pages list: status tabs, market filter, table columns, and row action icons images/pages-list.png

Screenshot placeholder Page details dialog: basic info + latest GSC / GA4 snapshots, with "Delete page" and "Edit in Shopify admin" at the bottom images/pages-detail-modal.png

Screenshot placeholder The "Sync existing pages" preview dialog: will create / will update / detached — three checkable lists images/pages-sync-preview.png

Common tasks

Change a page's status (publish / unpublish)

1. Find the page's dropdown in the "Status" column.
2. Pick the new status: "Draft", "Live", or "Retired".
3. The app syncs the status to Shopify first, then updates the local record; switching to "Live" records the publish time. If the sync fails, the dropdown snaps back to the previous status — just retry.

Sync existing store pages

1. Click "Sync existing pages" in the top right. On first use, pick a definition under "Choose a sync source Metaobject" (only definitions with web-page publishing enabled are listed) and click "Save & preview".
2. Review the three lists in the "Sync preview": will create (exists in Shopify, not locally), will update (fields changed — the changed fields are listed), detached detected (deleted in Shopify, still exists locally).
3. Check the entries you want to process and click "Confirm import (N)", then review the "Sync complete" summary. Checking detached entries only marks the local status as Detached — nothing is deleted.

Delete a page

1. Open the page's details dialog and click the red "Delete page" in the bottom left.
2. Click "Delete" in the confirmation dialog.

Generate with AI

The "Generate" screen is the AI landing-page generator: pick the target market, a pain topic, a target scene, and 4 featured collections, and AI generates a fully structured landing-page draft in the background. The output format and structure are fixed by the system — you only provide and confirm the "what to write about" parameters.

Interface overview

Screenshot placeholder The "Configure page parameters" form: target market, pain point direction, target scene, and the collection picker images/generate-form.png

Screenshot placeholder The "Confirm AI generation parameters" dialog: required product details and the "AI fill" button images/generate-confirm-modal.png

Screenshot placeholder The background progress card (stage indicator + progress bar) and the success banner images/generate-progress.png

Step by step

First use: sync Shopify products

1. In the "Featured product collections" area, click "⟳ Sync Shopify products" to pull all active products from the store.
2. Wait for the green banner with the sync result (fetched / added / updated / deactivated counts); the product tags are now clickable.

Configure parameters and generate

1. Pick the "Target market".
2. Pick a category under "Pain point direction", then a "Specific topic"; if nothing fits, choose "Other (custom input)" and type your own.
3. (Optional) Pick a "Target scene" and fill in the "Page slug" and "Note". Slugs may only use lowercase letters, digits, and hyphens; left blank, one is derived from the AI-generated title.
4. Select exactly 4 collections (use the search box to filter).
5. Click "Generate draft with AI" — the app fetches live data for the selected products and opens the confirmation dialog.
6. Review / edit the parameters in the dialog: check the pain topic and scene, then each of the 4 products' titles and selling-point descriptions (click "AI fill" for empty descriptions). Use "Add a row" for extra requirements (e.g. "emphasize pet-friendly"). Made a mess? Click "Reset to defaults".
7. Click "Confirm and generate draft" — the progress card appears at the top. You can leave the page or refresh; generation continues in the background.
8. When it succeeds, click "View pages" to review the draft under Pages; on failure the reason is shown — adjust the parameters and regenerate.

Page editor

The editor is a full-screen workspace for refining a single page: editing on the left, live preview on the right. Adjust section content and order, change the title and SEO fields, rewrite individual copy with AI, then save and publish to the storefront.

Interface overview

Screenshot placeholder The full-screen editor: top toolbar (save / publish / preview / device switch) + section list on the left + live canvas on the right images/editor-overview.png

Screenshot placeholder Section settings panel: field form, blocks list, and the "AI rewrite" dialog images/editor-section-panel.png

Screenshot placeholder The "Page settings" SEO panel: title, SEO title, SEO description, and the read-only slug images/editor-page-settings.png

Step by step

Edit section content

1. Click the section in the left list (or click the matching area on the canvas).
2. Edit the text, links, images, and other fields — the canvas refreshes live. List-style content (e.g. a single FAQ entry) is edited by expanding it under "Blocks", where you can also add, remove, and drag to reorder.
3. Click "Back" to return to the section list, then "Save" in the toolbar.

Rewrite a section with AI

1. Open the section's settings panel and click "AI rewrite" in the top right.
2. Describe the change under "What should change?" — e.g. "Make it warmer and mention free shipping" — and click "Rewrite".
3. The result is applied directly with the hint "Rewrite applied — review and save." Check the canvas; press ⌘Z to undo if you don't like it, or "Save" if you do.

Preview and publish

1. Click "Save" first — the preview link shows saved content only; unsaved edits won't appear.
2. Click "Preview": a temporary preview link opens in a new tab, shareable with teammates (preview pages aren't indexed by search engines). Links expire — go back to the editor and click "Preview" again for a fresh one.
3. When everything checks out, click "Publish" — the badge flips to "Live" and the page is reachable on your storefront (URL like your-domain/pages/…). To take it offline, click "Unpublish" in the same spot.

Knowledge base

The knowledge base is the AI's material store, holding five kinds of information: collections, service features, internal links, pain topics, and target scenes. Pain topics and target scenes become the dropdown options on the Generate screen, service features get quoted in generated copy, and internal links are embedded into pages automatically. The more complete the material, the closer generated pages fit your store.

Interface overview

Screenshot placeholder Knowledge base main screen: six tabs and the collections table (with search box and the "Add" button top right) images/knowledge-tabs.png

Screenshot placeholder Bulk import tab: entity type picker, template download, file drop zone, and preview table images/knowledge-import.png

Step by step

Add / edit / delete entries by hand

1. Switch to the target tab, click "Add" in the top right, fill in the dialog form (fields vary per tab; empty required fields turn red), and click "Create".
2. Edit: click the pencil icon in the row, then "Save".
3. Delete: click the trash icon in the row and confirm in the "Confirm delete?" dialog. Deletion cannot be undone.

Generate material with AI

1. When the "Service features", "Pain topics", or "Target scenes" tab is empty, click "✨ AI generate from your catalog" in the empty state.
2. AI reads your synced product catalog, generates all three kinds of material in one pass, and imports them into their tabs; edit them like any other entry afterwards.

Import site links in one click

1. Switch to the "Internal links" tab and click "Import site pages (pages / blogs / collections)".
2. The app imports every published page, blog article, and collection as internal-link entries, then reports "Imported X, updated Y." Safe to re-run any time — entries are deduplicated and updated by URL.

Bulk import (file upload)

1. Switch to the "Bulk import" tab and pick the type under "Entity type" (one type per upload).
2. Unsure about the format? Click "Download template CSV" and fill it in.
3. Drop or pick a CSV / XLSX / JSON file (max 2 MB) — it parses automatically and shows "Preview N rows"; rows missing required fields are skipped with a banner.
4. When the preview looks right, click "Confirm import" — the result reads "Imported: X added · Y updated".

Search Console

One place to see how your store performs in Google Search: clicks, impressions, CTR, average position, the site trend, and per-page / per-query detail tables. It answers two questions — "is overall performance up or down" and "which pages / keywords are worth working on". The app labels every page with a "signal", every query with an "opportunity", and computes an opportunity score.

Interface overview

Screenshot placeholder Full-screen overview: four KPI cards + the site trend chart (metric and range switches labeled) images/gsc-overview.png

Screenshot placeholder The "Pages" tab: signal filter expanded + the detail table with signal labels images/gsc-pages-tab.png

Screenshot placeholder The "Upload GSC export" dialog: dates + file drop zone + import success banner images/gsc-upload-modal.png

Step by step

Find pages that need optimization

1. On the "Pages" tab, click "Filter" and filter by signal: "Zero-click" or "Low CTR" for pages that urgently need a title / meta rewrite, "Top 10 opportunity" for pages a small push away from the top of page 1.
2. Click a row to open its details dialog with the history trend and rule explanation.
3. Follow the dialog buttons: "View page details" or "Open action queue".

Mine keyword opportunities and spin up new pages

1. Switch to the "Queries" tab (sorted by score by default) and use "Filter" to pick "Zero-click", "Top 10 tuning", or "Page-2 opportunity".
2. Click a query to check its history and whether a page is already associated with it.
3. If it deserves a dedicated page, click "Generate a page for this query" — the keyword travels with you into the generate flow.

Upload GSC data manually

1. In Google Search Console: choose the property → "Performance" → export CSV or Excel.
2. Back on this screen, click "Upload CSV" and set the data start / end dates (the period the export covers).
3. Upload the "Pages" and "Queries" sheets separately (max 5 MB each), click "Upload", and check the result banner for imported / skipped / unmatched row counts.

Monitor & Insights

This is Pagewise's action center: it automatically crosses GSC (search performance) with GA4 (on-site behavior), finds under-performing pages, and ranks them into a priority queue by "estimated recoverable clicks" — every item carries its data evidence and one clear next action. Ideal as a weekly routine: check overall site health first, then work down from the P1 items. For pure data browsing, use "Search Console" — this screen is only about what to do.

Interface overview

Screenshot placeholder Monitor & Insights top screen: status line, four KPI cards, and the "AI diagnose" button images/monitor-overview.png

Screenshot placeholder One P1 item in the action queue: priority and issue badges, evidence line, and the "AI rewrite / Preview / Details" buttons images/monitor-queue-card.png

Screenshot placeholder The "Upload GA4 export" dialog: date pickers and the file upload zone images/monitor-ga4-upload.png

Step by step

The weekly routine

1. Check the status line and the 4 KPI cards for how impressions / clicks / CTR moved vs. the previous window.
2. Start from the P1 items at the top of the action queue; read each issue badge and evidence line (hover the badge for the rule).
3. Act via the primary button: "AI rewrite", "View data", or "Fix page"; use "Preview" or "Details" first if needed.
4. After working through a batch, come back — the queue converges as data updates, and shows "Queue clear — nothing needs action" when empty.

Rewrite a low-CTR page title with AI

1. Find an item with a "Rewrite title" or "Low CTR" badge and click "AI rewrite".
2. With AI configured, click "Run with AI" for candidate titles right away; without it, "Copy prompt" → "Open Claude.ai" and paste it there.
3. Happy with a title? Click "Fix page" to open the editor, apply it, and save; the queue refreshes when you close the editor.

Investigate a page's traffic swing

1. Find the swinging page in the "Biggest movers" list and click "View data".
2. You land on Search Console's "Pages" tab with the page URL pre-filled in the search box — you're looking at that page's own metric row and history.
3. Judge from the trend whether it's a ranking change, seasonality, or a title problem, then return to the queue and act accordingly.

Templates

"Template configuration" defines the overall look of generated pages: four brand colors (primary, accent, background, body text) and heading / body fonts, with a live preview on the right. Once saved, it applies automatically to pages generated afterwards, to editor saves, and to previews — no need to pick it per generation.

Interface overview

Screenshot placeholder The template configuration screen: template cards and appearance editing on the left, live preview on the right images/templates-page.png

Step by step

1. Click the template to customize in the "Templates" cards — it shows "Selected".
2. Set the four colors (color picker or hex input) and the heading / body fonts under "Appearance".
3. Watch the live preview on the right as you go.
4. Click "Save appearance" — "Saved ✓" confirms it. To reset, click "Reset to defaults" (it only refills the form; you still need "Save appearance" for it to take effect).

Settings

Settings is the global configuration center: come here for initial setup (brand info, page storage, Google data sources, AI model), and afterwards only when switching markets, changing models, or troubleshooting sync issues. Whenever a field changes, Shopify's contextual save bar appears at the top of the admin — click "Save" to persist all changes at once.

Settings at a glance

Screenshot placeholder The Settings screen: descriptions on the left + four settings cards on the right (General / Google auto-sync / Page storage / AI integration) images/settings-overview.png

Screenshot placeholder The Google auto-sync card: service-account email, the two Property ID inputs, sync status lines, and the "Sync now" button images/settings-google-sync.png

Configure Google auto-sync (recommended — replaces manual uploads)

1. Copy the service-account email from the gray box in the "Google auto-sync" card.
2. Open Google Search Console → "Settings" → "Users and permissions" and add that email as a user (read-only is enough).
3. Open GA4 → "Admin" → "Property access management" and add the same email as a Viewer.
4. Back in Settings, fill in the "GSC Property ID" and "GA4 Property ID", then click "Save" in the save bar.
5. Click "Sync now" for a first manual pull; success shows "Google data synced" and the status line records the last sync time. From then on the app syncs daily.

FAQ

"AI not configured" — the generate button is disabled?

The AI key is configured server-side by the developer; there's no input for it in the app. Once the developer sets it up, pick a model under Settings → AI integration.

The generate button stays disabled?

Check in order: are exactly 4 collections selected; is another generation job already running in the background (only one at a time); is the "Additional permissions required" banner showing (reinstall the app to grant the scopes).

A generated page doesn't show on the storefront?

First confirm the status is "Live" (drafts are never public); then confirm the store runs an Online Store 2.0 theme; if you recently switched themes, click "Repair pages now" on Home to re-push page templates to the new theme.

The images on my page are gray placeholders?

Expected: AI doesn't generate images yet. Except for product cards, which use Shopify product images automatically, other sections default to placeholders. In the page editor, open each section and swap them via "Upload image" or "Browse images" (ideally brand-supplied assets matching the page topic), save, then publish.

Uploading a GSC / GA4 file reports "No matching pages"?

URLs in the file are only recorded if they already exist under "Pages". Run "Pages → Sync existing pages" to pull the store's pages in first, then upload again.

The KPI change badges are gone / it says "No earlier window to compare yet"?

Expected: the comparison needs two non-overlapping 28-day windows (at least 28 days apart). Right after connecting data there's only one period ("First period baseline"); the badges appear on their own after a few weeks.

Average position went "down" — why is the badge green?

A smaller position number is better (rank 5 beats rank 8). Badges are colored by "did it improve": green = better, red = worse. Don't judge by the arrow direction alone.

The preview link won't open or says it expired?

Preview links expire — go back to the editor and click "Preview" again. If it says the page is unavailable (missing or not yet synced), the page was deleted or hasn't been synced to Shopify. Also allow popups for this site in your browser.

Why did a page's status become "Detached"?

Its content entry was deleted on the Shopify side and only the local record remains. The app marks this automatically after the Shopify-side deletion. You can delete the local record, or regenerate / re-sync the page.

Can I recover a deleted page?

No. Deletion is permanent on both ends (the Shopify entry, the theme template file, and the local record are all removed). To take a page offline, use the "Retired" status instead.

Want to change a page's URL (slug)?

Slugs are fixed after creation (to keep indexed links alive). If you truly need a new URL, generate a new page with the new slug and retire the old one.