A Guide to Report Builder Metrics

A Guide to Report Builder Metrics

Understanding the metrics available in Report Builder is key to making informed pricing and performance decisions. Each metric provides a unique perspective on your listings' performance, covering pricing competitiveness, booking pace, occupancy trends, revenue generation, and market positioning.

Understanding Timeframes & Comparison Suffixes

Across Report Builder, you will encounter standard comparison suffixes. Understanding the difference between STLY (Same Time Last Year) and LY (Last Year) is critical for accurate analysis.

Example Baseline Scenario

  • Today's Date: July 21, 2026

  • Report Period: Q3 (July 1, 2026 – September 30, 2026)

  • Current Metric (e.g., Revenue): Total confirmed revenue for Q3 2026 as of today (includes completed past nights + future confirmed bookings through Sept 30).

  • STLY (Same Time Last Year): Captures the metric's value on the same calendar date last year (July 21, 2025) for the Q3 comparison window.

    • Use Case: Measures pacing. If a local carnival in late September usually gets booked out by late July, STLY reveals whether your current pace matches last year's performance at this exact point in time.

  • LY (Last Year): Captures the final, closed outcome for the comparison period last year (July 1, 2025 – September 30, 2025).

    • Use Case: Benchmarks your current position against the final total achieved last year.

Comparison Formulas

  • STLY YoY % / Difference: Measures current performance relative to the same point in time last year.

  • YoY % / Difference: Measures current performance relative to the final result of last year.


Market Source Configuration

By default, the market source for each listing is set to whatever you have selected in the Neighbourhood dashboard (nearby handpicked listings or Market dashboard). You can also set the market source for groups, tags, subgroups, cities, or bedroom counts by using the "Define My Market Source" button in Report Builder. More information here.

Summary of Variance & Forecast Formulas

Standard Metrics (Revenue, ADR, RevPAR, Bookings, Pickup)
  • YoY % Difference = ((Current Metric - Metric LY) / Metric LY) * 100
  • STLY YoY % Difference = ((Current Metric - Metric STLY) / Metric STLY) * 100
Occupancy Metrics (Expressed as Percentages)
  • Occupancy YoY Difference = Current Occupancy % - Occupancy % LY
  • Occupancy STLY YoY Difference = Current Occupancy % - Occupancy % STLY
Forecast Metrics
  • Revenue Forecast YoY % = ((Forecasted Revenue - Revenue LY) / Revenue LY) * 100
  • Occupancy Forecast YoY Difference = Forecasted Occupancy % - Occupancy % LY

1. Occupancy Metrics

  • Occupancy % - This metric displays the occupancy % of the listings for the selected time period. 

  • Paid Occupancy % - Paid occupancy refers to the occupied % of units that are being used by customers who actually paid for them

  • Adjusted occupancy % - This metric measures the percentage of occupied rooms relative to the net available inventory

Formula for different occupancy metric calculations

(For example, consider in the next 7 nights, 3 are booked; 2 are blocked) :

  • Total Occupancy - Total booked + blocked nights / total nights 

    • Total occupancy = 5/7 => 71.43% 

  • Adjusted Occupancy - Total booked / total available nights(excludes blocks) 

    • Adjusted occupancy = 3/5 => 60% 

  • Paid Occupancy - Total booked / total nights 

    • Paid occupancy = 3/7 => 42.86%

Important note: In Portfolio Analytics and Report Builder, we have Adjusted occupancy and Paid Occupancy. The Total occupancy metric is only used in Dynamic Pricing.

Listing Occupancy

  • Adjusted Occupancy %: Percentage of available (non-blocked) nights that are booked for the selected period.

    • Formula: (Booked Dates / Total Available Dates) * 100

  • Adjusted Occupancy % STLY: Adjusted occupancy rate achieved as of the same time last year.

  • Adjusted Occupancy % STLY YoY Difference: (Adjusted Occupancy %) - (Adjusted Occupancy % STLY)

  • Adjusted Occupancy % LY: Final adjusted occupancy rate for the full period last year.

  • Adjusted Occupancy % YoY Difference: (Adjusted Occupancy %) - (Adjusted Occupancy % LY)

  • Adjusted Occupancy Goal: Target occupancy rate set for the listing. You can set it in Goal Setup Panel

  • Adjusted Occupancy Goal Completion %: (Adjusted Occupancy % / Occupancy Goal %) * 100

  • Adjusted Occupancy Goal Completion Difference: Adjusted Occupancy % - Occupancy Goal %

  • Weekend / Weekday Adjusted Occupancy %:

    • Weekend = (Booked Weekend Dates / Total Available Weekend Dates) * 100

    • Weekday = (Booked Weekday Dates / Total Available Weekday Dates) * 100

  • Forecasted Adjusted Occ%: Projected final adjusted occupancy rate calculated by PriceLabs algorithms.

  • Forecasted adjusted occ % yoy diff: Forecasted Adjusted Occ% - Adjusted Occupancy % LY

  • Adjusted occ % forecast vs goal diff: Forecasted Adjusted Occ% - Occupancy Goal %

Market Occupancy & Market Penetration Index (MPI)


  • Market Occupancy %: Average occupancy rate across all active competitor listings in your defined market.

    • Formula: (Booked Dates Across Market Listings / Total Available Dates Across Market Listings) * 100

  • Market Weekday / Weekend Occupancy %: Market occupancy isolated by weekday or weekend timeframes.

  • Market Penetration Index % (MPI): Measures listing occupancy performance relative to the market baseline.

    • Formula: (Listing Adjusted Occupancy % / Market Occupancy %) * 100 

  • Paid Occupancy %: (Booked Nights / Total Calendar Nights) * 100

  • Total Occupancy %: ((Booked Nights + Blocked Nights) / Total Calendar Nights) * 100

  • Forecasted Paid Occupancy%: Projected final paid occupancy rate for the selected period.

  • Forecasted Paid Occupancy % YoY Difference: Forecasted Paid Occ% - Paid Occupancy % LY

Night Volume Metrics

  • Total Nights: Total calendar days in the selected date range.

  • Booked Nights: Total nights with confirmed reservations.

  • Bookable Nights: Total Nights - Blocked Nights

  • Available Nights: Bookable Nights - Booked Nights

  • Unbookable Nights: Open nights that cannot be booked due to operational constraints.

  • Blocked Nights: Nights manually blocked by the host or owner.

Note: These metrics may reflect more than 1 night per calendar date if you have selected multiple listings or a multi-unit listing.

2. Booking & Length of Stay (LOS) Metrics

Portfolio & Booking Counts

  • Total Active Listings/Units: Count of active listings/units within the selected filter. If any listing is fully blocked/unavailable in the selected time period, that’s not included in this metric.

  • Number of Bookings: Total confirmed reservations received for the selected stay window.

  • Market Number of Bookings: Total confirmed reservations across market listings during the period.

Booking Window Metrics

The booking window represents the lead time (in days) between the booking creation date and the check-in date.


  • Average Booking Window: (Sum of Days Between Booking Date and Check-in Date) / (Total Number of Bookings)

  • Median Booking Window: Midpoint lead time value across all reservations.

  • Market Average / Median Booking Window: Market-wide lead time benchmarks.

Length of Stay (LOS) Metrics

  • Minimum Stay: Minimum length of stay rule configured in PriceLabs.

  • Average LOS: Total Booked Nights / Total Number of Bookings

  • Median LOS: Midpoint stay duration across received bookings.

  • Market Average / Median LOS: Market-wide stay duration benchmarks.

3. Revenue Metrics

PriceLabs categorizes revenue into two distinct definitions based on PMS data feeds:


  • Rental Revenue: Pure nightly rent. Excludes all cleaning fees, extra guest fees, channel commissions, and taxes.

  • Total Revenue: Rental Revenue + Fees + Taxes (excludes channel commissions).
    You can set your custom definition of rental and total revenue
    here.

    The Custom Formula Builder is currently available for the following PMS integrations:

  • Guesty

  • Hospitable

  • Airbnb

  • Hostaway

  • Smoobu

  • Hostfully

  • Ownerrez

  • Lodgify

  • Track

  • Stays

  • Streamline

Revenue Totals

  • Rental Revenue: Gross rental earnings from confirmed reservations.

  • Rental Revenue STLY YoY %: ((Rental Revenue - Rental Revenue STLY) / Rental Revenue STLY) * 100

  • Rental Revenue YoY %: ((Rental Revenue - Rental Revenue LY) / Rental Revenue LY) * 100

  • Total Revenue: Sum of rental revenue, fees, and taxes.

  • Revenue Forecast: Algorithmic revenue projection.

  • Rental Revenue Forecast YoY %: ((Rental Revenue Forecast - Rental Revenue LY) / Rental Revenue LY) * 100

  • Rental Revenue Forecast vs Goal %: (Rental Revenue Forecast / Rental Revenue Goal) * 100

Average Daily Rate (ADR) Metrics

  • Rental ADR: Rental Revenue / Booked Nights

  • Total ADR: Total Revenue / Booked Nights

  • Market ADR: Average booked rate of market competitors.

  • ADR Index %: (Listing Rental ADR / Market ADR) * 100

  • Forecasted Rental ADR: Projected final average daily rate for rental revenue.

  • Forecasted Rental ADR YoY %: ((Forecasted Rental ADR - Rental ADR LY) / Rental ADR LY) * 100

  • Rental ADR Forecast vs Goal %: Forecasted Rental ADR - Rental ADR Goal

Revenue Per Available Room (RevPAR) Metrics

  • Rental RevPAR: Rental Revenue / Available Nights

  • Total RevPAR: Total Revenue / Available Nights

  • Market RevPAR: Market-wide revenue per available listing night.

  • RevPAR Index %: (Listing Rental RevPAR / Market RevPAR) * 100

  • Forecasted Rental RevPAR: Projected final rental revenue per available night.

  • Forecasted Rental RevPAR YoY %: ((Forecasted Rental RevPAR - Rental RevPAR LY) / Rental RevPAR LY) * 100

  • Rental RevPAR Forecast vs Goal %: Forecasted Rental RevPAR - Rental RevPAR Goal

Potential Revenue Metrics

  • Available & Bookable Dates Potential Revenue: Financial opportunity of open calendar dates.

  • Unbookable Dates Potential Revenue: Potential revenue locked due to restrictions.

  • Blocked Dates Potential Revenue: Potential revenue value of host-blocked calendar dates.

4. Price Metrics

Listing Price Definitions

  • Base Price: Base price set for the listing.

  • Price with Default Customization: Recommended price before applying custom overrides.

  • Customized Price (Before Min-Max Limit): Recommended price after custom rules but before caps.

  • Final Price: Final recommended rate (bounded by min/max caps).

  • Historical Final Prices: Snapshot of recommended final rates from previous days. (Final price 1 day ago, 3 days ago, 7 days ago, 30 days ago)

  • Last Seen Price: Rate detected during the most recent data pull.

Market Listed Price Percentiles

  • Average Market Listed Price: Mean asking price.

  • Market 25th/50th/75th/90th Percentile Price: Market rate benchmarks.

5. Pickup Metrics

Pickup tracks net changes in metrics over a rolling timeframe (3, 7, 14, 30, or 60 days).


  • Formula: Metric Pickup (X Days) = Metric Value Today - Metric Value X Days Ago

Booked Nights Pickup

  • Booked Nights Pickup (X Days): Net change in booked nights.

  • Booked Nights Pickup STLY (X Days): Net change in booked nights STLY.

Occupancy Pickup

  • Occupancy Pickup (X Days): Adjusted Occupancy % Today - Adjusted Occupancy % X Days Ago

  • Occupancy Pickup YoY Difference (X Days): Occupancy Pickup (X Days) - Occupancy Pickup STLY (X Days)

Revenue Pickup

  • Rental / Total Revenue Pickup (X Days): Net revenue gain accrued.

  • Rental Revenue Pickup YoY % Difference (X Days): ((Rental Revenue Pickup (X Days) - Rental Revenue Pickup STLY (X Days)) / Rental Revenue Pickup STLY (X Days)) * 100

Rate & RevPAR Pickup

  • Rental / Total / Market ADR Pickup (X Days): Shift in ADR.

  • Rental / Total / Market RevPAR Pickup (X Days): Shift in RevPAR.

6. Holidays & Events Data

  1. Event Count: Total number of local events/holidays impacting the listing.
  2. Event Count LY: Total number of events/holidays LY.
  3. Event Name: Descriptive labels for active events.