> For the complete documentation index, see [llms.txt](https://docs.revelator.com/pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.revelator.com/pro/platform/royalties/royalty-runs/create-royalty-run.md).

# Creating Royalty Runs

## Overview

Creating a new royalty run in Revelator Pro allows users to allocate revenue across royalty statements for their payees. This feature is essential for ensuring accurate and comprehensive revenue distribution based on detailed statements and data from digital service providers (DSPs).

You may create a royalty run if errors were corrected or adjustments made to previous accounting periods. If a payment error occurred in a previous accounting period but has not been corrected, creating a new royalty run will not be helpful until the issue is resolved.

***

## Prerequisites

{% hint style="info" %}
Before creating a new royalty run, please ensure the following conditions are met:
{% endhint %}

1. Your account has "editor" permissions for **Royalty Accounting**.
2. **Verify any errors** from previous accounting periods have been corrected. Creating a new royalty run without addressing these errors may lead to inaccurate revenue allocation.
3. At least **one pre-existing revenue report must be available** to include in the royalty run.
4. Make sure that all reports you intend to include have been **approved** or are **ready for approval**.
5. If your revenue involves foreign currencies, ensure that the necessary **FX rates are prepared** or manually inputted where required.

***

## How To: Create a Royalty Run

{% stepper %}
{% step %}

### **Initiate a New Royalty Run**

Open **Royalties -> Royalty Runs**, and click **Create New.** This will open a new page to create your royalty run.
{% endstep %}

{% step %}

### **Enter Royalty Run Details**

Fill in the following details:

* **Statement Month** by selecting the year and month you wish to include revenue reports from.
* Enter a **Statement Name** (e.g., "2025 March Royalties").
* Add **Royalty Run Notes** for your own internal reference (if applicable).
* Toggle **Additional FX Rates** to input custom currency exchange rates (e.g., USD to AUD, BRL, CAD, EUR, GBP, HUF, ILS, etc.).
  {% endstep %}

{% step %}

### **Select Unprocessed Revenue Reports**

View the list of **Unprocessed Revenue Reports**, and use tabs to filter reports by status:

* **Approved**
* **To Approve**
* **Unmatched**, and 
* **Need FX**. 

Select reports to include in the run by checking the box next to each report. If necessary, resolve any **Unmatched** or **Need FX** issues before proceeding.
{% endstep %}

{% step %}

### **Select Processed Revenue Reports (optional)**

If you need to include previously processed revenue reports, choose the **Select Date Range** to view past processed reports. Select the desired reports for inclusion.
{% endstep %}

{% step %}

### **Review & Submit The Royalty Run**

Click **Preview** to review the summary of the royalty run. A modal window will open a summary, that displays the number of reports included and not included in the run. Click **Create Run** to submit the royalty run for processing.

{% hint style="warning" %}
Depending on the number of reports included, processing the run may take some time to complete. 
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Expected Outcomes

#### Royalty Run Status

#### Payee Statements Are Generated

When you royalty run has completed, a number of payee statements will be generated for you to approve and send payment to payees. Please read our article on [Approving Statements](/pro/platform/royalties/statements/approving-statements.md).

***

## Frequently Asked Questions

<details>

<summary>Why can’t I create a royalty run?</summary>

Ensure that all required fields (statement month and name) are filled in and that any unprocessed revenue issues (like FX rate requirements) are resolved.

</details>

<details>

<summary>How do I set custom FX rates?</summary>

Toggle the **Additional FX Rates** switch and enter the desired exchange rate for each currency.

</details>

<details>

<summary>What if some reports are not processed due to FX issues?</summary>

Go to the **Need FX** tab and add the required exchange rate before proceeding.

</details>

***

## Additional Resources

* Learn about [Payee Statements](/pro/platform/royalties/statements.md)
* [Approving Statements](/pro/platform/royalties/statements/approving-statements.md)
* [Fixing Unaalocated Revenue](/pro/platform/royalties/royalty-runs/fixing-unallocated-revenue.md)

***

## Next Steps & Future Releases

* Automated FX rate updates from trusted sources.
* Enhanced filtering for unprocessed reports.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.revelator.com/pro/platform/royalties/royalty-runs/create-royalty-run.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.