
Quick Answer: Implementing CAM recoveries in Yardi Voyager requires a structured, top-down configuration hierarchy from system-level defaults through property settings to individual lease profiles. The most common error sources are mismatched GL account mappings, incorrect variable/fixed expense classifications, incorrect pro-rata share denominators, and misconfigured cap types. Running the Voyager Data Validation Analytics tool before every reconciliation cycle is the single most impactful quality-control step you can build into your process
Why CAM Recovery Configuration Is So Consequentia
For commercial landlords managing office, industrial, or retail portfolios, CAM expense recoveries can represent a meaningful share of net operating income. Get the Yardi Voyager setup right, and reconciliations run cleanly. Get it wrong, and the errors compound over twelve months before surfacing at year-end often triggering tenant disputes, credit reversals, and audit exposure.
(Recoverable Expenses × Tenant Pro-Rata Share) − Monthly Recovery Estimates = Year-End True-Up
Simple in principle but the configuration that feeds each variable spans dozens of fields across multiple screens. The best practices below represent the patterns that prevent the most expensive mistakes.
The 3-Tier Configuration Hierarchy
Yardi Voyager's recovery module is structured in three layers. Each layer inherits from the one above, meaning an error at the top flows downstream to every property and lease beneath it.
• System Level — Global defaults: area measurement standards, proration types, recovery groups, base expense pools, and global lease types.
• Property Level — Tailor global settings to a specific property: activate relevant lease types and expense pools, set property-specific denominators.
• Lease Level — Attach recovery profiles, base years, caps, minimums, and exclusions to individual tenant leases.
Best Practice 1: Define Recovery Groups and Expense Pools First
Recovery Groups are the categories CAM, Real Estate Tax, Insurance, and Utilities that organize how expenses are bundled for billing and reconciliation. Expense Pools sit beneath them and map to specific GL accounts.
• Audit your chart of accounts first. List every GL account that records a potentially recoverable operating expense and match it to the correct recovery group before creating pools in Voyager.
• Review GL mappings quarterly, not just at year-end. New GL accounts created mid-year for reclassified expenses are the leading cause of 'missing expense' gaps at reconciliation time.
• Use distinct charge codes for estimates vs. reconciliation. Voyager requires separate, unique charge codes for monthly estimate billing and the year-end true-up. Mixing these causes posting errors that are difficult to untangle retroactively.
Best Practice 2: Classify Expenses as Variable or Fixed and Review Annually
Yardi's gross-up mechanism adjusts variable operating expenses to reflect what they would be at a specified occupancy level (typically 95%). The gross-up only applies to expenses classified as variable. Fixed expenses pass through at actuals. Getting this classification wrong has a direct financial impact.
Expense Category | Correct Classification | Why It Matters |
Janitorial / cleaning | Variable | Scales with occupied area |
Common area utilities | Variable | Usage increases with occupancy |
Management fees (% revenue) | Variable | Revenue-linked; occupancy-dependent |
Security (staffed posts) | Partial (split) | Minimum coverage is fixed; extra shifts scale |
Property taxes | Fixed | Set by assessors; not occupancy-dependent |
Insurance premiums | Fixed | Contract-based; does not vary with occupancy |
Landscaping/snow removal | Fixed | Contracted at a fixed scope |
Elevator maintenance | Fixed | Flat-fee service agreements |
Pro Tip: When occupancy varied by more than 5 percentage points during the recovery year, use Economic Occupancy (weighted average) rather than Physical Occupancy (period-end snapshot)
in your recovery pool setting
Best Practice 3: Set the Right Pro-Rata Share Denominator
A tenant's pro-rata share equals their leased square footage divided by the denominator. That denominator is not always the same number across leases, and Yardi will not alert you when it diverges from the lease definition. Common denominator definitions include:
• Total rentable building area (RSF) — the most common definition in office and industrial leases; produces stable pro-rata shares over time.
• Total leasable area — excludes common areas from the denominator; more tenant-favourable and results in higher individual shares.
• Occupied area — denominator shrinks with vacancies, which can increase each tenant's share and lead to disputes; requires annual review.
• Custom denominators for segmented recoveries — required for multi-building or multi-zone properties. Must be tied to correct date ranges.
Best Practice 4: Configure Caps, Minimums, and Base Years Precisely
Among all lease-level configurations, expense caps and base year setups generate the most reconciliation disputes. Two configurations that seem similar can produce very different results over a multi-year period.
Caps
Yardi Voyager supports multiple cap types. The critical distinction is between non-cumulative (each year's increase is capped independently) and cumulative (the total increase from the base year is capped). Always verify the cap type against the lease language before configuration. Caps can increase annually via fixed percentages, CPI indexation, or actual expense increases.
Base Years and Base Amounts
A base-year configuration means the tenant pays only for expenses that exceed those incurred in the designated base year. When base-year actuals are restated after an audit, the stored base amount must be updated manually a step that is frequently overlooked.
Gross-Up Threshold Overrides
When different tenants have different gross-up thresholds in their leases, or some have no gross-up clause at all, Voyager allows tenant-level overrides at the recovery billing record. These overrides must be set individually and are easy to miss during initial configuration.
Best Practice 5: Leverage Advanced Features for Complex Portfolios
Segmented Recoveries
For mixed-use assets or multi-building properties, Voyager's segmented recovery functionality reconciles expenses at the sub-property level using custom denominators tied to specific buildings, floors, or zones. This ensures that each tenant population contributes only to costs relevant to their space.
Anchor Deductions (Retail)
In regional and community retail centers, anchor tenant expenses and their square footage are typically excluded from the inline tenants' pro-rata share calculations. Yardi Voyager's anchor deduction feature handles this automatically when configured correctly. Inline tenant lease-specific exclusions from the anchor deduction benefit must be set at the lease level, not the pool level.
Advanced Recoveries (Cost Distribution via Wildcards)
For portfolios where specific GL accounts require different calculation rules without separate expense pools, Voyager's Advanced Recoveries module supports wildcard-based GL matching (asterisk or @ notation). Particularly useful for HVAC, metered utility, or separately-metered unit charges within a standard recovery framework.
Best Practice 6: Build a Pre-Reconciliation Validation Routine
The most effective quality-control step is running Yardi Voyager's Data Validation Analytics tool before initiating any reconciliation batch. This tool automatically flags:
• Duplicate charge codes assigned to both estimate and reconciliation billing, causing double-posting at year-end.
• Overlapping expense pools where GL accounts are mapped to more than one active pool, causing double-counting.
• Missing area figures null or zero tenant/denominator values that silently set pro-rata shares to zero and suppress recovery billings.
• Inactive lease recovery types profiles attached to leases no longer producing estimates after a lease amendment.
Essential year-end reports:
Yardi Report | What It Catches | When to Run |
Recovery Reconciliation Audit | Estimate vs. actual by tenant, pool, GL | Before finalizing the reconciliation batch |
Expense Recovery / Leakage Report | Unrecovered expenses absorbed by the landlord | After reconciliation, before billing |
Recovery Accruals Report | Projected true-up amounts for accrual posting | Monthly or quarterly |
Data Validation Analytics | Config errors: duplicate codes, overlapping pools | Before every reconciliation run |
Best Practice 7: Update Estimates After Each Reconciliation
Monthly recovery estimates should reflect the most current expense actuals or approved budget figures, not prior-year amounts. After completing a reconciliation in Voyager, navigate to Lease Administration > Recoveries > Recovery Estimate, enter the property code, set the effective date for the new estimate, and recalculate using prior-year actuals or current-year budget.
Pro Tip:
For tenants with caps or minimums, run a prospective cap calculation before updating estimates to confirm the new estimate does not exceed (or fall below) the contractual threshold.Frequently Asked Questions
What is a CAM recovery in Yardi Voyager?
CAM recovery is the process by which a commercial landlord bills tenants for their proportionate share of recoverable property operating expenses, such as CAM, taxes, and insurance. Tenants pay monthly estimates during the year, and the system performs a year-end reconciliation (true-up) comparing actual expenses to estimates, resulting in either a charge or a credit to each tenant.
What is the difference between a Recovery Group and an Expense Pool in Yardi?
A Recovery Group is the high-level category (e.g., CAM, Real Estate Tax, Insurance) that organizes the bundling of expenses for billing. An Expense Pool sits beneath a Recovery Group and maps to specific GL accounts. When Yardi runs a recovery calculation, it sums the actual expenses posted to the mapped GL accounts. It allocates the total to tenants based on their pro-rata share and recovery profile rules.
How does gross-up work in Yardi Voyager CAM recoveries?
Gross-up adjusts variable operating expenses upward to what they would have been if the building were at a specified occupancy threshold (commonly 95%). Only expenses classified as 'variable' in the Expense Pool are subject to gross-up; fixed expenses, such as property taxes and insurance, pass through at actuals.
What is the most common source of CAM reconciliation errors in Yardi?
The most frequent sources are: GL accounts not mapped to any expense pool (excluding expenses from the recovery calculation); variable/fixed expense misclassification (causing over- or under-gross-up); and cap type mismatches (non-cumulative vs. cumulative caps). The Data Validation Analytics tool in Voyager automatically catches many of these issues.
How should custom denominators be managed when they need to change?
When a custom denominator's composition changes, create a new custom denominator effective as of the change date, rather than editing the existing one. Editing an existing denominator rewrites history and can corrupt prior-year calculations.
Need Expert Help With CAM Recovery Setup in Yardi?
Assetsoft has implemented and optimized Yardi Voyager's recovery module for commercial portfolios across Canada, the US, and Australia. Whether you're doing a first-time implementation,
cleaning up a legacy configuration, or preparing for a large-scale year-end reconciliation, our Yardi-Experienced consultants can help.

