Pitch Workspace – Usage

​

Purpose

The Usage page inside the Pitch Workspace tells customers, at a glance, how much of their Pitch Reports quota they have consumed in the current billing period and how much they have left. Pitch Reports are an add-on / agency-plan capability in Athena, and each report counts against an allowance that lives on the organization’s subscription. Without this page customers would have no obvious way to answer “how many more pitches can I run this month?” before they kick off a new one. The page sits inside the Pitch Workspace area of the app. Customers typically land here from the left sidebar after they have already been using the Pitch Workspace and want to check their remaining capacity, or after a teammate asks whether the org can afford to spin up another pitch. It is intentionally simple: it has no filters, no tables, no drilldowns. It is a status / accounting page, not a working surface. It also serves as a quick reminder of the per-pitch limits (competitors and custom prompts) so customers can plan a pitch before they create one. Because Pitch Workspace access is scoped to the organization (not to a single website), the quota shown here reflects the organization’s overall pitch entitlement: even in multi-website organizations where the entitlement technically lives on one specific “entitled” website inside the org.

​

What’s on the page

​

Page header

A simple page header at the top reading “Usage”. There are no action buttons, breadcrumbs, or filters in the header: this page is read-only.

​

Pitch usage details card (left, larger card)

This is the main card on the page and is labeled Pitch Reports. It has several possible states depending on the organization’s plan and current load state:

• Limited-plan view (most common). Shows a horizontal progress bar with two labels underneath:
  • Left label: “N used”: the number of pitch reports the organization has consumed in the current period.
  • Right label: “N left”: the number of pitch reports the organization still has available.
  • The bar color changes as usage climbs:
    • Indigo when usage is below 33% of the allowance.
    • Purple when usage is between 33% and 66%.
    • Orange when usage is at 66% or above (visual warning that the org is approaching its cap).
• Unlimited-plan view. If the organization is on a plan with unlimited pitches, the bar is replaced by:
  • The word “Unlimited” in large text.
  • A subtitle showing the number of pitches the organization has already created (e.g. “3 pitches created” or “1 pitch created”).
  • A small “No limits” label on the right.
• Loading view. Skeleton placeholder bars appear in place of the label, progress bar, and “used / left” counters while data is being fetched.
• Error view. If either the access check or the quota fetch fails, the entire card body is replaced with the message “Couldn’t verify pitch quota: please refresh.” in amber text.
• No-access view. If the organization does not have Pitch Workspace access at all, the card body is replaced with the message “Pitch workspace access is not available for your organization.”

​

About Pitch Reports info card (right, smaller card)

A static reference card titled About Pitch Reports. It lists the per-pitch limits that apply regardless of plan:

• Analyze up to 10 competitors per pitch.
• Include up to 10 custom prompts.

This card always shows the same content: it does not vary by plan or by usage level.

​

What you can do here

This page is intentionally read-only. There are no buttons, dropdowns, kebab menus, filters, bulk actions, CSV export, or row-level controls. The only “action” available is reading the current quota state. If the card lands in the error state, the suggested user action is to refresh the page so that the quota check and feature access check are retried. To actually create a pitch, change a subscription, or buy more pitch capacity, the customer needs to leave this page and go elsewhere in the product (e.g. the main Pitch Workspace page to create a pitch, or Settings → Billing to manage their subscription).

​

Data shown

The numbers on this page reflect the customer’s organization-wide Pitch Reports quota:

• “Used” is the number of pitch reports already consumed against the organization’s allowance in the current billing period.
• “Left” is the remaining allowance for that period.
• “Unlimited” + pitches created counts every pitch the active organization has ever created (as returned by the pitches list for the org).
• The About Pitch Reports card is static reference copy: it does not come from any live data source.

Quota is sourced at the organization level rather than the active website level. In organizations with multiple websites, the pitch entitlement may technically live on one specific “entitled” website inside the organization; the page transparently looks up the right website and reports the correct org-wide numbers, so customers do not need to know which website carries the entitlement.

​

Common workflows

1. Check how many pitches I have left this period

1. Open the left sidebar and navigate into Pitch Workspace → Usage.
2. Look at the Pitch Reports card.
3. The right-hand label under the progress bar shows pitches remaining. The bar color also gives a quick read on how close the org is to its cap.

2. Confirm we are on an unlimited plan

1. Navigate to Pitch Workspace → Usage.
2. If the card shows Unlimited and No limits instead of a progress bar, the organization is on an unlimited plan. The subtitle shows how many pitches have been created so far.

3. Recover from an error state

1. If the card reads “Couldn’t verify pitch quota: please refresh.”, refresh the browser tab.
2. If the message persists, the entitlement service may be temporarily unreachable; try again in a moment.

4. Find out why a teammate sees “Pitch workspace access is not available for your organization.”

1. Confirm the user is on an organization whose plan includes Pitch Workspace.
2. Confirm they are in the correct active organization (multi-org users may have switched into one without Pitch access).
3. If their plan should include Pitch Workspace, refresh and retry; if the message still shows, escalate to billing/support.

​

Empty, loading, and error states

• Loading: Skeleton placeholder rectangles render in place of the label, the progress bar, and the “used / left” counters until both the feature-access check and the quota fetch return.
• No data / no access: If the organization does not have Pitch Workspace access at all, the card body reads “Pitch workspace access is not available for your organization.” There is no upsell button on this particular card: customers who want to upgrade go through their normal billing flow.
• Error: If either the feature-access lookup or the quota fetch fails, the card body reads “Couldn’t verify pitch quota: please refresh.” in amber. Refreshing the page is the recommended recovery.
• “Pitches created” on unlimited plans uses singular vs. plural copy correctly (“1 pitch created” vs. “3 pitches created”).

​

Linked from / links to

• Linked from: The Pitch Workspace area of the app: typically via the left sidebar’s Pitch Workspace section, or from any other Pitch Workspace sub-page. The page is gated behind the same Pitch Workspace access check as the rest of the workspace, so customers without that entitlement will see a locked screen at the workspace level before they ever reach Usage.
• Links to: Nothing. This page has no outbound buttons or links. To act on what the numbers say, customers navigate back into the rest of the Pitch Workspace (to run a new pitch) or into Settings → Billing (to manage their plan).

​

Common support questions

Q: What does “N used / N left” mean exactly? A: “Used” is the number of pitch reports your organization has already consumed against its current allowance. “Left” is how many more you can still create before hitting the cap. Q: Why is the bar orange? A: The bar turns orange once you have consumed 66% or more of your pitch allowance. It is purple between 33% and 66%, and indigo below 33%. It is purely a visual warning: nothing has been disabled. Q: It says “Unlimited”: do pitches still count against anything? A: No. On an unlimited plan there is no cap on pitch reports. The number shown underneath (“3 pitches created”) is just a historical count of pitches the organization has created. Q: One of my teammates sees “Pitch workspace access is not available for your organization” but I don’t. Why? A: Pitch Workspace access is granted at the organization level. If your teammate is signed into a different organization (or has been moved off the org with the entitlement), they won’t see Pitch Workspace. Have them switch to the correct organization or check their plan. Q: I just used a pitch but the counter hasn’t updated. What do I do? A: Refresh the page. The quota and access data are cached briefly, so a hard refresh is the fastest way to see the latest numbers. Q: The card says “Couldn’t verify pitch quota: please refresh.” What’s wrong? A: The entitlement / quota service didn’t respond. This is almost always transient: refresh once or twice. If it keeps happening, contact support. Q: How many competitors and prompts can a single pitch include? A: Up to 10 competitors and up to 10 custom prompts per pitch. This is listed on the About Pitch Reports card on the page. Q: Can I export my usage history from this page? A: No. This page only shows current-period usage. There is no export, download, or historical breakdown surfaced here.