Summary
The "Revenue Setup" Tool is the place in Planhat OS where you - as a Planhat Admin - configure revenue settings for your tenant
Settings within "Revenue Setup" determine how revenue is counted and shown: ARR or MRR, fiscal year, renewal rules, currencies and FX rates
It's also where you can access your Product Catalog, which is where you set up and manage your Products
"Revenue Setup" is its own Tool in Planhat OS, separate from the general "Settings" Tool. You can find it in the main Tools menu
Who is this article for?
Planhat Admins who configure revenue for their organization (e.g. Revenue Operations or Finance)
Anyone moving from pre-OS Planhat who is looking for Settings --> Revenue
Related articles
Other articles particularly relevant to this article are:
Article contents
Introduction
Revenue numbers are only useful when it's clear what they are referring to. If you're a Revenue Operations Lead at a company that sells in USD, EUR and GBP, reports in ARR, and starts its fiscal year in April, you need Planhat to align with this, otherwise reports could be confusing, and totals could mix three currencies. "Revenue Setup" is where you (as a Planhat Admin) configure revenue settings in Planhat OS, to tailor your Planhat tenant to suit your organization.
📌 Important to note - Planhat versions
In pre-OS Planhat, revenue settings were located within the "Settings" Global Tool; but in Planhat OS, the revenue settings have been split out into their own Tool, rather than being found in the general "Settings" Tool.
What is the "Revenue Setup" Tool?
"Revenue Setup" is a Tool that you (as a Planhat Admin) can find in the "System Configuration" part of the main Tools menu in Planhat OS.
Click the image to view it enlarged
Once you've clicked into the "Revenue Setup" Tool, you'll see it has the following parts, from top to bottom:
Key revenue settings - "Do you think in terms of ARR or MRR?", "Revenue Source of Truth", "Fiscal year starts" and "Fiscal year is named after"
"License Revenue Source of Truth" - when an integration sends both recurring revenue and total value, this sets the priority. It also determines which to keep when start or end dates change
"Fiscal year starts" - the first month of your fiscal year. The default is January
"Fiscal year is named after" - options are "The year it starts" or "The year it ends"
General settings - "Customer Size Definition", "Revenue Number Format", invoicing details, and default payment and notice periods
"Customer Size Definition" - "Recurring Revenue Only" or "Monthly Revenue (mrr + nrr last 30 days)"
"Revenue Number Format" - how revenue numbers are shown (e.g. 1000 v. 1,000 v. 1k)
"Invoicing E-mail" and "VAT No." - your organization's invoicing details
"Default Payment Term" - the number of days between invoice date and due date
"Default Notice Period" - the number of days in the notice period
Renewal and forecast settings - toggle switches such as "Automatically Renew Licenses" and "Show Optimistic Forecast"
Some of these have detailed descriptions in the app (as shown in the screenshot above), explaining what they do. Note that you may see "Line Items" (as shown above) or "License", depending on whether your tenant is using the newer revenue data models or the legacy ones
"Set "Customer Since" Field Manually" - lets you edit "Customer Since" yourself
"Show Optimistic Forecast" and "Show Pessimistic Forecast" - adds these forecast values
Additional Line Item settings - "Inherit line item custom fields" and "Adjust line item dates based on deal updates?" toggle switches. (Note that these settings are only shown here if you are using the newer revenue data models - Line Items and Deals)
"Product Catalog": clicking on the "Open Products" button opens your Product Catalog (Products list), where you can view/add/manage your Products (e.g. see later)
"Currency & FX" - the currencies you use, your base currency (see Definitions box below), and FX rates
"Migration to new Revenue models" - for tenants moving from the legacy revenue models (Licenses and Sales etc.) to the newer ones (Deals and Line Items etc.). Speak with your Planhat contacts (e.g. your Deployment Strategist) if you need more help with this
📌 Definitions
Each Line Item represents either a "Subscription" (recurring revenue) or a "Fee" (non-recurring revenue)
Each Line Item belongs to a Deal, and each Deal belongs to a Company. This means that each Line Item will be something like "Advanced Data on Renewal Deal with Zoom"
Each Product acts as a template for a Line Item. Each Product just describes the Subscription/Fee itself - it's not connected to a specific Deal/Company. When you're adding Line Items to a Deal, you can save time by selecting an existing Product - although it's not mandatory to use Products
"Base currency" is the currency every other currency is converted into
📌 Important to note
You need the "Admin Access" workflow permission in your Role to be able to see/access the "Revenue Setup" Tool
The "Revenue Setup" Tool should not be confused with the "Revenue" standard Featured Page on a Company Profile, or the Revenue System Report Pages. The settings you configure in the "Revenue Setup" Tool feed into those charts/reports
Why use the "Revenue Setup" Tool?
You can customize your Planhat tenant in many ways to make it suit you and your business perfectly, and the settings in the "Revenue Setup" Tool are one way you can achieve this.
For example, you can ensure that your revenue in Planhat uses the correct choice of ARR v. MRR, has the correct fiscal year, and uses the correct base currency for you.
The Product Catalog (see below), accessed via the "Revenue Setup" Tool, houses your Products. Here you can view, add, edit or delete Products. Each Product acts as a template for a Line Item - when you're adding Line Items to a Deal, you can save time by selecting an existing Product, rather than entering all the details manually.
How to use the "Revenue Setup" Tool - examples
Of course, you can configure many settings here, as we described above. We are not going to list all of these here; instead, we will go through some example key points.
How to open the "Revenue Setup" Tool
In your Planhat OS sidebar, click on "More" to open the main Tools menu (as shown in the screenshot below)
Scroll down to the "System Configuration" category
Click "Revenue Setup"
Click the image to view it enlarged
🚀 Tip
If you will frequently be configuring settings within the "Revenue Setup" Tool, you can pin it to your sidebar, so you don't need to go via the main Tools menu. To do this, click on the pin icon to the right of the "Revenue Setup" name (which you can see in the screenshot above).
How to add a Product to the Product Catalog
Scroll to the "Product Catalog" part of the "Revenue Setup" Tool
Click "Open Products" (underlined in the screenshot above)
Click "+ Add product"
Fill in the Product details in the modal, and click "Create Product". For example: Name
Fleet Analytics add-on, TypeSubscription, ARR12,000, CurrencyUSD. For a one-off charge such as "Implementation", you'd choose TypeFeeinstead
📌 Important to note
If your tenant uses the legacy revenue models, the Products screen instead shows two lists: "Recurring products" and "Non-recurring products". Click "Add recurring product" or "Add non-recurring product", then enter the Product details.
📚 Further reading
To read all about the Product data model as part of the newer revenue model structure, check out our separate article here.
How to add a currency
Scroll to the "Currency & FX" part of the "Revenue Setup" Tool
Click "Add currency"
Select your chosen currency from the dropdown menu, e.g.
EUR.
How to change your base currency
In the "Currency & FX" table, mouse over the currency you want to be your base, e.g.
USDClick the checkbox icon (tooltip: "Set as base")
Click "Confirm". All other currencies are rebased on the new base currency
🚀 Tips
To use a different FX rate for each month, turn on the "Use historical FX rates" toggle switch
You can drag currency rows to reorder them
Frequently asked questions (FAQs)
Q: Where are the revenue settings in Planhat OS?
A: In the "Revenue Setup" Tool, which you can find in the "System Configuration" category of the Tools menu
Q: Why can't I find revenue settings in the "Settings" Tool in Planhat OS?
A: In Planhat OS, revenue settings have been separated out of the main "Settings" Tool and now have their own Tool: "Revenue Setup"
Q: Where do I manage Products in Planhat OS?
A: Open the "Revenue Setup" Tool, scroll down to "Product Catalog", and click "Open Products"
Q: How do I turn on the new revenue models (Deals and Line Items)?
A: In "Revenue Setup", under the "Migration to new Revenue models" heading, turn on "Enable the new revenue models". Speak with your Planhat contacts (e.g. your Deployment Strategist) if you need more help
Q: Why can't I see the "Revenue Setup" Tool in the Tools menu?
A: Only Admins can see and open it. By "Admins" in this context we mean Planhat users who have the "Admin Access" workflow permission in their Role