Where are the Steamworks sales reports?

They are in two places. Valve says that a partner can see sales and financial information "in two ways": the Sales & Activations Reports portal, and the monthly sales report. The table lists both, and the reports that hang from them.

You need the right permission. In the Steamworks documentation, the group permission View Financial Info "can view sales and download data for your application and packages", and the partner permission View Financials covers all applications of the partner account.

A note on our method. These reports are behind a partner login, and we did not read them for this guide. Every name of a page, link or term below comes from the public Steamworks documentation. We do not describe the screens.

The Steam sales reports and where Valve says they are.
ReportWhere Valve says it isWhat Valve says it shows
Sales & Activations Reports portalpartner.steampowered.comA near real-time view of revenue, units, player counts, geographic breakdown and other statistics. No deductions.
Monthly Steam Sales Reportpartner.steamgames.com, Financial Information, the Reports tabA more detailed breakdown with deductions, and the actual amount that you will be paid.
Refund DataThe package page in the portal, under LinksRefund numbers, a refund rate, and the reasons that players gave.
WishlistsThe app details page in the portalAdditions, purchases and deletions.
Regional sales reportThe list of links on the reporting page of the gameRegions and countries, with wishlists per region.
IPartnerFinancialsServiceThe Steamworks Web API, with a Financial API keyDaily sales by package, country and platform, and daily wishlist totals.

Sources: Steamworks documentation, Reporting and Payments; Developer Refund Reporting; Wishlist Reporting; Managing Your Steamworks Account.

What do gross revenue, net revenue, units and returns mean?

Gross is before deductions, and net is after them. Valve writes it as one line: the monthly report shows "Gross Revenues less Applicable Adjustments to get to Net Revenue which then is multiplied by the revenue share %".

The table has only terms that Valve defines in public. The first rows are terms of the reports and the payment. The rows in code style are field names of the Web API, which is the only public place where Valve defines units field by field.

Valve does not publish the column headers of the portal or of the monthly report. If a label on your screen is not in this table, do not guess: compare it with the API fields, or ask Valve.

Terms of the Steam sales reports that Valve defines in its public documentation.
TermWhat Valve saysWhere
Gross RevenuesThe ad-hoc sales information on the partner site. It does not deduct returns, chargebacks and taxes. It includes VAT and sales tax, if applicable.Reporting and Payments FAQ; Taxes FAQ
Applicable AdjustmentsTaxes, returns and chargebacks.Taxes FAQ
Net RevenueGross Revenues less Applicable Adjustments.Reporting and Payments FAQ
Revenue share %Net revenue is multiplied by it. The result is the amount to be paid to you, net of applicable withholding taxes.Taxes FAQ
Total Revenue ShareThe amount that Valve pays, as the monthly Steam Sales Report shows it.Reporting and Payments FAQ
US Share (US revenue share)A memo column: the part of your payment that comes from sales made in the US. Valve uses it to calculate withholding tax.Taxes FAQ; Reporting and Payments FAQ
Refund rateThe number of units returned in a period divided by the number of units purchased in that period.Developer Refund Reporting
gross_units_soldThe number of units sold.Web API
gross_units_returnedThe number of units returned.Web API
net_units_soldThe number of units sold less the number of units returned.Web API
gross_sales_usdThe value of sales, in USD to four decimal places.Web API
gross_returns_usdThe value of returns, in USD to four decimal places.Web API
net_tax_usdThe net value of taxes, in USD to four decimal places.Web API
net_sales_usdThe value of sales less the value of returns and taxes, in USD.Web API
gross_units_activatedThe number of units activated. Valve fills it for key rows only.Web API
package_sale_typeThe type of redemption: Steam sale or Retail key.Web API
base_price and sale_priceThe base price and the final sale price, in local currency cents.Web API

Sources: Steamworks documentation, Reporting and Payments FAQ; Taxes FAQ; Developer Refund Reporting; IPartnerFinancialsService Interface.

How do Steam units differ from retail activations?

A Steam unit is a sale in the Steam store. An activation is a key that a player redeemed. The Web API separates them with package_sale_type: "Steam" for a store sale, and "Retail" for a key, which the reference calls a CD-Key row.

The two row types have different fields. A store sale has units, sales, returns and tax. A key row has gross_units_activated, and Valve fills no sales, returns or tax fields for it. Valve also says that key activations do not count for the additional revenue share.

So do not add activations to units sold when you calculate revenue for each unit. For the keys themselves, Valve says that Key Stats shows the total activated and unactivated keys for all packages that include your app.

Valve defines "activations" a second time, in UTM Analytics: a customer who got a license for a free-to-play game, or who redeemed a key.

Sources: Steamworks documentation, IPartnerFinancialsService Interface; Steam Keys; UTM Analytics.

How do refunds, chargebacks and tax show up?

They show up as deductions in the monthly report, and they do not reduce the revenue in the portal. Valve says: "The revenue amounts displayed on the Sales & Activations Reports site do not include any deductions (refunds, chargebacks, taxes, etc)." We corrected one spelling error in that quote.

Refunds have their own report. In the portal, select a package and click Refund Data under Links. Valve says that it has week, month and lifetime views, the refund rate, and the reasons of players by category, with their written notes. The week view "may be quite volatile", and the rate is often higher after a discount. Steam refunds a game on request within two weeks of purchase with less than two hours of play.

In the Web API, a return is a negative number. The example response of Valve has gross_units_sold 10, gross_units_returned -2 and net_units_sold 8. Its money is 311.7201 of sales, -25.5322 of returns and 26.0431 of tax, and a net_sales_usd of 260.1448.

Chargebacks have a name and no public definition. Valve lists them as an Applicable Adjustment, and the Web API reference has no chargeback field. Tax depends on the country. Valve says that VAT is included in the Steam price where Steam collects it, for example 19% in Germany and 10% in Japan, and that US and Canadian sales tax is added on top.

Sources: Steamworks documentation, Reporting and Payments; Developer Refund Reporting; Taxes FAQ; IPartnerFinancialsService Interface. Steam Refunds policy.

How do the daily numbers differ from the monthly report, and when does payment arrive?

The daily numbers are fast and gross. The monthly report is final and net. Valve calls the portal "near real-time" and says that you have "intra-month information at any time". The monthly report shows the deductions and "the actual amount you will be paid".

Past days can change. The Web API reference says that the totals of a date can change "in the normal course of business due to things like late settlement of transactions", and that sales dates are in Pacific Time.

For payment, Valve gives these rules. It pays "by the 30th of the month following sales": sales of February are paid by March 30th. The money can take a few business days more to reach your account. Valve pays in US dollars only, by ACH in the US and by USD SWIFT wire outside the US. It can hold a payment until you have earned at least $100, and you can set a higher threshold.

Valve sends no notice when the monthly report is ready. It says that the report is published by the time you get the payment. Valve does not publish the day of the month on which the report appears.

Daily numbers and the monthly report, as Valve describes them.
Sales & Activations Reports portalMonthly Steam Sales Report
SpeedNear real timeOnce a month
RevenueGross Revenues, with no deductionsGross Revenues less Applicable Adjustments, then the revenue share
UseTrends, launches, discounts, regionsThe amount of the payment, and your accounts
Can change laterYes: late settlement can change a past dayValve does not say

Sources: Steamworks documentation, Reporting and Payments; Reporting and Payments FAQ; IPartnerFinancialsService Interface.

How do I read the region and country views?

Start with the region, then open the countries. Valve says that the financial site groups countries in 12 regions: Africa, Asia, Eastern Europe, Latin America, Middle East, North America, Oceania, Other, Central Asia, South Asia, South East Asia and Western Europe. The Reporting and Payments page lists the countries of each region.

Some groups can surprise you. In that list, Turkey is in Middle East, Russia and Ukraine are in Central Asia, and Greece is in Eastern Europe. The names in the Web API can also differ: the example response of Valve puts the United Arab Emirates in a region named "Middle East & North Africa". So store the country code and make your own groups.

The regional sales report also has wishlists. Valve says that you can click the plus symbol next to a region to see more details, with the number of wishlists from customers in that region. For money per country, Valve points to a link named "Steam Sales by Country" at the bottom of the monthly report.

Read countries in units first. Prices differ by currency, so a country with many units can have a small share of revenue.

Sources: Steamworks documentation, Reporting and Payments; Wishlist Reporting; Taxes FAQ; IPartnerFinancialsService Interface.

What do wishlist additions, deletions, purchases and activations mean?

Additions, deletions and purchases are the three actions that the Wishlists section tracks. Valve says that it "tracks additions, purchases, and deletions by users that have your game on their wishlist". The data is updated daily for the previous date. The Web API adds a fourth count, gifts, and counts of additions by platform.

Activations are not in that list. We found no wishlist activation count in the public documentation. The Steam Keys page does say that when a player with your game on their wishlist activates a key, "it will remove your game from their wishlist". Valve does not say in public under which wishlist number that removal is counted.

The wishlist CSV has two columns that Valve defines: DateLocal, the date in Pacific time of a purchase from the wishlist, and MonthCohort, the month in which the user added the game. Our wishlist guides cover the rest.

Sources: Steamworks documentation, Wishlists; Wishlist Reporting; Steam Keys; IPartnerFinancialsService Interface.

How do I get from gross revenue to the money that reaches my bank?

Take off the adjustments, apply your revenue share, then take off withholding tax and bank fees. The steps below follow the Valve text. This is a general description and not tax advice. Your Steam Distribution Agreement and your tax interview decide your numbers, so check them.

The public pages do not give the base revenue share. It is in your agreement. Valve did announce two higher tiers in 2018: 75%/25% on earnings of a game beyond $10 million, and 80%/20% beyond $50 million, for revenue from October 1, 2018. Our fee calculator shows each deduction for numbers that you enter, with an optional publisher share.

  1. Start with Gross Revenues. Valve says that they include VAT and sales tax, if applicable.
  2. Take off the Applicable Adjustments: taxes, returns and chargebacks. The result is Net Revenue.
  3. Multiply Net Revenue by the revenue share % of your agreement.
  4. Take off US withholding tax, if it applies to you. Valve says that the rate "may range from 0% to 30%" on US source income, and that it comes from your tax interview.
  5. The result is the Total Revenue Share of the monthly report. Valve pays this amount in US dollars.
  6. Your bank can take a fee. Valve says that it passes no wire fees to you, but that it cannot control the fees of intermediary banks or of your bank.
  7. Take off what is yours to pay: a publisher share, and your own taxes. Ask a tax adviser about those.

Sources: Steamworks documentation, Taxes FAQ; Reporting and Payments FAQ. Valve, New Revenue Share Tiers (30 November 2018).

How do I export the data as CSV or with the Financial API key?

Use the CSV links for a one-time look, and the Web API for a daily job. Valve names three downloads. The home page of the partner reporting site has a link "view as .csv" beside the date selection. The monthly report has a link "Steam Sales by Country" at the bottom, to download into Excel. The wishlist report has its own CSV.

The Web API needs a special key. Valve says that IPartnerFinancialsService needs a Financial API Group with its own key, and that the key reads all data of all applications of the partner account. Keep it like a password. Valve recommends a list of allowed IP addresses.

  1. In Steamworks, open Users & Permissions, then Manage Groups, and create a Financial API Group. The key shows on the page of the group.
  2. Add your server addresses under Manage WebAPI Key, as Valve recommends.
  3. Call GetChangedDatesForPartner with a highwatermark of 0. It returns each date with sales or activations.
  4. For each date, call GetDetailedSales with a highwatermark_id of 0. Call it again with the max_id of the response, until max_id is equal to the value that you sent.
  5. Store the rows. Valve marks the fields that make a unique key, such as date, packageid, country_code and platform.
  6. The next day, call GetChangedDatesForPartner with the result_highwatermark that you saved. When a date comes back again, delete your rows of that date and read the date again.

Sources: Steamworks documentation, Reporting and Payments FAQ; IPartnerFinancialsService Interface; Authentication using Web API Keys.

What does Manalens read from Steam today?

Two things. The Steam UTM Analytics CSV import works today: you upload the file from Steamworks. The automatic Steam sync is in early access: with a Financial API key that you connect, it reads daily totals of sales and wishlists. It does not read the monthly report, and it does not know your payout. The table gives each item as our documentation gives it.

Early access means that the sync is new. Compare its totals with your portal before you rely on them.

Net sales from Steam show in the Revenue metric of the Overview, as the source "steam". That number is sales less returns and taxes. It is before the revenue share of Valve, so it is not the money that you receive.

Steam data in Manalens, from our own documentation.
Steam dataIn ManalensNotes
Units sold and returned, per day and countryEarly accessOptional daily sync. Sales days are Pacific Time.
Gross and net sales in USD, per day and countryEarly accessNet is before the revenue share.
Wishlist adds, deletes, purchases and gifts, per day and countryEarly accessWishlist days are GMT.
UTM Analytics visits, wishlists and purchasesYesYou upload the CSV from Steamworks.
History at the first syncEarly access: the last 90 daysThen one sync each day.
Monthly Steam Sales Report and the payoutNoRead it in Steamworks.
Refund reasonsNoRead Refund Data in the portal.
ChargebacksNoThe Web API reference has no field for them.
Retail key activationsNot yetOur Steam documentation lists no report for them.
One record for each buyerNoSteam gives totals only.

Sources: Manalens Steam documentation and revenue documentation.

What is a weekly routine to read the reports?

Read the same numbers on the same day each week, and judge the week before, not today. Refunds can arrive for two weeks, and a past day can change with late settlement. The steps take about 20 minutes, which is our own estimate.

  1. Open the portal and note the units and the gross revenue of the last full week.
  2. Compare the week with the week before, and write down what happened: a discount, an update, a video, a festival.
  3. Open Refund Data in the month view, and read the reasons. Use the week view only as a signal.
  4. Open the regional sales report and note the five countries with the most units. Look for a new one.
  5. Open the Wishlists section: additions, deletions and purchases up to the day before.
  6. Open UTM Analytics and the traffic breakdown to see which sources sent the visits.
  7. Once a month, read the monthly Steam Sales Report: the adjustments, the Net Revenue, the US Share and the Total Revenue Share. Compare the total with the payment in your bank.

Sources: Steamworks documentation, Developer Refund Reporting; Wishlists; IPartnerFinancialsService Interface. Steam Refunds policy.

How do I see Steam sales next to my other game data?

Manalens is the analytics and growth engine built for games. Connect a Steamworks Financial API key (the automatic Steam sync is in early access), and the daily sync brings units, returns, gross and net sales and wishlists per day and country into the Steam view, next to your website, campaign and game events. Check the first totals against your portal. The monthly report and the payout stay in Steamworks.

Sources: Manalens Steam and revenue documentation.

Frequently asked questions

Why does the Steamworks portal show more revenue than Valve paid me?

Because the portal shows Gross Revenues. Valve says that those numbers do not deduct returns, chargebacks and taxes. The monthly Steam Sales Report takes those adjustments off to get Net Revenue, multiplies it by your revenue share, and takes off withholding tax where it applies. Your bank can also charge a fee for the wire.

When does Steam pay developers?

Valve says that it pays by the 30th of the month that follows the sales. Sales of February are paid by March 30th, and the money can take a few business days more to show in your account. Valve pays once a month, in US dollars, and makes no payments outside that cycle.

Is there a minimum payout on Steam?

Yes. Valve says that it may hold your payment until you have earned a minimum of $100. You can also set a higher threshold under Holding Payment in your company information, which helps when wire fees take a large part of a small payment. Only a user with Actual Authority can change it.

What is US Share on the monthly Steam report?

It is a memo column. Valve says that it is the part of your payment that comes from sales made in the US. Valve multiplies it by your withholding tax rate, if you have one, and uses it for the yearly US tax forms. Ask a tax adviser what it means for your own taxes.

Do Steam sales numbers change after the day is over?

Yes, they can. The Web API reference of Valve says that the totals of a date can change in the normal course of business, for example with late settlement of transactions, and that the same date then comes back in GetChangedDatesForPartner. Refunds also arrive later. So read last week, and read last month again.

Can I share my Steam sales numbers in public?

Valve said so in 2018. Its announcement of 30 November 2018 says that the confidentiality terms of the Steam Distribution Agreement were updated "to make it clear that the partner can share sales data about their game as they see fit". Read your own agreement, and a publisher contract if you have one, before you publish numbers.

Sources and implementation