The optimization score is tracked over time in score_history. Use this to measure the impact of content improvements — before and after running AI enhancement or batch normalize.
Each catalog tracks key metrics that help you assess content quality:
Total products — how many products are in the catalog
Feed-ready count — products that pass all validation rules
Average optimization score — mean quality score across all products
Score distribution — breakdown by excellent/good/warning/poor bands
Last published — when the catalog was last pushed live
Aim for 100% feed-ready products before publishing. Run Batch Gold first to identify which products need the most attention.
Last modified on March 18, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Alana Shopping B2B","description":"Help center and developer hub for Alana Shopping B2B — AI-powered product content platform for brands and retailers.","colors":{"primary":"#ff8086","light":"#ff8086","dark":"#ff8086"},"logo":{"light":"https://mintcdn.com/alana/Dr3xX14a3TaLPBgT/images/logo.svg?fit=max\u0026auto=format\u0026n=Dr3xX14a3TaLPBgT\u0026q=85\u0026s=f8ceb81884ba65a782265580405c98e3","dark":"https://mintcdn.com/alana/Dr3xX14a3TaLPBgT/images/logo-white.svg?fit=max\u0026auto=format\u0026n=Dr3xX14a3TaLPBgT\u0026q=85\u0026s=fa8d949b437d9de87f067f42621442c2","href":"https://alana.ai"},"favicon":"https://mintcdn.com/alana/Dr3xX14a3TaLPBgT/images/favicon.svg?fit=max\u0026auto=format\u0026n=Dr3xX14a3TaLPBgT\u0026q=85\u0026s=67a22eba367230becfd8a462a816847d","api":{"openapi":"openapi.json","playground":{"display":"interactive"}},"appearance":{"default":"system"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://app.alana.shopping","label":"Dashboard"}],"primary":{"type":"button","label":"Começar","href":"https://app.alana.shopping/auth/signup"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/alana-ai","github":"https://github.com/alana-ai"},"links":[{"header":"Produto","items":[{"label":"Dashboard","href":"https://app.alana.shopping"},{"label":"Motor de Conteúdo IA","href":"/pt/help/ai/how-ai-works"},{"label":"Integrações","href":"/pt/help/integrations/connecting-platforms"},{"label":"Planos e Preços","href":"/pt/help/account/plans-and-pricing"}]},{"header":"Desenvolvedores","items":[{"label":"Quickstart","href":"/pt/quickstart"},{"label":"Referência da API","href":"/pt/api-reference/overview"},{"label":"Guia de Webhooks","href":"/pt/guides/webhooks"},{"label":"Changelog","href":"/pt/changelog/overview"}]},{"header":"Empresa","items":[{"label":"Sobre a Alana","href":"https://alana.ai"},{"label":"Status do Sistema","href":"https://status.alana.shopping"},{"label":"Comunidade","href":"https://community.alana.ai"},{"label":"Fale com o Suporte","href":"mailto:support@alana.shopping"}]}]},"search":{"prompt":"Buscar na ajuda e docs..."},"seo":{"metatags":{"robots":"noindex, nofollow"}},"fonts":{"heading":{"family":"MuseoModerno","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"intercom":{"appId":"veyiki4k"}},"banner":{"content":"Bem-vindo ao nosso novo hub de docs! Central de Ajuda + Docs para Desenvolvedores em um só lugar.","dismissible":true},"errors":{"404":{"redirect":false,"title":"página não encontrada","description":"Esta página não existe ou pode ter sido movida. Tente buscar ou volte para a [Central de Ajuda](/pt/help/welcome)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"appearance":"light","fonts":{"family":"Inter"}},"metadata":{"timestamp":true},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":"pt/help/welcome"},{"language":"en","href":"en/help/welcome"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alana","hasAudioNarration":false,"actualSubdomain":"alana","customDomains":["docs.alana.shopping"],"gitSource":{"type":"github","owner":"a-alanaai","repo":"shopping-b2b-v1","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ab8cd53d3623a442e30ada6","collectionId":"ec538318-9dd1-4797-adf3-58756a6a8a4a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ab8cd53d3623a442e30ada6"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abbe86b11ea8cb4851ab88b","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"en","tag":"API Reference","count":90},{"language":"pt-BR","tag":"Referência da API","count":90},{"language":"en","tag":"Help Center","count":35},{"language":"pt-BR","tag":"Central de Ajuda","count":35},{"language":"en","tag":"Documentation","count":27},{"language":"pt-BR","tag":"Documentação","count":27},{"language":"default","tag":"API Reference","count":20},{"language":"en","tag":"Guides","count":14},{"language":"pt-BR","tag":"Guias","count":14},{"language":"en","tag":"Brands","count":11},{"language":"pt-BR","tag":"Marcas","count":11},{"language":"en","tag":"Core Concepts","count":10},{"language":"pt-BR","tag":"Conceitos Fundamentais","count":10},{"language":"en","tag":"Catalogs","count":9},{"language":"en","tag":"MCP Tools","count":9},{"language":"pt-BR","tag":"Catálogos","count":9},{"language":"pt-BR","tag":"MCP Tools","count":9},{"language":"default","tag":"Search API v1","count":8},{"language":"en","tag":"Feed API","count":7},{"language":"en","tag":"Surfaces","count":7},{"language":"pt-BR","tag":"Feed API","count":7},{"language":"pt-BR","tag":"Surfaces","count":7},{"language":"default","tag":"Analytics","count":4},{"language":"default","tag":"Platform Adapters","count":4},{"language":"default","tag":"Platform Guides","count":3},{"language":"default","tag":"Reference","count":1},{"language":"default","tag":"Documentation","count":1},{"language":"default","tag":"Guides","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@alana.shopping","showHelpButton":true}},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6992b47b0c445a8a6e628d35","deploymentId":"69913976347571420d709ca3","questionText":"How do I authenticate with the API?","status":"active","generatedBy":"manual","createdAt":"2026-02-16T06:08:59.400Z","updatedAt":"2026-02-16T06:08:59.400Z","__v":0},{"_id":"6992b4640c445a8a6e628d26","deploymentId":"69913976347571420d709ca3","questionText":"How does the AI content engine work?","status":"active","generatedBy":"manual","createdAt":"2026-02-16T06:08:36.976Z","updatedAt":"2026-02-16T06:08:36.976Z","__v":0},{"_id":"6992b44e0c445a8a6e628cf8","deploymentId":"69913976347571420d709ca3","questionText":"How do I create my first product catalog?","status":"active","generatedBy":"manual","createdAt":"2026-02-16T06:08:14.847Z","updatedAt":"2026-02-16T06:08:14.847Z","__v":0}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"en/guides/catalog-management","slug":"/en/guides/catalog-management","pageMetadata":{"title":"Catalog Management","description":"Create, publish, fork, and merge catalogs for structured product content workflows.","icon":"folder-open","href":"/en/guides/catalog-management"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create, publish, fork, and merge catalogs for structured product content workflows.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`creating-a-catalog`,children:`Creating a catalog`}),`\n`,_jsx(_components.p,{children:`Every product in Alana Shopping lives inside a catalog. Create one to start organizing your products:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://app.alana.shopping/api/workspace/{workspaceId}/catalogs\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Spring 2026\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"description\": \"Seasonal collection for Spring 2026\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`publishing-workflow`,children:`Publishing workflow`}),`\n`,_jsxs(_components.p,{children:[`The recommended workflow for managing product content follows a `,_jsx(_components.strong,{children:`fork-edit-merge`}),` pattern:`]}),`\n`,_jsx(Mermaid,{chart:`graph TD\n A[\"Main Catalog (Published)\"] -->|fork| B[\"Working Copy\"]\n B -->|add products| C[\"Edit Content\"]\n C -->|AI enhance| D[\"Optimize\"]\n D -->|review scores| E[\"QA Check\"]\n E -->|merge| A`}),`\n`,_jsx(Heading,{level:`3`,id:`publish-a-catalog`,children:`Publish a catalog`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \".../catalogs/{catalogId}/publish\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Once published, the catalog’s products appear in the public feed at `,_jsx(_components.code,{children:`/api/catalog/products`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`fork-for-editing`,children:`Fork for editing`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \".../catalogs/{catalogId}/fork\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"name\": \"Spring 2026 — QA Review\"}'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`merge-changes-back`,children:`Merge changes back`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \".../catalogs/{catalogId}/merge\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"targetCatalogId\": \"PARENT_CATALOG_ID\"}'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`batch-actions`,children:`Batch actions`}),`\n`,_jsx(_components.p,{children:`Run pipeline stages in bulk from the catalog view or via API:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Normalize (Silver)`}),` — field mapping, duplicate detection, image URL validation for a selection or entire catalog`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Analyze (Gold)`}),` — optimization scoring across 7 rubric stages, produces score + gaps list per product`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Batch Silver — normalize entire catalog`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \".../workspace/{workspaceId}/catalogs/{catalogId}/batch/silver\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"scope\": \"all\"}'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Batch Gold — score entire catalog`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \".../workspace/{workspaceId}/catalogs/{catalogId}/batch/gold\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"scope\": \"all\"}'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/guides/batch-actions`,children:`Batch Actions`}),` and the `,_jsx(_components.a,{href:`/api-reference/pipeline/overview`,children:`Pipeline API`}),` for full reference.`]}),`\n`,_jsx(Heading,{level:`2`,id:`pipeline-settings`,children:`Pipeline settings`}),`\n`,_jsx(_components.p,{children:`Customize how Silver and Gold process your products:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Silver field mappings`}),` — map source column names to Alana schema fields`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Gold scoring weights`}),` — adjust weights per rubric stage (identity, content, media, etc.)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Auto-trigger`}),` — automatically run Silver after Bronze, or Gold after Silver`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/guides/pipeline-settings`,children:`Pipeline Settings`}),` for the full configuration guide.`]}),`\n`,_jsx(Heading,{level:`2`,id:`score-evolution-tracking`,children:`Score evolution tracking`}),`\n`,_jsxs(_components.p,{children:[`The optimization score is tracked over time in `,_jsx(_components.code,{children:`score_history`}),`. Use this to measure the impact of content improvements — before and after running AI enhancement or batch normalize.`]}),`\n`,_jsx(Heading,{level:`2`,id:`catalog-statistics`,children:`Catalog statistics`}),`\n`,_jsx(_components.p,{children:`Each catalog tracks key metrics that help you assess content quality:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Total products`}),` — how many products are in the catalog`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Feed-ready count`}),` — products that pass all validation rules`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Average optimization score`}),` — mean quality score across all products`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Score distribution`}),` — breakdown by excellent/good/warning/poor bands`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Last published`}),` — when the catalog was last pushed live`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Aim for 100% feed-ready products before publishing. Run Batch Gold first to identify which products need the most attention.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Catalog Management","description":"Create, publish, fork, and merge catalogs for structured product content workflows.","icon":"folder-open","href":"/en/guides/catalog-management"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Creating a catalog","slug":"creating-a-catalog","depth":2,"children":[]},{"title":"Publishing workflow","slug":"publishing-workflow","depth":2,"children":[{"title":"Publish a catalog","slug":"publish-a-catalog","depth":3,"children":[]},{"title":"Fork for editing","slug":"fork-for-editing","depth":3,"children":[]},{"title":"Merge changes back","slug":"merge-changes-back","depth":3,"children":[]}]},{"title":"Batch actions","slug":"batch-actions","depth":2,"children":[]},{"title":"Pipeline settings","slug":"pipeline-settings","depth":2,"children":[]},{"title":"Score evolution tracking","slug":"score-evolution-tracking","depth":2,"children":[]},{"title":"Catalog statistics","slug":"catalog-statistics","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"alana","siteName":"Alana Shopping B2B","title":"Catalog Management - Alana Shopping B2B","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt/guides/catalog-management","matchLevel":1},"en":{"href":"/en/guides/catalog-management","matchLevel":0}}},"lastModified":"2026-03-18T01:20:40.704Z","gitLastModified":"2026-03-18T01:19:25.000Z","originalFileLocation":"en/guides/catalog-management.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create, publish, fork, and merge catalogs for structured product content workflows.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Alana Shopping B2B\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex, nofollow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Catalog Management - Alana Shopping B2B\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create, publish, fork, and merge catalogs for structured product content workflows.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alana Shopping B2B\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.alana.shopping/en/guides/catalog-management\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://alana.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Catalog+Management\u0026amp;description=Create%2C+publish%2C+fork%2C+and+merge+catalogs+for+structured+product+content+workflows.\u0026amp;theme=751e9dfaae674d63c87e5ec3\u0026amp;signature=b6dd39ce21476a03f611db7ac6a3341084d2ef9eb99a1b95d45af66b0e435e2f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Catalog Management - Alana Shopping B2B\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create, publish, fork, and merge catalogs for structured product content workflows.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://alana.mintlify.app/_mintlify/api/og/v2?division=Guides\u0026amp;title=Catalog+Management\u0026amp;description=Create%2C+publish%2C+fork%2C+and+merge+catalogs+for+structured+product+content+workflows.\u0026amp;theme=751e9dfaae674d63c87e5ec3\u0026amp;signature=b6dd39ce21476a03f611db7ac6a3341084d2ef9eb99a1b95d45af66b0e435e2f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/alana/mahZg_WJDAlT0TRo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Alana Shopping B2B\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff8086\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.alana.shopping/en/guides/catalog-management\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/guides/catalog-management.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.alana.shopping/#organization\",\"name\":\"Alana Shopping B2B\",\"url\":\"https://docs.alana.shopping\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alana/Dr3xX14a3TaLPBgT/images/logo.svg?fit=max\u0026auto=format\u0026n=Dr3xX14a3TaLPBgT\u0026q=85\u0026s=f8ceb81884ba65a782265580405c98e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.alana.shopping#website\",\"name\":\"Alana Shopping B2B\",\"url\":\"https://docs.alana.shopping\",\"publisher\":{\"@id\":\"https://docs.alana.shopping/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.alana.shopping/en/guides/catalog-management#webpage\",\"url\":\"https://docs.alana.shopping/en/guides/catalog-management\",\"name\":\"Catalog Management\",\"description\":\"Create, publish, fork, and merge catalogs for structured product content workflows.\",\"dateModified\":\"2026-03-18T01:19:25.000Z\",\"isPartOf\":{\"@id\":\"https://docs.alana.shopping#website\"},\"breadcrumb\":{\"@id\":\"https://docs.alana.shopping/en/guides/catalog-management#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.alana.shopping/en/guides/catalog-management#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.alana.shopping/en/guides/onboarding-flow\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Catalog Management\",\"item\":\"https://docs.alana.shopping/en/guides/catalog-management\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.alana.shopping/en/guides/catalog-management#article\",\"headline\":\"Catalog Management\",\"name\":\"Catalog Management\",\"description\":\"Create, publish, fork, and merge catalogs for structured product content workflows.\",\"url\":\"https://docs.alana.shopping/en/guides/catalog-management\",\"mainEntityOfPage\":{\"@id\":\"https://docs.alana.shopping/en/guides/catalog-management#webpage\"},\"dateModified\":\"2026-03-18T01:19:25.000Z\",\"publisher\":{\"@id\":\"https://docs.alana.shopping/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.alana.shopping#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Alana Shopping B2B\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Alana Shopping B2B","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"pages":[{"title":"pt-BR","href":"/pt/guides/catalog-management"}]},{"language":"en","tabs":[{"tab":"Help Center","icon":"life-ring","pages":[{"title":"Help Center","href":"/en/help/welcome"}]},{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Alana Shopping B2B","href":"/en/introduction"},{"title":"Quickstart","href":"/en/quickstart"},{"title":"Authentication","href":"/en/authentication"}]},{"group":"Core Concepts","pages":[{"title":"Workspaces","icon":"building","href":"/en/concepts/workspaces"},{"title":"Brands","icon":"tag","href":"/en/concepts/brands"},{"title":"Catalogs","icon":"folder-open","href":"/en/concepts/catalogs"},{"title":"Products","icon":"box","href":"/en/concepts/products"},{"title":"AI Engine","icon":"sparkles","href":"/en/concepts/ai-engine"},{"title":"Roles \u0026 Permissions","icon":"shield","href":"/en/concepts/roles-permissions"},{"title":"Data Pipeline","icon":"workflow","href":"/en/concepts/data-pipeline"},{"title":"Marketplace Hub","icon":"store","href":"/en/concepts/marketplace"},{"title":"Surfaces","icon":"layout","href":"/en/concepts/surfaces"},{"title":"Configurable Dashboards","icon":"chart-bar","href":"/en/concepts/dashboards"}]},{"group":"Guides","pages":[{"title":"Onboarding Flow","description":"Step-by-step guide to setting up your workspace after sign-up.","icon":"route","href":"/en/guides/onboarding-flow"},{"title":"Catalog Management","icon":"folder-open","href":"/en/guides/catalog-management"},{"title":"AI Content Generation","description":"Generate, enhance, and refine product content using brand-aware AI.","icon":"sparkles","href":"/en/guides/ai-content-generation"},{"title":"Surface Content Generation","icon":"sparkles","href":"/en/guides/surface-content-generation"},{"title":"Product Import","icon":"upload","href":"/en/guides/product-import"},{"title":"Integrations","icon":"plug","href":"/en/guides/integrations"},{"title":"Billing \u0026 Plans","icon":"credit-card","href":"/en/guides/billing-plans"},{"title":"Webhooks","icon":"webhook","href":"/en/guides/webhooks"},{"title":"Data Enrichment","icon":"sparkles","href":"/en/guides/data-enrichment"},{"title":"Marketplace Publishing","icon":"send","href":"/en/guides/marketplace-publishing"},{"title":"URL Import","icon":"link","href":"/en/guides/url-import"},{"title":"Batch Actions","icon":"list-checks","href":"/en/guides/batch-actions"},{"title":"Pipeline Settings","icon":"settings","href":"/en/guides/pipeline-settings"},{"title":"TypeScript SDK","icon":"npm","href":"/en/guides/sdk-typescript"},{"title":"Observability","href":"/observability"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/en/api-reference/overview"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/en/changelog/overview"}]},{"tab":"System Status","icon":"signal","href":"https://status.alana.shopping"}]}]},"title":"Catalog Management - Alana Shopping B2B","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":[],"chunks":[]}
