Overview
When your organization occupies only part of a building — for example, three floors of a ten-story office tower — your utility bills may reflect the entire building’s consumption rather than just your portion. The occupancy adjustment feature lets you specify what percentage of a site’s usage belongs to you, and Nectar automatically adjusts usage values so your analytics, exports, and cost attribution reflect only your share.How it works
Occupancy adjustment involves two settings working together:- Occupancy percent — A number between 0 and 100 on the site, representing the percentage of the building you occupy.
- Application mode — Controls how and when that percentage is applied to your usage data.
Occupancy adjustment applies to the raw usage extracted from your bills. The adjusted value flows through to all downstream calculations — analytics, calendarization, exports, and cost attribution.
Adjustment modes
The occupancy adjustment mode on a site determines which usage records are adjusted:| Mode | Behavior |
|---|---|
| Disabled | Occupancy is never applied, regardless of connection settings. Use this when the occupancy percentage is stored for reference only. |
| All data | Occupancy is applied to every usage record at this site, across all connections. Use this when all data at the site represents the full building and you want your share applied uniformly. |
| Per connection | Occupancy is applied only to usage records from connections where Multiply by occupancy is enabled. Use this when some connections already report your tenant’s share and others report the full building. |
Choosing the right mode
- Most common: If all your bills at a site reflect the full building, use All data and set your percentage once.
- Mixed sources: If some connections deliver tenant-specific data (like a sub-meter on your floor) while others deliver whole-building data (like a master meter), use Per connection and enable the adjustment only on the whole-building connections.
- Informational only: If you track occupancy for reporting purposes but don’t want it to change your usage values, use Disabled.
Setting occupancy on a site
- Navigate to Settings > Sites and select the site.
- In the Basic info section, enter the Occupancy % (0–100).
- Choose the Application mode:
- Do not apply (Disabled)
- Apply to all data (All)
- Apply per connection setting (Per connection)
- Click Save.
Connection-level setting
Each connection has a Multiply by occupancy checkbox in its advanced configuration. This setting is only consulted when the site’s adjustment mode is set to Per connection:- If the site mode is All data, every usage record is adjusted regardless of this checkbox.
- If the site mode is Disabled, no usage records are adjusted regardless of this checkbox.
- If the site mode is Per connection, only usage records from connections where this checkbox is enabled are adjusted.
Setting up per-connection occupancy
- Navigate to a connection’s detail view.
- Open Advanced configuration.
- Enable Multiply by occupancy.
- Ensure the associated site has an occupancy percentage set and its mode is Per connection.
Where adjusted values appear
Once occupancy is applied, the adjusted usage values appear across the platform:| Surface | What you see |
|---|---|
| Analytics charts and dashboards | Adjusted values in company-preferred units |
| Data exports (CSV/XLSX) | Both the original bill usage and the converted (adjusted) usage |
| Cost management / tariff analysis | Adjusted values used in all calculations |
| Data inventory usage data table | Original bill values (for verification against the source document) |
| Bill detail view | Original bill values |
Exports include both columns — the raw bill usage and the adjusted usage — so you can always reconcile against the original document.
Bulk import
When importing sites via CSV, you can include both occupancy fields:| Column | Format | Required |
|---|---|---|
occupancyPercent | Number (0–100) | No |
occupancyApplicationMode | DISABLED, ALL, or PER_CONNECTION | No (defaults to DISABLED) |
When recalculation happens
Nectar automatically recalculates affected usage records when any of the following changes:| Change | What recalculates |
|---|---|
| Occupancy percentage edited on a site | All usage records at that site |
| Application mode changed on a site | All usage records at that site |
| Multiply by occupancy toggled on a connection | All usage records on that connection |
| Meter reassigned to a different site | Usage records for the moved meter (if the new site has different occupancy) |
| Meter moved to a different connection/account | Usage records for the moved meter (if the new connection has different occupancy settings) |
Frequently asked questions
What happens if I set occupancy to 100%?
What happens if I set occupancy to 100%?
No adjustment is applied — 100% of the building’s usage is already yours. The system only applies the multiplier when occupancy is between 0 and 100 (exclusive).
Can I have different occupancy percentages for different meters at the same site?
Can I have different occupancy percentages for different meters at the same site?
Not currently. Occupancy is set at the site level and applies uniformly to all meters at that site. If you have meters that represent different portions, consider splitting them across separate sites.
Does changing the occupancy percentage retroactively adjust historical data?
Does changing the occupancy percentage retroactively adjust historical data?
Yes. When you change the percentage or the adjustment mode, Nectar recalculates all affected usage records. This happens in the background and may take a few minutes for sites with many bills.
What happens when I reassign a meter to a different site?
What happens when I reassign a meter to a different site?
If the new site has a different occupancy configuration, Nectar automatically recalculates the meter’s usage records to reflect the new site’s settings. You don’t need to take any extra steps — a notification confirms that recalculation is in progress.
What happens when I move a meter to a different connection?
What happens when I move a meter to a different connection?
If the new connection has different occupancy settings (for example, moving from a connection without Multiply by occupancy to one that has it enabled), usage records are automatically recalculated.
Why did my usage values change unexpectedly?
Why did my usage values change unexpectedly?
If usage values changed without you editing them directly, it’s likely because an occupancy recalculation was triggered. This happens automatically when you (or a team member) change the occupancy percentage, switch the adjustment mode, toggle Multiply by occupancy on a connection, or reassign a meter to a site or connection with different occupancy settings.
How long does recalculation take?
How long does recalculation take?
For most sites, recalculation completes within seconds. Sites with a large number of historical bills (thousands) may take a few minutes. The recalculation runs in the background — you can continue using the platform while it processes.
Can I store an occupancy percentage without applying it?
Can I store an occupancy percentage without applying it?
Yes. Set the adjustment mode to Disabled. The percentage is saved on the site for reference (useful for reporting or future activation) but does not modify any usage values.
How does occupancy interact with calendarization?
How does occupancy interact with calendarization?
Occupancy is applied first — it adjusts the raw usage on each bill. Calendarization then prorates the adjusted values across calendar months. The order ensures consistent results regardless of billing period lengths.
Can I see the original (unadjusted) values?
Can I see the original (unadjusted) values?
Yes. The usage data table and bill detail views always show the original bill values. Exports include both the original and adjusted values in separate columns.
See also: Glossary — Site, Sites overview, Calendarization