Ira Bodnar··Updated ·13 min read

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

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

BigCommerce dashboard at a glance

5 panels, read top to bottom once a week.

  1. 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?

  2. 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?

  3. 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?

  4. 4Items and fulfillmentLast full week

    Metrics: Items per order, items shipped

    Question it answers: How much is waiting to ship?

  5. 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?

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.

  1. 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
  2. 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
  3. Subtotal

    Plain definition
    Order subtotal, tax included
    API field
    subtotal_inc_tax
    How to read it
    Base for a discount rate
  4. Discounts

    Plain definition
    Discount amount on the order
    API field
    discount_amount
    How to read it
    Divide by subtotal for a discount rate
  5. Shipping

    Plain definition
    Shipping charged, tax included
    API field
    shipping_cost_inc_tax
    How to read it
    Watch it against the order total
  6. 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
  7. Refunded amount

    Plain definition
    Amount refunded from the order
    API field
    refunded_amount
    How to read it
    Sum it for the period
  8. 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
  9. 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
  10. Items ordered

    Plain definition
    Number of items on the order
    API field
    items_total
    How to read it
    Sum for items per order
  11. 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
  12. 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
  13. 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
  14. Payment method

    Plain definition
    Display name of the payment method
    API field
    payment_method
    How to read it
    Group by name
  15. 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

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. 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. 2. Order value

    Tiles or chart
    Average order value, discounts, shipping, tax
    Date range
    Last full week
    Compare with
    The week before
  3. 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. 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. 5. Channels and payment

    Tiles or chart
    Orders by channel_id, order_source and payment_method
    Date range
    Last 30 days
    Compare with
    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.

REST: panels 1 to 5, orders created last week
curl "https://api.bigcommerce.com/stores/$STORE_HASH/v2/orders?min_date_created=2026-11-09T00:00:00.000-05:00&max_date_created=2026-11-15T23:59:59.000-05:00&sort=date_created:desc&limit=50&page=1" \ -H "X-Auth-Token: $ACCESS_TOKEN" \ -H "Accept: application/json"
REST: panels 1 and 3, order count by status
curl "https://api.bigcommerce.com/stores/$STORE_HASH/v2/orders/count?min_date_created=2026-11-09T00:00:00.000-05:00&max_date_created=2026-11-15T23:59:59.000-05:00" \ -H "X-Auth-Token: $ACCESS_TOKEN" \ -H "Accept: application/json"
REST: status names for panel 3 and 4
curl "https://api.bigcommerce.com/stores/$STORE_HASH/v2/order_statuses" \ -H "X-Auth-Token: $ACCESS_TOKEN" \ -H "Accept: application/json"

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).

Prompt: Ryze AI chat or Claude with the Ryze AI connector
Use my BigCommerce store. Read only: change nothing. Build a weekly dashboard as 5 tables, last full week (Monday to Sunday) vs the week before, in the store's default currency: 1. Sales and orders: order count and the sum of total_inc_tax, plus a daily line for the last 30 days. 2. Order value: average order value (sum of total_inc_tax / order count), discount_amount, shipping_cost_inc_tax and total_tax. 3. Refunds and status: sum of refunded_amount, refund rate (refunded_amount / total_inc_tax) and order count by status. 4. Items and fulfillment: items_total, items_shipped and the number of orders in Awaiting Fulfillment. 5. Channels and payment: order count by channel_id, order_source and payment_method for the last 30 days. Leave Incomplete, Pending, Cancelled and Declined orders out of the sales totals and tell me how many you left out. List the fields you used.

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. 1. Refresh

    Check
    Re-run the pull or the prompt before reading
    Panel
    All
    Act when
    The numbers predate the latest order
  2. 2. Sales

    Check
    Order total and count against the week before
    Panel
    1
    Act when
    Order count fell while the order total held
  3. 3. Value

    Check
    Average order value, discounts, shipping
    Panel
    2
    Act when
    Discounts rose faster than orders
  4. 4. Refunds

    Check
    Refunded amount and orders in Refunded or Partially Refunded
    Panel
    3
    Act when
    Refunds cluster in one status or day
  5. 5. Fulfillment

    Check
    Items shipped against items ordered
    Panel
    4
    Act when
    Orders in Awaiting Fulfillment keep piling up
  6. 6. Channels

    Check
    Orders by channel and payment method
    Panel
    5
    Act when
    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.

  1. 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
  2. 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
  3. Where it runs

    Companion
    BigCommerce control panel
    Orders V2 API
    Your script or BI tool
    Ryze AI
    Ryze AI chat, Claude or ChatGPT
  4. Saved layout

    Companion
    Charts on request
    Orders V2 API
    Yes, if you build one
    Ryze AI
    No, a table per request
  5. 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
  6. 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
  7. Several stores

    Companion
    One control panel at a time
    Orders V2 API
    One token per store
    Ryze AI
    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.

  1. You want a quick chart without leaving the control panel

    Use
    Companion
    Why
    Built in and included with the store
  2. 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
  3. 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
  4. 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

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?
15 order metrics on 5 panels: sales and orders, order value, refunds and status, items and fulfillment, and channels and payment. The core metrics are order count, total_inc_tax, average order value, discount_amount, refunded_amount and order status. Compare the last full week with the week before.
Does BigCommerce have a built-in dashboard?
BigCommerce has analytics in its control panel, and Companion, its AI assistant, shows store analytics as on-demand charts with period-over-period comparisons. We could not open the help center's report pages on the build day, so check the current report list there.
What is BigCommerce Companion?
Companion is an AI assistant built into the BigCommerce control panel. BigCommerce says it answers how-to questions, shows data as charts, navigates the admin and updates order statuses after you approve a preview. It is included with a store.
Which API gives BigCommerce order data?
The Orders V2 REST API. List Orders returns fields such as total_inc_tax, refunded_amount, status_id and date_created, and Get Count of Orders returns a count by status. Both need the Orders read-only scope, store_v2_orders_read_only.
Show 7 more questions
How do I calculate average order value for a BigCommerce dashboard?
Divide the sum of total_inc_tax for the period by the order count. It is not a stored field. Decide first whether Incomplete, Pending, Cancelled and Declined orders count, and keep one currency for the whole dashboard.
Why are my BigCommerce order amounts text?
The Orders V2 API returns money values as strings, such as Float-As-String. Convert them to numbers before you sum them in a script or sheet.
Can Ryze AI read BigCommerce orders?
Yes, with the Orders read-only scope on the API account. That scope is optional in the documented setup, and without it revenue reporting is unavailable. Customer data is not covered, because the help page lists no Customers scope.
Can Ryze AI change my BigCommerce store?
Yes. It can edit product and category SEO fields, create and update web pages and 301 redirects, and publish blog posts, and delete is a separate tool. In Ryze AI chat, Tool approvals starts on Skip all approvals, so switch it to Approve write & delete first. For a dashboard, add read only to the prompt.
Does BigCommerce have its own MCP server?
Yes. The Store Management MCP at https://api.bigcommerce.com/mcp is listed as early access with 16 tools. The store owner enables it and grants scopes per user, and sign-in uses OAuth 2.1. Its get_orders tool returns order summaries without shopper contact details.
What are the BigCommerce API rate limits?
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. All apps on a store share its quota, and a 429 response means it ran out.
How much does Ryze AI cost for a BigCommerce dashboard?
The Paid Ads plan is $89 a month with a 7-day free trial and gives access to the agent tools. SEO Starter is $129 a month with a 3-day free trial and includes Content Plan publishing to a BigCommerce blog. Agency is $279 a month. Annual billing is 30% off the first year, and adding the connector is free.

Related guides

Ryze AI: BigCommerce order questions

7-day free trial, $89 a month flat

Start free trial