Documentation/Using the platform

Reports & sheets

Every table and chart in Revolution RE starts as a report. Build one from a template or from scratch, then email it, schedule it, or put it on a dashboard.

All documentation pages

Reports are the core of the platform. Every table and chart you see — including the templated dashboards on your homepage — is produced by a report. Build a report once and it can be downloaded, emailed on a schedule, placed on a dashboard, or embedded somewhere else.

Viewing only

As a Viewer you can open, download, print and favorite the reports your team has published. Creating and editing reports needs an Editor or Administrator.

Finding a report

Open Reports from the top navigation. There are two lists:

  • Library — ready-made report templates. A good starting point, and the best way to learn how reports are built.
  • My Reports — your company's own reports, whoever created them.

Search by name or keyword, select a category to filter, or sort by any column header: name, modified by, created on, updated on, category. Select a report's name to open it.

Creating a report

Start from a template

  1. In Library or My Reports, open the three-dot menu beside a report.
  2. Select Copy and give the copy a new name. It appears in My Reports, ready to edit.

Start from scratch

  1. Select + New report at the top right of either list.
  2. Complete Settings first (below).
  3. Select + Add sheet to build the content.
  4. Select Save.

To change an existing report, open it and select Actions → Edit report.

Report settings

Every report is one or more sheets plus a Settings tab, which works as its cover sheet.

SettingWhat it does
Name — requiredHow the report appears in lists and in the card picker when adding it to a dashboard.
DescriptionOptional note for your team.
CategoriesOptional tags. Pick existing ones or type a new one and press Enter.
Report as ofThe date the whole report's data is current to. Defaults to yesterday.
Report titleThe subject line when the report is emailed. Can be dynamic, with merge tags such as organization name and date.
File nameOptional. Sets the attachment's file name, for when a recipient's system needs a fixed name. Defaults to the report title.
Access restrictionLimit the report to users with a given permission.

Sheet types

Select + Add sheet and pick a type. A report can hold several sheets; downloaded to Excel, each sheet becomes its own tab. Date and Property sheets are the most used.

SheetOrganizes data by
PropertyProperty, optionally grouped by an attribute such as management company or city, with group totals inline, in a footer, or only at the end
DateDay, week, month, quarter, year or fiscal year
DimensionUnit type, bedrooms, ad source, age, delinquency, lease start or end, status, move-out reason
FinanceAn account tree — income statement, balance sheet or budget. See Financials.
Lease / UnitIndividual leases and units
MortgageA property's loan amortization, from mortgage details in the property table
CompComparable properties
Body text (HTML)Formatted text or HTML with live data tokens — for email cover notes and dashboard cards
Excel templateYour own uploaded Excel file, filled with live data through tokens
Some sheets only work for one property

Lease, Unit and Mortgage sheets are single-property by nature, so they don't sit well in a report built around several properties. Give them a report of their own.

Adding columns

On a Property, Date or Dimension sheet, select + Add column:

  1. Under Datum, pick a data category, then the specific metric.
  2. Set Date as of — usually the report date from Settings.
  3. Choose the Period, such as year to date, and whether to show its sum or average.
  4. Optionally add a comparison with Versus (below).
  5. Select Submit.

On a Finance sheet the Datum is Accrual, Cash, Budget or Pro forma, and every GL row of the account tree is included automatically.

Comparing values

The Versus section compares a value against the same metric at another time — prior week, prior month, start of year — or against a second metric, such as budget against actual.

ComparisonShows
Absolute change +/-The difference as a number
Relative change +/- %The difference as a percentage
Relative value %One value as a percentage of the other

Date sheet periods

Date sheets can show start of period or end of period, format by quarter, and use either fixed periods or dynamic ones — trailing, prior, to date, or future. Columns can total, average, sum or count across the periods shown.

Calculations in a report

There are three places to calculate, and each suits a different question.

WhereWhat it doesUse it forWho
A column’s summary on a date sheetTotals, averages, sums or counts the column across the periods shownTotal move-ins for the quarter; average occupancyEditors
Versus, in a column’s settingsCompares the column with the prior week, month or quarter, the start of the year, or another metricMonth-over-month change in rentEditors
A derived insightA calculation from existing insights (add, subtract, multiply, divide, delta, goal or constant), defined once in Admin → Manage insightsRevenue per unit, or any measure your team defines its own wayAdministrators define it; anyone can use it as a column

Average a rate, like occupancy, and total a count, like move-ins. To see how any column is calculated, hover over its heading.

Formatting a sheet

  • Sheet name and grouping — name the tab, group rows, and change how group headings display. Property sheets can also group by time frame, property by property and by date.
  • Dynamic titles that update with the report date and properties.
  • Columns — select one or several and move them; rename the header; add group and subgroup headers; set the width.
  • Number formatting and text styling — bold, italics, color.

Conditional formatting and exception reporting

Styling rules apply only when a condition is met: equal to, not equal to, greater than, less than, or between. Two common uses:

  • Traffic lights — values below a threshold turn red, values above it turn green.
  • Exception reports — show a number only when it is not zero, so the report highlights just the properties that need attention.

Filtering rows

On a property-based sheet, open a column's Filtering options to show only the properties that meet a condition — for example, properties leased below 94%, or turns taking longer than ten days. Filters support equal to, not equal to, greater than, greater than or equal to, less than, less than or equal to, and between.

Tokens in HTML sheets and Excel templates

Body text sheets and Excel templates pull live data through tokens written in double braces: {{ allUnits }} shows the total units across the selected properties.

  • Start typing inside {{{{ and the platform suggests matching data points — type occupancy to see every occupancy metric.
  • A live preview beside the editor shows the result as you type.
  • A token shows an error until it is complete and valid.

For Excel templates, put tokens in the cells where data should land, then upload the .xlsx with Choose file. The workbook fills with current data every time the report runs.

The Scorecard email

The Scorecard Weekly Email in the Library is a ready-designed HTML email showing the top and bottom performers across up to ten properties for occupancy, absorption, availability forecast, turnover, average days vacant and average days not ready. Copy it, adjust the name, categories and access restriction, and schedule it.

What you can do with a report

  • Email it now or on a schedule — see Scheduled emails
  • Download or print it
  • Add it to a dashboard as a table or graph — see Adding cards
  • Favorite it, which pins it to the top of your homepage
  • Embed it in a spreadsheet or another site — see Embeds
  • Clone it as the starting point for a new report

Need help? Ask Merlin from Help inside the app, email support@revolutionre.com, or use Help → Submit a request.

Contact support
Text version
  1. On a date sheet, each column can total, average, sum or count across the periods shown.
  2. Average a rate like occupancy. Total a count like move-ins.
  3. A column’s Versus settings compare it with an earlier period or another metric.
  4. Show the change in dollars or percent. It stays current as new data arrives each night.
  5. An Administrator defines a derived insight once, in Manage insights.
  6. After that, it works like any other insight: add it as a column in any report.

Step-by-step guides

Each guide below walks through one task on screen, one step at a time. Select a step in the guide to move through it, or use the arrows. The questions under each guide answer what people most often ask about that task.

Start here

Using the platform / Reports & sheets / Start here

Reports overview

See how reports work, one or more sheets plus a Settings tab, and everything you can do with a report once it's built.

Common questions

What is a report?

One or more sheets plus a Settings tab. Every table and chart in the platform, including the homepage dashboards, comes from a report.

What can I do with a report?

Email it now or on a schedule, download or print it, add it to a dashboard, favorite it, embed it, or copy it as the start of a new one.

What's the difference between the Library and My Reports?

The Library holds ready-made templates. My Reports holds your company's own reports, whoever created them.

Can Viewers create reports?

No. Viewers can open, download, print and favorite reports. Creating and editing needs an Editor or Administrator.

Example use cases

  • A new analyst learns how reports, sheets and dashboards fit together.
  • A property manager finds out which reports the team already has.

Find reports

Using the platform / Reports & sheets / Find reports

Browse the report library

Find ready-made report templates in the Library, and copy one as your starting point.

Common questions

Where can I find ready-made reports?

Open Reports and select Library.

How do I find a report quickly?

Search by name or keyword, select a category to filter, or sort by any column heading.

Can I change a Library report?

Copy it first. The copy appears in My Reports, ready to edit, and the original stays intact.

Is there a budget-to-actual report?

Yes. The Library includes a budget-to-actual report and a 12-month statement.

Example use cases

  • An analyst starts a variance report from the Library's budget-to-actual template.
  • A property manager looks for a ready-made leasing report.

Using the platform / Reports & sheets / Find reports

Find your reports

Find the reports your company has built in My Reports.

Common questions

Where are the reports my team made?

Open Reports and select My Reports. It lists your company's own reports, whoever created them.

How do I find a report someone else built?

Search by name or keyword, filter by category, or sort by modified by, created on or updated on.

How do I keep a report I use often close at hand?

Favorite it. Favorites are pinned to the top of your homepage.

Why can't I see a report a colleague mentioned?

It may have an access restriction that limits it to users with a certain permission. Ask its owner or your Administrator.

Example use cases

  • A property manager opens the weekly report her regional manager built.
  • An analyst checks who last changed a report.

Create reports

Using the platform / Reports & sheets / Create reports

Create a report

Start a new report, fill in its settings and add the sheets that hold its data.

Common questions

How do I create a new report?

Select + New report at the top right of the Library or My Reports. Complete Settings, add sheets with + Add sheet, and save.

Should I start from scratch or from a template?

Copying a Library report is usually faster, and it's the best way to learn how reports are built.

What do I fill in first?

Settings. Only a name is required. Description, categories, report date, title, file name and access restriction are optional.

Who can create reports?

Editors and Administrators.

Example use cases

  • An asset manager builds a weekly occupancy report for the portfolio.
  • An analyst builds a trailing twelve-month trend report.

Create sheets

Using the platform / Reports & sheets / Create sheets

Create a property sheet

Add a sheet with one row per property, to compare properties side by side.

Common questions

What is a property sheet?

A sheet with one row per property, optionally grouped by an attribute such as management company or city.

How do I add one?

Edit the report, select + Add sheet and choose Property.

Can I show totals for each group?

Yes. Group totals can appear inline, in a footer, or only at the end.

When should I use a property sheet instead of a date sheet?

Use a property sheet to compare properties side by side, and a date sheet to see a trend over time.

Example use cases

  • An asset manager compares occupancy across every property.
  • A regional manager wants totals by region at the bottom of the report.

Using the platform / Reports & sheets / Create sheets

Create a date sheet

Add a sheet laid out by day, week, month, quarter or year, to see trends over time.

Common questions

What is a date sheet?

A sheet with rows by day, week, month, quarter, year or fiscal year. It's the best sheet for trends.

Can I show trailing or prior periods?

Yes. Use fixed periods, or dynamic ones: trailing, prior, to date or future.

Can columns total across periods?

Yes. Columns can total, average, sum or count across the periods shown.

Does the fiscal year follow our settings?

Yes. Fiscal-year figures follow the fiscal year start set in Global settings.

Example use cases

  • An asset manager charts twelve months of occupancy.
  • A leasing team tracks weekly leasing velocity.

Using the platform / Reports & sheets / Create sheets

Create a dimension sheet

Add a sheet organised by a dimension, such as unit type, bedrooms or ad source, instead of by property or date.

Common questions

What is a dimension sheet?

A sheet organised by a dimension: unit type, bedrooms, ad source, age, delinquency, lease start or end, status or move-out reason.

How do I analyse rent by unit type?

Add a Dimension sheet, choose unit type or bedrooms as the dimension, then add rent columns.

Can I see which marketing sources produce leases?

Yes. Use ad source as the dimension.

Example use cases

  • A marketing manager compares leases by ad source.
  • An asset manager reviews move-out reasons by property.

Using the platform / Reports & sheets / Create sheets

Create a unit sheet

Add a sheet with one row per unit, for unit-level detail at a property.

Common questions

What is a unit sheet?

A sheet with one row per unit, showing details such as occupied or vacant, bedrooms, unit type and make-ready status.

Can a unit sheet cover several properties?

Unit sheets cover one property at a time, so give them a report of their own.

What's the difference between a unit sheet and a lease sheet?

A unit sheet lists units. A lease sheet lists individual leases.

Example use cases

  • A property manager builds a make-ready list of vacant units.
  • A leasing team reviews every vacant unit at one property.

Build reports

Using the platform / Reports & sheets / Build reports

Add report columns

Add columns of data to a sheet, and compare each value with another period or metric.

Common questions

How do I add a column to a report?

On a Property, Date or Dimension sheet, select + Add column. Pick the Datum, set Date as of and the Period, add a Versus comparison if you want one, and select Submit.

How do I compare this month with last month?

In the column's Versus section, compare with the prior period as an absolute change, a relative change % or a relative value %.

What does Date as of mean?

The date the column's value is measured at. It's usually the report date from Settings.

Can I show a sum or an average for a period?

Yes. Choose the Period, such as year to date, and whether to show its sum or average.

How do I compare budget and actual?

Use Versus with a second metric, such as budget against actual.

Example use cases

  • An asset manager shows occupancy against the prior month for each property.
  • An analyst adds year-to-date figures next to the budget.

Using the platform / Reports & sheets / Build reports

Select unit and lease data

Choose which unit and lease details appear on a Unit or Lease sheet.

Common questions

How do I choose which unit or lease details appear?

Add columns to the Unit or Lease sheet and pick from the unit and lease details available.

What unit details can I report on?

Among others: occupied or vacant, bedroom count, unit type and make-ready status.

Why does my unit sheet only show one property?

Unit and Lease sheets cover one property at a time.

Example use cases

  • A property manager lists vacant units with their make-ready status.
  • A leasing manager reviews the leases at one property.

Using the platform / Reports & sheets / Build reports

Filter results and find exceptions

Show only the properties that meet a condition, and build exception reports that highlight what needs attention.

Common questions

How do I show only properties below a threshold?

On a property-based sheet, open a column's Filtering options and set a condition, such as leased below 94%.

Which filter conditions are available?

Equal to, not equal to, greater than, greater than or equal to, less than, less than or equal to, and between.

What is an exception report?

A report that shows a number only when it isn't zero, so it highlights just the properties that need attention.

How do I turn values red or green?

Use conditional formatting. Traffic-light rules color values below or above a threshold.

Example use cases

  • An asset manager lists only properties leased below 94%.
  • An operations lead flags turns that take longer than ten days.

Format reports

Using the platform / Reports & sheets / Format reports

Format report columns

Rename, group, resize and format columns so a report reads clearly.

Common questions

How do I rename a column heading?

Select the column and rename its header. You can also add group and subgroup headers and set the width.

How do I change how numbers display?

Use the column's number formatting options.

Can I move several columns at once?

Yes. Select one or several columns and move them.

How do I highlight values that miss a target?

Add a conditional formatting rule to the column.

Example use cases

  • An analyst prepares an investor-ready report with clear headings.
  • An asset manager groups columns under Leasing and Revenue headers.

Using the platform / Reports & sheets / Format reports

Format text in a report

Style text with bold, italics and color, and use titles that update themselves.

Common questions

How do I make text bold or colored?

Use the text styling options: bold, italics and color.

Can the report title update automatically?

Yes. Dynamic titles update with the report date and properties.

Can I style only the values that meet a condition?

Yes, with conditional formatting.

Example use cases

  • An analyst bolds the totals row so it stands out.
  • A report's title shows the current week automatically.

Using the platform / Reports & sheets / Format reports

Format a sheet

Name the sheet, group its rows and set how group headings display. The steps apply to every sheet type.

Common questions

How do I rename a sheet tab?

Set the sheet name in its formatting options. When the report is downloaded to Excel, each sheet becomes its own tab.

How do I group rows?

Group rows by an attribute and choose how group headings display. Property sheets can also group by time frame, property by property and by date.

Do these options work on every sheet type?

Yes. This guide covers the options every sheet type shares.

Example use cases

  • An analyst tidies a multi-sheet workbook before sending it to investors.
  • A regional manager groups properties by region.

Manage reports

Using the platform / Reports & sheets / Manage reports

Copy and edit a report

Copy a report to make it your own, and edit reports you already have.

Common questions

How do I copy a report?

Open the three-dot menu beside it in the Library or My Reports, select Copy, and name the copy. It appears in My Reports.

How do I edit an existing report?

Open it and select Actions → Edit report.

Should I edit a shared report directly?

Copy it first so the original stays intact, then edit your copy.

Do changes to a report show on dashboards?

Yes. Dashboard cards show the report's tables and graphs, so changes to the report appear there too.

Example use cases

  • An analyst adapts a Library template for the team's own metrics.
  • A regional manager copies a report to make a version for each region.

Using the platform / Reports & sheets / Manage reports

Configure report settings

Set a report's name, date, email title, file name and who can see it.

Common questions

What's in report settings?

Name, description, categories, Report as of, Report title, File name and Access restriction.

What does Report as of mean?

The date the whole report's data is current to. It defaults to yesterday.

How do I set the email subject line?

With Report title. It can be dynamic, with merge tags such as organization name and date.

How do I limit who can see a report?

Set an Access restriction. Only users with that permission can open it.

Can I set a fixed file name?

Yes. File name sets the attachment's name, for systems that need a fixed one. It defaults to the report title.

Example use cases

  • Finance sets a fixed file name so an accounting system can import the report.
  • An asset manager restricts an investor report to the asset management team.

Finish reports

Using the platform / Reports & sheets / Finish reports

Complete a sheet

Finish a sheet and save the report, ready to share. The steps apply to every sheet type.

Common questions

How do I finish a sheet?

Check its columns and formatting, then save the report so it's ready to email, download or add to a dashboard.

How can I check the report before sharing it?

Open it or download it. In Excel, each sheet becomes its own tab.

What can I do once the report is saved?

Email or schedule it, download or print it, add it to a dashboard, favorite it or embed it.

Example use cases

  • An analyst checks a report before its first monthly send.
  • An asset manager finishes a report before adding it to a dashboard.

Export and templates

Using the platform / Reports & sheets / Export and templates

Use Excel templates

Upload your own Excel file and fill it with live data every time the report runs.

Common questions

What is an Excel template sheet?

Your own uploaded Excel file, filled with live data through tokens every time the report runs.

How do I put live data in my Excel file?

Put tokens in double braces, such as {{ allUnits }}, in the cells where data should land, then upload the .xlsx with Choose file.

How do I find the right token?

Start typing inside the double braces and the platform suggests matching data points. Type occupancy to see every occupancy metric.

Why does my token show an error?

A token shows an error until it's complete and valid.

Example use cases

  • Finance keeps the investor report in its existing Excel layout, filled automatically.
  • An asset manager sends a lender's monthly package in the lender's own format.