> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.claruswms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding Variables to Reports

> How to add custom variables to reports for filtering by date ranges, account IDs, warehouse IDs, and other criteria.

## Overview

Custom variables let you filter reports using specific criteria like date ranges, account IDs, or warehouse IDs. This makes your data analysis more targeted and efficient.

<Steps>
  <Step title="Open your report">
    From the **My Reports** screen, locate the report you want to customise. Scroll right and click the **eye icon** next to the **Run** button to view it.
  </Step>

  <Step title="Add variables">
    Scroll down to the **Variables** section and click **Add** to see the available variable options for that report.
  </Step>

  <Step title="Set variable values">
    After selecting a variable, you can give it a default value so the report uses it automatically each time. You can also toggle the **Prompt** option on or off to decide whether you are asked to enter the value when the report runs.
  </Step>

  <Step title="Save and use">
    Once saved, the variable is applied. If the prompt option is on, you will be asked to enter a value when running the report. Otherwise, the pre-set value is used.
  </Step>
</Steps>

<Warning>The available variable options may differ depending on the report type. For example, a "Receipts Expected" report may offer different choices than a "Goods Out" report.</Warning>

<AccordionGroup>
  <Accordion title="What are custom variables used for?">
    They filter reports by specific criteria -- such as a particular date range, account ID, or warehouse ID -- for more focused analysis.
  </Accordion>

  <Accordion title="Do variable options change for different reports?">
    Yes. The available options vary depending on the report type.
  </Accordion>
</AccordionGroup>