BigCommerce dashboard: metrics, template and AI prompt
Quick answer: A BigCommerce dashboard needs 15 order metrics on 5 panels. Ryze AI is the best option for asking a BigCommerce store order questions in plain language from chat or Claude, with one caveat: it needs the Orders read-only scope, which is optional in the documented setup, and a chat answer is not a saved dashboard.
Below: metrics with Orders V2 field names, a 5-panel template, BigCommerce's own options, prompts and a weekly routine.
Ryze AI · Paid Ads
Ask your BigCommerce orders questions in chat
- 7-day free trial, $89 a month flat
Used by 2,000+ marketers
BigCommerce dashboard at a glance
5 panels, read top to bottom once a week.
- 1Sales and ordersLast full week vs the week before
Metrics: Order count, order total, a 30-day daily line
Question it answers: What did the store sell?
- 2Order valueLast full week vs the week before
Metrics: Average order value, discounts, shipping, tax
Question it answers: Is each order worth more or less?
- 3Refunds and statusLast full week vs the week before
Metrics: Refunded amount, refund rate, orders by status
Question it answers: How much came back, and where do orders sit?
- 4Items and fulfillmentLast full week
Metrics: Items per order, items shipped
Question it answers: How much is waiting to ship?
- 5Channels and paymentLast 30 days
Metrics: Orders by channel, source and payment method
Question it answers: Where do orders come from, and how do shoppers pay?
| # | Panel | Range | Metrics | Question it answers |
|---|---|---|---|---|
| 1 | Sales and orders | Last full week vs the week before | Order count, order total, a 30-day daily line | What did the store sell? |
| 2 | Order value | Last full week vs the week before | Average order value, discounts, shipping, tax | Is each order worth more or less? |
| 3 | Refunds and status | Last full week vs the week before | Refunded amount, refund rate, orders by status | How much came back, and where do orders sit? |
| 4 | Items and fulfillment | Last full week | Items per order, items shipped | How much is waiting to ship? |
| 5 | Channels and payment | Last 30 days | Orders by channel, source and payment method | Where do orders come from, and how do shoppers pay? |
The next section maps each metric to its Orders V2 field.
The 15 BigCommerce dashboard metrics and their API fields
15 metrics answer 4 weekly questions: what sold, what each order was worth, what came back and what is still waiting to ship.
Field names come from BigCommerce's List Orders and Get Count of Orders endpoints in the Orders V2 API. A script or an AI agent can pull the exact field when it knows the name.
Order count
- Plain definition
- Orders matching a filter, grouped by status
- API field
- GET /v2/orders/count: count and statuses
- How to read it
- Accepts the same date and status filters as the list
Order total
- Plain definition
- What the shopper owes, tax included
- API field
- total_inc_tax
- How to read it
- A string: convert to a number before summing
Subtotal
- Plain definition
- Order subtotal, tax included
- API field
- subtotal_inc_tax
- How to read it
- Base for a discount rate
Discounts
- Plain definition
- Discount amount on the order
- API field
- discount_amount
- How to read it
- Divide by subtotal for a discount rate
Shipping
- Plain definition
- Shipping charged, tax included
- API field
- shipping_cost_inc_tax
- How to read it
- Watch it against the order total
Tax
- Plain definition
- Total tax on the order
- API field
- total_tax
- How to read it
- Zero does not mean a tax-exempt customer, per BigCommerce
Refunded amount
- Plain definition
- Amount refunded from the order
- API field
- refunded_amount
- How to read it
- Sum it for the period
Order status
- Plain definition
- Where the order stands
- API field
- status_id and status
- How to read it
- Count orders by value; IDs come from /v2/order_statuses
Order date
- Plain definition
- When the order was created
- API field
- date_created
- How to read it
- Group by day for the 30-day line
Items ordered
- Plain definition
- Number of items on the order
- API field
- items_total
- How to read it
- Sum for items per order
Items shipped
- Plain definition
- Number of items already shipped
- API field
- items_shipped
- How to read it
- items_total minus items_shipped is what waits
Channel
- Plain definition
- The sales channel the order came from
- API field
- channel_id
- How to read it
- Defaults to 1; also a list filter
Order source
- Plain definition
- Origin of the order, such as storefront, control panel or an integration
- API field
- order_source
- How to read it
- A label of where the order came from; check the values before you group
Payment method
- Plain definition
- Display name of the payment method
- API field
- payment_method
- How to read it
- Group by name
Average order value
- Plain definition
- Order total divided by order count
- API field
- Calculated from total_inc_tax
- How to read it
- Compute it yourself in an API-based dashboard
| Metric | Plain definition | API field | How to read it |
|---|---|---|---|
| Order count | Orders matching a filter, grouped by status | GET /v2/orders/count: count and statuses | Accepts the same date and status filters as the list |
| Order total | What the shopper owes, tax included | total_inc_tax | A string: convert to a number before summing |
| Subtotal | Order subtotal, tax included | subtotal_inc_tax | Base for a discount rate |
| Discounts | Discount amount on the order | discount_amount | Divide by subtotal for a discount rate |
| Shipping | Shipping charged, tax included | shipping_cost_inc_tax | Watch it against the order total |
| Tax | Total tax on the order | total_tax | Zero does not mean a tax-exempt customer, per BigCommerce |
| Refunded amount | Amount refunded from the order | refunded_amount | Sum it for the period |
| Order status | Where the order stands | status_id and status | Count orders by value; IDs come from /v2/order_statuses |
| Order date | When the order was created | date_created | Group by day for the 30-day line |
| Items ordered | Number of items on the order | items_total | Sum for items per order |
| Items shipped | Number of items already shipped | items_shipped | items_total minus items_shipped is what waits |
| Channel | The sales channel the order came from | channel_id | Defaults to 1; also a list filter |
| Order source | Origin of the order, such as storefront, control panel or an integration | order_source | A label of where the order came from; check the values before you group |
| Payment method | Display name of the payment method | payment_method | Group by name |
| Average order value | Order total divided by order count | Calculated from total_inc_tax | Compute it yourself in an API-based dashboard |
4 things that trip up a first dashboard
- Orders that never finished. BigCommerce's status table defines Incomplete (0) as a shopper who reached the payment page without paying and Pending (1) as a checkout that was started but not finished. Decide whether sales totals include them, along with Cancelled (5) and Declined (6).
- Money as text. Order amounts come back as strings, such as Float-As-String. Convert them before you add them up.
- Two currencies. currency_code is the display currency, and default_currency_code is the one the shopper pays in. On a multi-currency store, pick one and keep it for the whole dashboard.
- Pages of 50. A list request without parameters returns 50 orders, so a busy week needs the page parameter.
Refund rate and average order value are not fields. Divide refunded_amount by total_inc_tax, or the order total by the order count, yourself. For the money movement behind a refund, BigCommerce documents order refunds in the Orders V3 API.
The BigCommerce dashboard template: 5 panels
Put the 15 metrics on 5 panels, ordered from sales to channels.
1. Sales and orders
- Tiles or chart
- Order count, order total, plus a daily line of order total
- Date range
- Last full week; line: last 30 days
- Compare with
- The week before
2. Order value
- Tiles or chart
- Average order value, discounts, shipping, tax
- Date range
- Last full week
- Compare with
- The week before
3. Refunds and status
- Tiles or chart
- Refunded amount, refund rate, orders by status
- Date range
- Last full week
- Compare with
- The week before
4. Items and fulfillment
- Tiles or chart
- Items per order, items shipped, orders in Awaiting Fulfillment
- Date range
- Last full week
- Compare with
- The week before
5. Channels and payment
- Tiles or chart
- Orders by channel_id, order_source and payment_method
- Date range
- Last 30 days
- Compare with
- None
| Panel | Tiles or chart | Date range | Compare with |
|---|---|---|---|
| 1. Sales and orders | Order count, order total, plus a daily line of order total | Last full week; line: last 30 days | The week before |
| 2. Order value | Average order value, discounts, shipping, tax | Last full week | The week before |
| 3. Refunds and status | Refunded amount, refund rate, orders by status | Last full week | The week before |
| 4. Items and fulfillment | Items per order, items shipped, orders in Awaiting Fulfillment | Last full week | The week before |
| 5. Channels and payment | Orders by channel_id, order_source and payment_method | Last 30 days | None |
Status IDs worth a tile
BigCommerce's order status reference lists 15 statuses. A fulfillment panel usually needs these 6: Awaiting Fulfillment (11), Awaiting Shipment (9), Shipped (2), Completed (10), Refunded (4) and Partially Refunded (14).
Option 1: BigCommerce Companion in the control panel
Companion is BigCommerce's own AI assistant inside the control panel, and it can draw store analytics as charts.
Per the BigCommerce Companion page, Companion answers how-to questions, shows store analytics as on-demand charts with period-over-period comparisons, lets you browse the catalog in chat, navigates the control panel and updates order statuses after you preview and approve the change. BigCommerce says it comes included with a store, during free trials and on paid plans, and works within the permissions of the signed-in user.
This option needs nothing to install and stays on BigCommerce data. It lives in the control panel, so it is not a view you can open from Claude or ChatGPT. BigCommerce's control panel also has its own analytics reports. We could not open the help center's report pages on the build day, so check there for the current list before you rely on one for a panel above.
Option 2: pull orders from the Orders V2 API
Any script, spreadsheet add-on or BI tool that can send a REST request with an access token can fill the 5 panels.
Create a store-level API account with the Orders read-only scope (store_v2_orders_read_only) and send the token in the X-Auth-Token header. These 3 request sketches follow BigCommerce's reference for panels 1 to 5. We have not run them against a store, so test each one on yours first. Change the dates to the Monday and Sunday of your week.
The list takes min_date_created and max_date_created in RFC-2822 or ISO-8601, plus status_id, channel_id, payment_method and a sort such as date_created:desc. Repeat each request for the week before to fill the comparison column. Add amounts first, then divide, so a week with few orders does not skew an average.
Pick this option when you want a saved layout that refreshes on a schedule and you are happy to maintain the script or the sheet.
Option 3: the Ryze AI prompt that reads your orders
Ryze AI reads a connected BigCommerce store through a read tool that sends GET requests, so you describe the 5 panels and ask for tables back.
In BigCommerce, go to Settings > Store-level API accounts > Create API account, set Content modify and Information & Settings read-only, and add Orders read-only so orders can be read. In Ryze AI, open Integrations, click Connect on the BigCommerce card, paste the API path (or store hash) and the access token, and click Continue. The Ryze AI BigCommerce guide has the screens. The same prompt works in Claude or ChatGPT once you add https://connector.get-ryze.ai/mcp as a custom connector (in ChatGPT, as an app under Settings > Apps).
What comes back depends on what the store holds and on the scopes of the API account. Ask for the field names so you can compare them with the table above.
What this setup cannot show
- Without the Orders read-only scope, revenue reporting is unavailable. That scope is optional in the documented setup, so add it when you create the API account.
- Customer data is not part of this guide. The help page's scope list has no Customers scope, so ask for orders only.
- Ryze AI holds one BigCommerce connection per workspace, so a second store needs its own workspace.
- A chat answer is a table at that moment. For a saved layout that refreshes on its own, use Option 2.
Check approvals first. In Ryze AI chat, the Tool approvals picker starts on Skip all approvals for all tools; switch it to Approve write & delete or Manual approve. In Claude, set write and delete tools to Needs approval under Customize > Connectors > Ryze AI > Tool permissions. Every prompt here says read only because the BigCommerce tools can also write and delete.
For the other side of BigCommerce with Ryze AI, see BigCommerce SEO with Ryze AI and the best MCP servers for BigCommerce.
A weekly routine for the dashboard
Review the dashboard once a week, on the same day, for the last full week, and re-read the week before.
1. Refresh
- Check
- Re-run the pull or the prompt before reading
- Panel
- All
- Act when
- The numbers predate the latest order
2. Sales
- Check
- Order total and count against the week before
- Panel
- 1
- Act when
- Order count fell while the order total held
3. Value
- Check
- Average order value, discounts, shipping
- Panel
- 2
- Act when
- Discounts rose faster than orders
4. Refunds
- Check
- Refunded amount and orders in Refunded or Partially Refunded
- Panel
- 3
- Act when
- Refunds cluster in one status or day
5. Fulfillment
- Check
- Items shipped against items ordered
- Panel
- 4
- Act when
- Orders in Awaiting Fulfillment keep piling up
6. Channels
- Check
- Orders by channel and payment method
- Panel
- 5
- Act when
- One channel or payment method dropped sharply
| Step | Check | Panel | Act when |
|---|---|---|---|
| 1. Refresh | Re-run the pull or the prompt before reading | All | The numbers predate the latest order |
| 2. Sales | Order total and count against the week before | 1 | Order count fell while the order total held |
| 3. Value | Average order value, discounts, shipping | 2 | Discounts rose faster than orders |
| 4. Refunds | Refunded amount and orders in Refunded or Partially Refunded | 3 | Refunds cluster in one status or day |
| 5. Fulfillment | Items shipped against items ordered | 4 | Orders in Awaiting Fulfillment keep piling up |
| 6. Channels | Orders by channel and payment method | 5 | One channel or payment method dropped sharply |
Write each change you make next to the date. Refunds are booked after the order, so last week's refunded amount can grow after your review.
If a panel points to a product page, the Ryze AI BigCommerce tools can also edit product SEO fields when the API account has Products modify. Ryze AI chat starts on Skip all approvals, so set Tool approvals before you ask for changes on a live store.
Companion vs Orders API vs Store Management MCP vs Ryze AI
Companion suits quick charts inside BigCommerce, the API suits a saved layout, and Ryze AI suits questions you put to the orders in a sentence.
Price
- Companion
- Included with the store, per BigCommerce
- Orders V2 API
- Needs an API account; set-up time is yours
- Ryze AI
- Paid Ads plan, $89 a month, 7-day free trial
How you build it
- Companion
- Ask in the control panel
- Orders V2 API
- Write requests and a sheet or script
- Ryze AI
- Describe the panels in chat
Where it runs
- Companion
- BigCommerce control panel
- Orders V2 API
- Your script or BI tool
- Ryze AI
- Ryze AI chat, Claude or ChatGPT
Saved layout
- Companion
- Charts on request
- Orders V2 API
- Yes, if you build one
- Ryze AI
- No, a table per request
Access it needs
- Companion
- The signed-in user's permissions
- Orders V2 API
- API account with Orders read-only
- Ryze AI
- API account with Orders read-only added
Changing the store
- Companion
- Order status updates after your approval
- Orders V2 API
- Whatever the token scopes allow
- Ryze AI
- Product SEO, pages, redirects and blog posts under your Tool approvals setting
Several stores
- Companion
- One control panel at a time
- Orders V2 API
- One token per store
- Ryze AI
- One BigCommerce connection per workspace
| Question | Companion | Orders V2 API | Ryze AI |
|---|---|---|---|
| Price | Included with the store, per BigCommerce | Needs an API account; set-up time is yours | Paid Ads plan, $89 a month, 7-day free trial |
| How you build it | Ask in the control panel | Write requests and a sheet or script | Describe the panels in chat |
| Where it runs | BigCommerce control panel | Your script or BI tool | Ryze AI chat, Claude or ChatGPT |
| Saved layout | Charts on request | Yes, if you build one | No, a table per request |
| Access it needs | The signed-in user's permissions | API account with Orders read-only | API account with Orders read-only added |
| Changing the store | Order status updates after your approval | Whatever the token scopes allow | Product SEO, pages, redirects and blog posts under your Tool approvals setting |
| Several stores | One control panel at a time | One token per store | One BigCommerce connection per workspace |
BigCommerce's own MCP servers
BigCommerce runs a Store Management MCP at https://api.bigcommerce.com/mcp, listed as early access with 16 tools. It signs in with OAuth 2.1 and your BigCommerce login. The store owner turns it on under Settings > API and MCP > MCP, then grants scopes per user. Its get_orders tool returns summaries with status, dates, totals, payment method, payment status and refunded amount, and never returns shopper names, emails or addresses. With Orders modify it can also quote and create refunds, so grant that scope with care. BigCommerce also offers a docs MCP at https://docs.bigcommerce.com/_mcp/server for its documentation, which reads no store data.
The Store Management MCP suits a team that wants a login-based connection with no API token to copy. Ryze AI uses a store-level API account instead and uses one connector URL, https://connector.get-ryze.ai/mcp, that also serves the other platforms in Ryze AI. Both read orders for reporting.
Which BigCommerce dashboard to use
Match the option to what you need to see and how you want to ask for it.
You want a quick chart without leaving the control panel
- Use
- Companion
- Why
- Built in and included with the store
You want a saved layout that refreshes on a schedule
- Use
- Orders V2 API into a sheet or BI tool
- Why
- You control the fields and the refresh
You want a login-based connection to Claude or ChatGPT
- Use
- BigCommerce Store Management MCP
- Why
- OAuth sign-in and per-user scopes, early access
You want order questions in plain language, plus product SEO edits
- Use
- Ryze AI
- Why
- One chat reads orders and, if you allow it, edits product SEO
| Your situation | Use | Why |
|---|---|---|
| You want a quick chart without leaving the control panel | Companion | Built in and included with the store |
| You want a saved layout that refreshes on a schedule | Orders V2 API into a sheet or BI tool | You control the fields and the refresh |
| You want a login-based connection to Claude or ChatGPT | BigCommerce Store Management MCP | OAuth sign-in and per-user scopes, early access |
| You want order questions in plain language, plus product SEO edits | Ryze AI | One chat reads orders and, if you allow it, edits product SEO |
Ryze AI limits for this job: it is paid after the trial, revenue reporting needs the Orders read-only scope, and the tools need an active plan or trial. SEO Starter is $129 a month with a 3-day free trial and covers Content Plan publishing to the BigCommerce blog. For the SEO side, see BigCommerce SEO with Ryze AI.
BigCommerce API limits that shape a dashboard
Two documented limits matter most: the request quota and the page size.
- Quota: apps using OAuth get a quota refreshed every 30 seconds. Growth and Core stores get 20k requests per hour (150 per 30 seconds), and Scale stores get 60k per hour (450 per 30 seconds), per BigCommerce rate limits. Performance plans vary by plan and resource, and an Unlimited Rate Plan has no request rate limits.
- Shared quota: all apps on a store share its quota, so another app can leave your dashboard with fewer requests.
- Page size: a list request with no parameters returns 50 orders; use page and limit for more.
A 429 response means the quota ran out. The X-Rate-Limit-Time-Reset-Ms header says how many milliseconds remain before it refreshes. Ask for a shorter date range or fewer pages.
Sources
The verdict
A BigCommerce dashboard needs 15 order metrics on 5 panels and a weekly review that re-reads the week before. Companion and the Orders V2 API cover it with BigCommerce's own definitions, and the Orders API gives you a saved layout.
Ryze AI reads orders from chat for $89 a month after the 7-day free trial, and revenue reporting needs the optional Orders read-only scope.
Frequently asked questions
What should a BigCommerce dashboard include?
Does BigCommerce have a built-in dashboard?
What is BigCommerce Companion?
Which API gives BigCommerce order data?
Show 7 more questionsShow fewer questions
How do I calculate average order value for a BigCommerce dashboard?
Why are my BigCommerce order amounts text?
Can Ryze AI read BigCommerce orders?
Can Ryze AI change my BigCommerce store?
Does BigCommerce have its own MCP server?
What are the BigCommerce API rate limits?
How much does Ryze AI cost for a BigCommerce dashboard?
Related guides
BigCommerce SEO with Ryze AI
Content Plan publishing, product SEO, pages and redirects on a BigCommerce store.
Best MCP for BigCommerce
BigCommerce MCP servers compared, with the ranking axis stated.
Shopify dashboard
13 Shopify metrics with Admin GraphQL field names and a 5-panel template.
Google Analytics dashboard (GA4)
GA4 metrics with their Data API names and the Ryze AI prompt that reads them.
Google Ads dashboard
14 Google Ads metrics with API field names and a 5-panel template.
All integrations
Every platform Ryze AI connects to.





