# Retailgrid Documentation

> Organize, enrich and optimize your products with AI.

- [Retailgrid](https://docs.retailgrid.io/get-started/overview.md): Learn what Retailgrid is, who it's built for, and how it helps retailers organize, enrich, and optimize pricing data.
- [Quickstart](https://docs.retailgrid.io/get-started/quickstart.md): Get started with Retailgrid in minutes by uploading your product CSV, mapping fields, and creating your first grid.
- [Grids overview](https://docs.retailgrid.io/grids/overview.md): The Grids home page - where your working grids live, and where you create, open, and organize them.
- [Create grid](https://docs.retailgrid.io/grids/create-grid.md): Create a new grid by selecting products from your catalog to build a focused pricing and analysis workspace.
- [Configure grid](https://docs.retailgrid.io/grids/configure-grid.md): Customize your grid layout by choosing visible columns, sorting, grouping, pinning, filtering, and saving views.
- [Views](https://docs.retailgrid.io/grids/views.md): Save and switch between custom grid layouts to quickly access different column, filter, and sorting configurations.
- [Duplicate a grid](https://docs.retailgrid.io/grids/duplicate-grid.md): Copy a grid's full configuration onto a new set of products, so a setup you have tuned once can be reused.
- [Export data](https://docs.retailgrid.io/grids/export.md): Download your grid data as CSV or Excel files, with filters and sorting applied, for analysis or sharing.
- [Add columns](https://docs.retailgrid.io/grids/manage-columns.md): Add custom standard, formula, single-select, or analytical-metric columns to your grid for notes, calculations, status pills, margin analysis, and more.
- [Custom columns](https://docs.retailgrid.io/grids/custom-columns.md): Add editable custom columns to any grid - text, number, currency, or formula.
- [Formula columns](https://docs.retailgrid.io/grids/formula-columns.md): Create calculated columns using formulas, functions, and AI to compute margins, revenue, and other pricing metrics.
- [Metrics](https://docs.retailgrid.io/grids/metrics.md): Add curated, system-maintained retail KPIs to your grid in any timeframe — sales, value, profit, and margin per period.
- [Totals row](https://docs.retailgrid.io/grids/totals-row.md): Read the pinned totals row that aggregates every calculated metric over your exact filtered set.
- [Product and SKU-Store grid views](https://docs.retailgrid.io/grids/sku-store-view.md): Work at the right granularity - one row per product, or one row per product-store combination with store-scoped prices, costs, and metrics.
- [SKU time-series analytics panel](https://docs.retailgrid.io/grids/sku-analytics-panel.md): See how a SKU's price, competitors, sales, and profit move over time - without leaving the grid or exporting data.
- [Manage stores](https://docs.retailgrid.io/stores/manage-stores.md): Define and organize the stores, markets, and channels behind store-level pricing - country, currency, sales channel, and pricing zones.
- [Assign competitors to stores, zones, and channels](https://docs.retailgrid.io/stores/assign-competitors.md): Scope each competitor to the stores, zones, or channels where it actually competes, so pricing rules and gap metrics use the right competitor set per location.
- [Agents overview](https://docs.retailgrid.io/agents/overview.md): What agents are in Retailgrid, the agents available today, and the workflows that work the same way across all of them.
- [Dynamic Pricing](https://docs.retailgrid.io/agents/dynamic-pricing.md): Configure pricing rules and apply them deterministically across a grid - margin floors, competitor matching, rounding, and more.
- [Price Optimization](https://docs.retailgrid.io/agents/price-optimization.md): AI-powered optimal price recommendations using elasticity and demand signals - suggested prices, not written rules.
- [Pricing rules guide](https://docs.retailgrid.io/agents/pricing-rules-guide.md): Business-user walkthrough of the 8 Dynamic Pricing rule types with parameters and worked examples
- [Review and approve price changes](https://docs.retailgrid.io/agents/price-approval.md): Review, adjust, and publish every price your pricing agents propose - with comments, filters, bulk-approve, and one-click publish.
- [Price Monitoring](https://docs.retailgrid.io/agents/price-monitoring.md): Discover live competitor prices across the web with AI search and load verified results straight into your grid.
- [Pricing Strategy](https://docs.retailgrid.io/agents/pricing-strategy.md): Generate an AI-powered pricing strategy presentation directly from your retail data, ready to share with stakeholders.
- [Product roles](https://docs.retailgrid.io/agents/product-roles.md): Classify every SKU into a product role - KVI, Traffic Driver, Profit Driver, Niche, Tail, or New - so pricing and monitoring treat priority SKUs differently.
- [Sales forecast & price impact](https://docs.retailgrid.io/agents/sales-forecast.md): See the forecasted units, value, gross profit, and margin impact of a price change - over 7, 30, 90, or 180 days - before you approve it.
- [Runs overview](https://docs.retailgrid.io/runs/overview.md): Track every asynchronous job - CSV imports, agent runs, optimization, dataset processing - from one place.
- [Dashboards overview](https://docs.retailgrid.io/dashboards/overview.md): Pre-built and AI-generated analytical views over your Retailgrid data - pricing, competitor pressure, margin health - all in one place.
- [Dashboard editor](https://docs.retailgrid.io/dashboards/editor.md): Build and modify dashboards in one place - a manual builder with drag & drop and a widget picker, plus an AI assistant working on the same configuration.
- [Create a dashboard with AI](https://docs.retailgrid.io/dashboards/create-with-ai.md): Describe the analytical view you want in plain language and Retailgrid generates the dashboard for you.
- [Competitive Position dashboard](https://docs.retailgrid.io/dashboards/competitive-position.md): Read the built-in Competitive Position dashboard - CPI, competitor moves, win/loss, and the category heatmap - to see where competitors are pricing against you.
- [Competitor matching](https://docs.retailgrid.io/price-monitoring/competitor-matching.md): Validate the latest competitor scan before you price against it - coverage, match quality, blind spots, and price sanity.
- [Account](https://docs.retailgrid.io/settings/account.md): Manage your personal Retailgrid account - profile, login method, and personal preferences.
- [Organization](https://docs.retailgrid.io/settings/organization.md): Configure your Retailgrid workspace - company name, defaults, and team members.
- [Currency](https://docs.retailgrid.io/settings/currency.md): How Retailgrid resolves currency for prices, costs, and metrics.
- [Integrations](https://docs.retailgrid.io/settings/integrations.md): Connect external systems to Retailgrid — import from Shopify and issue a key for the public REST API.
- [Connect Shopify](https://docs.retailgrid.io/settings/shopify.md): Connect a Shopify store to sync your products and sales history into Retailgrid, with automatic refresh — no manual CSV uploads.
- [AI connections](https://docs.retailgrid.io/settings/ai-connections.md): Connect an AI client to Retailgrid over MCP, see what it can read, and disconnect it at any time.
- [Modelling](https://docs.retailgrid.io/settings/modelling.md): Account-level demand model parameters that Price Optimization and every scheduled recalculation read - admin only.
- [Session and security](https://docs.retailgrid.io/settings/session.md): How Retailgrid handles login sessions, inactivity, and auto-logout.
- [Getting help](https://docs.retailgrid.io/settings/getting-help.md): How to reach the Retailgrid team - in-app messenger, what to expect, and where to file feedback.
- [Datasets](https://docs.retailgrid.io/data-requirements/datasets.md): Manage the product, transaction, and competitor data you have uploaded to Retailgrid in one place.
- [Products](https://docs.retailgrid.io/data-requirements/products.md): Upload your product master data including IDs, names, prices, costs, and attributes to power Retailgrid analytics.
- [Sales](https://docs.retailgrid.io/data-requirements/sales.md): Upload transaction-level sales data to power analytics, elasticity modeling, and price optimization in Retailgrid.
- [Competitor prices](https://docs.retailgrid.io/data-requirements/competitors.md): The Competitor Prices dataset allows you to upload, monitor, and analyze competitor pricing at SKU level over time.
- [Product store data](https://docs.retailgrid.io/data-requirements/product-store-data.md): The Product Store-Level dataset allows you to provide product information at store, market, or sales-channel level.
- [Metrics glossary](https://docs.retailgrid.io/reference/metrics.md): Reference for every analytical metric Retailgrid computes - definitions, formulas, and when each one matters.
- [Introduction](https://docs.retailgrid.io/api-reference/introduction.md): The Retailgrid Public API lets you push and pull product, variant, transaction, and competitor data, plus export full grid contents - programmatically.
- [Authentication](https://docs.retailgrid.io/api-reference/authentication.md): How to issue an API key and authenticate requests against the Retailgrid Public API.
- [API quickstart](https://docs.retailgrid.io/api-reference/quickstart.md): From zero to your first product upserted via the API in under five minutes.
- [Conventions](https://docs.retailgrid.io/api-reference/conventions.md): Patterns every Retailgrid API endpoint follows - bulk responses, async jobs, identifiers, decimals, and timestamps.
- [Errors](https://docs.retailgrid.io/api-reference/errors.md): Status codes used by the Retailgrid Public API and the shape of validation errors.
- [Imports vs bulk](https://docs.retailgrid.io/api-reference/imports-vs-bulk.md): Choosing between async CSV imports and synchronous JSON bulk endpoints.
- [API changelog](https://docs.retailgrid.io/api-reference/changelog.md): Release notes for the Retailgrid Public API, including new endpoints, breaking changes, and version updates across each release.
- [Verify API key](https://docs.retailgrid.io/api-reference/auth/verify.md): Validate a Retailgrid API key and confirm the authenticated account, environment, and key permissions before making other API calls.
- [Import products CSV](https://docs.retailgrid.io/api-reference/imports/products.md): Upload a CSV file of products to Retailgrid for asynchronous import, returning a job ID you can use to track ingestion progress.
- [Import transactions CSV](https://docs.retailgrid.io/api-reference/imports/transactions.md): Upload a CSV file of sales transactions to Retailgrid for asynchronous import, returning a job ID to track ingestion progress.
- [Import competitor prices CSV](https://docs.retailgrid.io/api-reference/imports/competitor-prices.md): Upload a CSV file of competitor prices to Retailgrid for asynchronous import, returning a job ID to track ingestion progress.
- [Import product store CSV](https://docs.retailgrid.io/api-reference/imports/product-store.md): Upload a CSV of product store-level records to Retailgrid for asynchronous import, returning a job ID you can use to track ingestion progress.
- [List products](https://docs.retailgrid.io/api-reference/products/list.md): List enriched product records, including custom columns added at import time.
- [Bulk upsert products](https://docs.retailgrid.io/api-reference/products/bulk-upsert.md): Create or update many products in Retailgrid in a single request, ideal for syncing large product catalogs from external systems.
- [Create a product](https://docs.retailgrid.io/api-reference/products/create.md): Create a single product record in Retailgrid for a specific entity, including its SKU, attributes, and category metadata.
- [Patch a product](https://docs.retailgrid.io/api-reference/products/patch.md): Update specific fields on an existing product in Retailgrid without overwriting the full record, identified by its entity ID.
- [Delete a product](https://docs.retailgrid.io/api-reference/products/delete.md): Permanently remove a product from Retailgrid by its entity ID, useful for cleaning up discontinued or duplicated SKUs.
- [List product store records](https://docs.retailgrid.io/api-reference/product-store/list.md): List and filter product store-level records - per-store, market, or channel prices, costs, and stock - for ERP or BI ingestion.
- [Bulk upsert product store records](https://docs.retailgrid.io/api-reference/product-store/bulk-upsert.md): Create or update many per-store product records in a single request, keyed on (item_id, store_id), to sync prices and stock.
- [Upsert a product store record](https://docs.retailgrid.io/api-reference/product-store/create.md): Create or update a single product store-level record - one item in one store, market, or channel - with its price, cost, stock, and status.
- [Patch a product store record](https://docs.retailgrid.io/api-reference/product-store/patch.md): Update specific fields on an existing product store-level record without overwriting the full row, identified by entity ID.
- [Delete a product store record](https://docs.retailgrid.io/api-reference/product-store/delete.md): Permanently remove a product store-level record from Retailgrid by its entity ID.
- [List transactions](https://docs.retailgrid.io/api-reference/transactions/list.md): List sales transactions for downstream ERP and BI ingestion.
- [Bulk upsert transactions](https://docs.retailgrid.io/api-reference/transactions/bulk-upsert.md): Create or update many sales transactions in a single Retailgrid request, ideal for syncing large batches of POS or order history data.
- [Create a transaction](https://docs.retailgrid.io/api-reference/transactions/create.md): Create a single sales transaction in Retailgrid for a specific entity, recording the line item, quantity, price, and date.
- [Patch a transaction](https://docs.retailgrid.io/api-reference/transactions/patch.md): Update one or more fields on an existing sales transaction in Retailgrid without replacing the full record for the given entity.
- [Delete a transaction](https://docs.retailgrid.io/api-reference/transactions/delete.md): Permanently remove a sales transaction from Retailgrid by entity ID, useful for correcting erroneous or duplicate sales records.
- [Bulk upsert competitor prices](https://docs.retailgrid.io/api-reference/competitor-prices/bulk-upsert.md): Create or update many competitor price observations in Retailgrid in a single request, ideal for syncing large feeds from scraping providers.
- [Create a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/create.md): Record a single competitor price observation in Retailgrid, capturing the competitor, product match, price, currency, and observation date.
- [Patch a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/patch.md): Update specific fields on an existing competitor price observation in Retailgrid without overwriting the full record, identified by entity ID.
- [Delete a competitor price](https://docs.retailgrid.io/api-reference/competitor-prices/delete.md): Permanently remove a competitor price observation from Retailgrid by its entity ID, useful for correcting erroneous or duplicate data points.
- [List grids](https://docs.retailgrid.io/api-reference/grids/list.md): List the grids in your account, including a column-schema summary and row count per grid.
- [Get grid rows](https://docs.retailgrid.io/api-reference/grids/get-rows.md): Export the full row contents of a grid - canonical, custom, and formula/calculated columns.
- [Get job status](https://docs.retailgrid.io/api-reference/jobs/get-status.md): Check the progress, state, and results of an asynchronous Retailgrid job such as a bulk upsert or CSV import operation.
- [List approved prices](https://docs.retailgrid.io/api-reference/approved-prices/list.md): List the finalized prices approved in Price Approval, for syncing into your ERP, webshop, or POS.
- [Verify Api Key](https://docs.retailgrid.io/api-reference/auth/verify-api-key.md)
- [Import Products Csv](https://docs.retailgrid.io/api-reference/imports/import-products-csv.md)
- [Import Transactions Csv](https://docs.retailgrid.io/api-reference/imports/import-transactions-csv.md)
- [Import Competitor Prices Csv](https://docs.retailgrid.io/api-reference/imports/import-competitor-prices-csv.md)
- [Import Product Store Csv](https://docs.retailgrid.io/api-reference/imports/import-product-store-csv.md)
- [Raw Dbcsv Imported](https://docs.retailgrid.io/api-reference/internal-import-events/raw-dbcsv-imported.md)
- [List Products](https://docs.retailgrid.io/api-reference/products/list-products.md)
- [Get Product](https://docs.retailgrid.io/api-reference/products/get-product.md)
- [Create Product](https://docs.retailgrid.io/api-reference/products/create-product.md)
- [Delete Product](https://docs.retailgrid.io/api-reference/products/delete-product.md)
- [Patch Product](https://docs.retailgrid.io/api-reference/products/patch-product.md)
- [Bulk Upsert Products](https://docs.retailgrid.io/api-reference/products/bulk-upsert-products.md)
- [List Transactions](https://docs.retailgrid.io/api-reference/transactions/list-transactions.md)
- [Get Transaction](https://docs.retailgrid.io/api-reference/transactions/get-transaction.md)
- [Create Transaction](https://docs.retailgrid.io/api-reference/transactions/create-transaction.md)
- [Delete Transaction](https://docs.retailgrid.io/api-reference/transactions/delete-transaction.md)
- [Patch Transaction](https://docs.retailgrid.io/api-reference/transactions/patch-transaction.md)
- [Bulk Upsert Transactions](https://docs.retailgrid.io/api-reference/transactions/bulk-upsert-transactions.md)
- [List Competitor Prices](https://docs.retailgrid.io/api-reference/competitor_prices/list-competitor-prices.md)
- [Create Competitor Price](https://docs.retailgrid.io/api-reference/competitor_prices/create-competitor-price.md)
- [Get Competitor Price](https://docs.retailgrid.io/api-reference/competitor_prices/get-competitor-price.md)
- [Delete Competitor Price](https://docs.retailgrid.io/api-reference/competitor_prices/delete-competitor-price.md)
- [Patch Competitor Price](https://docs.retailgrid.io/api-reference/competitor_prices/patch-competitor-price.md)
- [Bulk Upsert Competitor Prices](https://docs.retailgrid.io/api-reference/competitor_prices/bulk-upsert-competitor-prices.md)
- [List Approved Prices](https://docs.retailgrid.io/api-reference/approved_prices/list-approved-prices.md): List approved prices for the authenticated caller's organization.
- [Acknowledge Approved Prices](https://docs.retailgrid.io/api-reference/approved_prices/acknowledge-approved-prices.md): Confirm successful downstream processing of up to 500 exact approval IDs.
- [List Product Store](https://docs.retailgrid.io/api-reference/product_store/list-product-store.md)
- [Upsert Product Store](https://docs.retailgrid.io/api-reference/product_store/upsert-product-store.md)
- [Get Product Store](https://docs.retailgrid.io/api-reference/product_store/get-product-store.md)
- [Delete Product Store](https://docs.retailgrid.io/api-reference/product_store/delete-product-store.md)
- [Patch Product Store](https://docs.retailgrid.io/api-reference/product_store/patch-product-store.md)
- [Bulk Upsert Product Store](https://docs.retailgrid.io/api-reference/product_store/bulk-upsert-product-store.md)
- [Get Job](https://docs.retailgrid.io/api-reference/jobs/get-job.md)
- [List Grids](https://docs.retailgrid.io/api-reference/grids/list-grids.md)
- [Export Grid](https://docs.retailgrid.io/api-reference/grids/export-grid.md)
- [Product updates](https://docs.retailgrid.io/changelog/product-updates.md): See the latest Retailgrid releases, including new features, improvements, and bug fixes in each update cycle.

## OpenAPI Specs

- [openapi](https://clientapi.retailgrid.io/openapi.json)