TagForge - AI PIM and Product Feed Transformation Workspace

250k SKUsactive catalog lane

1.2M variantsvariant normalization

34 profilestemplate detection

18.4k issuesbulk fix queue

99.9%export auditability target

Products248kcatalog rows in current workspace

Attribute completeness96%canonical fields populated across the active catalog

Feed readiness89%5 export channels checked

Import templates189 platforms, multiple templates each

Production readiness scoreboard

What is live, what is blocked, and what the builder should ship next.

Connector-first launch gate

Shopify OAuth startlive scaffold

Dashboard CTA and /api/connectors/shopify build signed install URLs without credential paste.

OAuth callback validationguarded

Callback route validates shop, code, and opaque signed state before any token exchange exists.

Token vault boundaryowner gate

Access-token exchange waits for encrypted tenant-scoped vault storage and Shopify app secret env vars.

Connector installation storescaffolded

Workspace-scoped install records now sanitize token refs and expose safe route metadata before persistence.

Read-only product importscaffolded

Product import preview is route-backed and fixture-safe; live API reads wait for OAuth, vault, scopes, pagination, and webhook safety.

Dashboard backed by connector metadatascaffolded

Connector registry cards now accept sanitized installation-store metadata for status, last sync, issue count, and next action.

GitHub verify gateowner gate

GitHub Actions verify workflow is blocked until auth has workflow scope; local npm run verify:all remains required.

Owner gatetracked

ops/owner-gates.md lists Shopify Partner credentials, Vercel env vars, billing/legal, DNS, and marketplace approvals.

Owner gate items stay tracked in ops/owner-gates.md; autonomous builders keep shipping safe scaffolds, tests, and dashboards around them without waiting unless credentials or external account approvals are truly required.

Platform connectors

Merchant command center for live commerce channels.

Connect merchant platforms first, then use CSV for supplier sheets, emergency edits, migrations, and fallbacks.

1Connected channelsWooCommerce catalog sync is live in the demo workspace.

50%Catalog readiness by platformReadiness combines auth, sync, and marketplace gates.

1Blocking marketplace issuesAmazon app approval is blocking direct publish.

Resolve Amazon developer approval before any direct SP-API publish pathNext recommended actionLast sync status stays visible beside every connector.

Shopifyneeds_auth

Demo Shopify storeShopify Admin APILast sync status: Fixture preview ready — no live Shopify API call

OAuth app credentials are scaffolded; merchant authorization is the next step.

Next recommended action: Start app-scoped OAuth after Shopify Partner credentials are owner-approvedproducts · variants · inventory · collections · metafields

WooCommerceconnected

Demo WooCommerce catalogWooCommerce REST APILast sync status: Fixture sync complete — demo catalog only

1 connector issues need operator review before publish.

Next recommended action: Review WooCommerce product and inventory fixture deltasproducts · variations · inventory · categories · attributes

BigCommercenot_connected

Demo BigCommerce storeBigCommerce Catalog APILast sync status: Fixture planned — no live BigCommerce API call

Ready to request store hash and catalog scopes after merchant starts install.

Next recommended action: Create BigCommerce OAuth fixture install checklistproducts · variants · inventory · categories · brands

eBaysyncing

Demo eBay seller inventoryeBay Sell Inventory APILast sync status: Fixture inventory sync in progress — no live eBay API call

2 connector issues need operator review before publish.

Next recommended action: Map eBay business policy fixture IDs before publish scaffoldingproducts · inventory · offers · business_policies · item_specifics

Amazonerror

Demo Amazon SP-API gateAmazon Selling Partner APILast sync status: Blocked by fixture app-review gate

4 connector issues need operator review before publish.

Next recommended action: Resolve Amazon developer approval before any direct SP-API publish pathproducts · listings · inventory · reports · product_type_definitions

Walmartneeds_auth

Demo Walmart marketplace accountWalmart Marketplace APILast sync status: Fixture ready — partner authorization not connected

2 connector issues need operator review before publish.

Next recommended action: Prepare Walmart item spec fixture mapping before owner-approved credentialsproducts · items · inventory · price · taxonomy

Shopify OAuth scaffold

Connect Shopify starts with app-scoped OAuth, not credential paste.

Requested scopes: read_products, read_inventory, read_publications, read_product_listings, read_locations. Webhooks: products/create, products/update, products/delete, inventory_levels/update. Tokens must be encrypted and tied to the tenant workspace before any writeback.

Connect Shopify

CSV fallback center

Upload fallback / bulk import when a connector is unavailable.

CSV remains a side-feature fallback for supplier files, one-time migrations, emergency edits, and messy marketplace cleanup without replacing the connector-first catalog spine.

Open CSV fallback

Product manager

Manage products from any commerce platform.

Shopify detected · Shopify products CSV

Add, edit, duplicate, archive, search, validate, and prepare products for every channel in one workspace. Keep platform-specific fields while TagForge normalizes the shared product facts needed for feeds and migration.

Products are ready to edit.1 active products6 issues to review3 destination checks

Virtualized catalog table

Products

Cursor pagination ready

Editable product table with canonical fields, validation status, and channel readiness.
Select	SKU	Title	Brand	Price	Inventory	Status
	CANDLE-AMB-8OZ	Amber Cedar Soy Candle	North Ridge Goods	$24.00	12	Ready

Category manager

Recognized categories from the current catalog.

1 managed · 0 unassigned

Recognize current categories, create category paths, rename / merge categories, assign products, and keep platform category mappings ready for Shopify collections, WooCommerce categories, Amazon browse nodes, Google product categories, and TikTok category IDs.

Create category

Creates a managed category without changing products.

Bulk assign category Rename / merge categories

Updates product assignments and keeps lineage auditable.

Unassigned products0 need category assignment before marketplace-specific validation.

Platform category mappingsShopify collections · WooCommerce categories · BigCommerce category trees · Amazon browse nodes · eBay item specifics · Walmart category specs · Etsy taxonomy · Google product categories · Meta catalog categories · TikTok category IDs6 category assignment checks active

Category mapping workflow

Manual taxonomy mapping before export generation.

Mapping coverage: 1/4

Map each managed category to a channel taxonomy target, then resolve the Required attribute set before generating marketplace-specific templates. This is manual taxonomy mapping, not live marketplace sync.

Mapping saved locally until authenticated persistence is available.

Marketplace export readiness

categoryMappingStatus: blocked

4 Ready export files · 3 Blocked mapping issues

Use persisted manual category mappings to generate deterministic channel CSV packages with marketplaceCategoryId, marketplaceCategoryPath, taxonomyVersion, and required-attribute checks before upload.

Google Shopping1 rows · csv · marketplaceCategoryId includedgoogle-shopping-category-mapped.csv

Amazon1 rows · csv · marketplaceCategoryId includedamazon-category-mapped.csv

Walmart1 rows · csv · marketplaceCategoryId includedwalmart-category-mapped.csv

eBay1 rows · csv · marketplaceCategoryId includedebay-category-mapped.csv

Download category-mapped CSV

Home & Garden > DecorGoogle Shopping

MappedHome & Garden > Decor > Manual taxonomy mappingRequired attribute set: brand, gtin, condition

Home & Garden > DecorAmazon

Needs taxonomy targetChoose target category path / browse node / taxonomy IDRequired attribute set: brand, gtin, condition, image_url

Home & Garden > DecorWalmart

Needs taxonomy targetChoose target category path / browse node / taxonomy IDRequired attribute set: brand, gtin, condition, price

Home & Garden > DecoreBay

Needs taxonomy targetChoose target category path / browse node / taxonomy IDRequired attribute set: brand, condition, image_url

Platform accommodation

Keep platform-specific fields.

TagForge stores shared product facts in a canonical model and preserves each platform’s unique fields as extensions or custom attributes.

Canonical product factssku, handle, title, description, brand, category, product_type, tags

Shopify specific fieldsNo fields detected yet

Merchant custom attributesNo fields detected yet

Supported product conceptsvariants, collections, metafields, inventory, media, seo, custom_attributes

Enrichment controlEnrichment suggestions stay optional and require merchant approval.

Catalog scale

Built for large product catalogs and platform-specific data.

Global merchant operations

Virtualized catalog table0–100 / 250k SKUsFast table windows keep large catalogs responsive while the backend cursor traverses the full catalog.

Cursor pagination2,500 row pagesStable sort keys for price, SKU, completeness, channel status, and variant count.

Bulk issue resolution18,420 queued fixesGroup by field, channel, severity, template, or supplier before applying rules.

Schema changes3 watched importsHeader differences and template confidence changes are shown before a mapping is reused.

Channel readiness table

Catalog rows

Spring marketplace catalog

1 products loaded in this workspaceCursor pagination model: page 1 of 100Sort: readiness descSelection and edits are handled in Product manager

Product grid showing canonical fields, completeness, variant count, and channel validation state.
SKU	Title	Brand	Price	Variants	Completeness	Status
CANDLE-AMB-8OZ	Amber Cedar Soy Candle	North Ridge Goods	$24.00	1,248	100%	Ready

Product detail panel

Amber Cedar Soy Candle

Field lineage stays visible so operators can trust every transformation before export.

skuVariant SKU → trimCANDLE-AMB-8OZ

handleHandle → trimamber-candle

titleTitle → trimAmber Cedar Soy Candle

descriptionBody (HTML) → strip_html_trimWarm cedar and vanilla soy candle

brandVendor → trimNorth Ridge Goods

categoryProduct Category → trimHome & Garden > Decor

product_typeType → trimCandle

tagsTags → split_tagssoy candle, gift

Import progress

Catalog intake state

Parse42k rows/minstreaming

Detect34 templates scoredcomplete

Map96.4% auto-mappedreview 14 columns

Validate7 channels18.4k issues

Export4 packages2 ready

Feed connector operations

Transform canonical data into scheduled feeds and marketplace-ready packages.

6 connector specs

Google Merchant Centerscheduled_pull

92% readytsv / xml_rss / csv · 14 output fields

Scheduled HTTPS pull feed. Keep stable IDs, crawlable links/images, and previous successful feed available.

Meta Commerce Catalogscheduled_pull

92% readycsv / tsv / xml_rss · 12 output fields

Scheduled catalog feed for Facebook/Instagram Shops and ads; merchant must verify commerce policy eligibility.

TikTok Catalogscheduled_pull

92% readycsv / tsv / xml · 12 output fields

Catalog feed for ads. Keep separate from TikTok Shop marketplace listing API/template workflows.

Generic scheduled feedscheduled_pull

100% readycsv / tsv / xml_rss / jsonl · 12 output fields

Stable UTF-8 feed with signed HTTPS URL, ETag/Last-Modified, atomic regeneration, and rollback to last successful output.

Amazon Marketplaceapi_push_later

96% readyflat_file_tsv / json_listings_feed · 10 output fields

Export-first until SP-API authorization, Product Type Definitions schemas, Feeds API upload, polling, and processing-report ingestion are implemented.

Walmart Marketplaceapi_push_later

96% readyjson_feed / xml_feed / item_setup_csv · 10 output fields

Export-first until Walmart partner credentials, category specs, item/feed submission, and item-processing reports are wired.

Feed run timeline

1. snapshotFreeze canonical catalog snapshot before feed generation

2. mapApply destination field mapping and enum transforms

3. validateRun universal and channel-specific feed validation

4. generateGenerate CSV/TSV/XML/JSON feed artifact atomically

5. publishExpose scheduled-pull URL or hold API-push package for review

Canonical → channel feed preview

Sample feed row generated from canonical product data.
Feed field	Sample value
id	CANDLE-AMB-8OZ
title	Amber Cedar Soy Candle - Cedar Vanilla
description	Warm cedar and vanilla soy candle
link	—
image_link	https://example.com/candle.jpg
availability	in_stock
price	24.00 USD
condition	new
brand	North Ridge Goods

missing_recommended_field4 checks · Google Merchant Center, Meta Commerce Catalog, TikTok Catalog, Amazon Marketplaceparent_sku: parent_sku improves Google Merchant Center feed quality.

missing_recommended_identifier3 checks · Google Merchant Center, Meta Commerce Catalog, TikTok Catalogmpn: mpn improves Google Merchant Center feed quality.

missing_recommended_field1 checks · Walmart Marketplaceweight: weight improves Walmart Marketplace feed quality.

Channel readiness matrix

Feed readiness by channel

Validate before publish

Shopify100%

Google Shopping95%

Amazon75%

eBay90%

Walmart85%

Bulk issue resolution

Blocking errors and warnings

warningGoogle Shopping · CANDLE-AMB-8OZ · mpn

mpn improves Google Shopping readiness.

warningAmazon · CANDLE-AMB-8OZ · bullet_point_1

bullet_point_1 improves Amazon readiness.

warningAmazon · CANDLE-AMB-8OZ · bullet_point_2

bullet_point_2 improves Amazon readiness.

warningAmazon · CANDLE-AMB-8OZ · material

material improves Amazon readiness.

warningAmazon · CANDLE-AMB-8OZ · color

color improves Amazon readiness.

warningAmazon · CANDLE-AMB-8OZ · size

size improves Amazon readiness.

warningeBay · CANDLE-AMB-8OZ · mpn

mpn improves eBay readiness.

CSV fallback center

Upload fallback / bulk import

CSV is a side feature for supplier sheets, one-time migrations, cleanup jobs, and emergency bulk import. The main workflow starts with merchant platform connectors, then uses this fallback when an API path is unavailable.

Import history remains available here for CSV fallback runs and migration cleanup audits.

Usage before save

Free preview plan gate

Backend saves quote imports and SKUs before writing catalog state so merchants see the limit risk before a hard billing gate.

Import allowance3218/50 used

SKU allowance2,000248,000/250,000 used

Enforced response402usage_plan_limit_exceeded

Plan enforcement returns 402 before partial mutationsUpgrade to Starter when imports or SKU allowance runs out; failed saves do not create partial catalogs, imports, or usage rows.Upgrade to Starter

Import run nameUpload CSV inside the workspaceNo return to homepage. Parse, map, validate, and export from the paid workbench.

Live import review

Shopify detected

2rows

10columns

10mapped fields

87%avg readiness

Variant SKUsku · 88% confidencetrim

Handlehandle · 98% confidencetrim

Titletitle · 98% confidencetrim

Body (HTML)description · 88% confidencestrip_html_trim

Vendorbrand · 88% confidencetrim

Product Categorycategory · 88% confidencetrim

shopify-products-2026-04.csvShopify products CSV · 248,000 rows · 1.2M variants · Today 9:12 PMmapped · 42k rows/min

amazon-active-listings.txtAmazon listings report · 311,000 rows · 311k variants · Yesterday 4:28 PMschema changes · 31k rows/min

walmart-item-setup.xlsx.csvWalmart item setup sheet · 144,000 rows · 288k variants · Apr 29validated · 37k rows/min

Mapping profiles

Reusable import intelligence

Shopify → canonical PIM2 templates · 27 fieldsactive

Amazon listings report → canonical PIM2 templates · 21 fieldsschema change watch

Marketplace cleanup fallback18 templates · messy aliasesguardrail

Export packages

Channel package queue

google-merchant-feed-v3.csvGoogle Shopping · 91% ready · 248k rowsready

amazon-flat-file-cleanup.csvAmazon · 82% ready · 1.2M variantsreview warnings

ebay-seller-hub-active.csveBay · 88% ready · 248k rowsready

walmart-item-setup.csvWalmart · 76% ready · 248k rowsblocked fields

Usage ledger

Plan limits

Usage summaries returned from authenticated saves keep account owners ahead of hard limits and make billing gates explainable.

Imports18/50

SKUs248,000/250,000

Variants1,200,000/1,500,000

Exports9/25

Server-side workspace foundation

Cloud snapshots are API-ready.

The dashboard now points browser workspaces at /api/pim/backend for save/load history while keeping a local-first fallback until authenticated tenants are enabled.

saveClientWorkspaceSnapshotStores parsed catalog state, selected channels, mappings, validation run, and workspace metadata without retaining raw CSV text.Guarded behind TAGFORGE_PIM_DATA_DIR and backend write lock.

listWorkspaceSummariesLoads organization-scoped workspace history for import runs, validation status, categoryCount, and unassignedProductCount.Cross-organization reads are rejected by the backend store.

Persisted category domainAuthenticated saves now return categories, categoryPlatformMappings, and categoryPlatformMappingCount for channel taxonomy prep.Mappings store source category path, target platform/category, taxonomy version, and required attributes.

Account & org accessOwner session tokens are signed as Authorization: Bearer tgf_session headers before cloud writes become tenant-owned.Raw bearer tokens and session secrets stay out of persisted account state.