Explore
Review the guided introduction and detailed workflows for home modelling, heat flow, connected devices, air quality and design-only sharing.
User guide
Use Recoheat with confidence
This guide follows your account level automatically.
Finding your account guide…
Free guide
For learning what Recoheat does before choosing access or redeeming the Customer access included with a physical Recoheat purchase.
Editable preview
Create one home, change its rooms and fittings, and revisit it for 24 hours. After that, editing and device access pause until access is active. You can still sign in to review access options, download your account data or request deletion.
Physical owners
If you bought a physical Recoheat, use the purchase claim supplied with your order to activate Customer access without a separate app subscription.
Devices and data
You can read the device setup guide before subscribing. Check your access before connecting a device: the free preview is temporary and does not promise lasting device access or retained history.
Customer guide
For understanding and improving one home while retaining complete control of its structure, contents and sharing.
Your account
You can own one active home. An accepted design copy becomes your own home and counts towards that limit; replacing an existing home requires your explicit consent.
Your priorities
Use Heat, energy and air insights to review one home, connect sensors, run heating simulations and keep its model accurate.
Sharing
Send a Pro or Enterprise installer an invitation to receive a separate copy of your home design and objects, without your device links or readings.
Retained readings
For a mapped Home Assistant monitor, separately accept the V2 research-history notice before new account-linked readings can be retained. To view them, open Connected data, choose My account under Accounts in view and Consented retained history under Data view. In Time range, choose Choose a calendar year or Compare a calendar year with the previous year, select the Calendar year (UTC), then choose Show data. Only readings copied after that source's V2 choice appear; earlier V1 and operational readings are not backfilled. A linked Pro or Enterprise account can see this history only while you also grant current per-home data access. The metered-plug recording flow described below is a preview and cannot yet add readings to this history.
Modelled comparisons
In Heat, energy and air insights for your own home, set the model conditions and select Save this model run. Choose two saved runs and Compare estimates to see their assumptions and results together. These are owner-only model estimates, not measured readings or central research data.
Add a device
Follow the device setup steps for your own Home Assistant, Zigbee, Tuya or another supported path; AirGradient cloud has a separate direct connection. Confirm readings or reported state before relying on a room assignment. The metered-plug recording preview is not yet active.
Pro guide
For professionals working with multiple homes and supporting Customer accounts.
Your account
Create and manage multiple homes and save reusable architecture templates.
Customer work
Send a Customer an editable copy of a prepared home’s design and objects. Device links and readings stay with your original home.
Managed accounts
Use Managed accounts to open Customer homes for which you currently hold Manage access. Customer portfolio insights appear once at least two managed homes contribute.
Consented client history
In Connected data, choose Linked clients, then Consented retained history to compare new V2-consented readings by UTC calendar year. Only homes with a current owner-approved per-home data-access grant appear. A design share or past consent alone does not grant access.
Devices and model runs
For a home you own, follow device setup and check each reported entity before assigning its room. You can save and compare modelled heat-flow runs for your own home in Insights. A Manage or data-access grant does not reveal a customer's private model runs or authorise device controls.
Enterprise guide
For organisations coordinating Customer and Pro accounts, portfolios and privacy-protected insight.
Your account
Create multiple homes, save architecture templates and coordinate Customer and Pro relationships.
Portfolio access
Managed accounts lists only accounts linked by an active Manage grant. Select an account to open its permitted homes.
Aggregate insight
Aggregate insights shows anonymised cohort trends only when the privacy threshold is met; it does not reveal household readings.
Consented client history
In Connected data, choose Linked clients, then Consented retained history for homes with both the owner's explicit V2 research-history choice and a current per-home data-access grant. Calendar-year comparisons include only stored readings from after V2 consent.
Compare permitted data
Use Connected data's Account level, Client account, Home, Device and Data type filters to narrow permitted client readings. An empty chart means the selected sources have no eligible readings; it is not an estimate. Your organisation can save modelled scenarios for homes it owns, but a client data grant does not share the client's model runs or device controls. See device setup for owned homes.
Administrator guide
For platform-wide oversight, support and privacy-controlled administration.
Platform scope
View managed Customer, Pro and Enterprise accounts through the administrator boundary.
Operational insight
Use Aggregate insights for privacy-thresholded telemetry health and trends. Continue to diagnose individual homes through an authorised home context.
Consented research history
In Connected data, choose All accounts only with a stated purpose. This account-linked research view includes readings copied under each owner's exact research-history notice; V1 copying remains under its original admin-only scope, while V2 additionally permits an owner's retained view and currently granted linked-client view. Choose a UTC calendar year or compare it with the preceding year; the current year is incomplete. V1 and operational readings are not upgraded or backfilled into V2 views. This is not an independently anonymised research bank.
Safety
Do not use administration as a substitute for consent. A shared design is a separate home; device connections and data stay with the original owner.
Filter and diagnose
In Connected data, state a reason before using All accounts, then filter by account level, client, home, device and data type. Check source and coverage details before comparing years. An empty result does not prove a device is offline. Home Assistant platform setup is separate from Recoheat's owner mapping and any V2 research choice; administrator access does not activate the metered-plug pilot or expose private model runs.
Access and saving
- Free access lets you create and edit one temporary home and revisit it for 24 hours. After that, editing and device access pause until access is active. You can still sign in, download your account data or request deletion.
- Customer access supports one owned home. Pro and Enterprise support broader professional and portfolio workflows.
- A physical Recoheat purchase includes Customer access; redeem the purchase claim associated with the order.
- After access is active, return to Recoheat. A current preview becomes durable, and saving permission is verified by the server on every write.
Install Recoheat on a phone or tablet
- Open Recoheat in Safari on an iPhone or iPad, or in Chrome on Android.
- Open your account menu and choose Install Recoheat. If the browser offers an install prompt, accept it.
- On iPhone or iPad, if no prompt appears, open Safari’s Share menu and choose Add to Home Screen.
- On Android, if no prompt appears, open the browser menu and choose Install app or Add to Home screen.
- Open Recoheat from its new icon. Sign-in and home data still require an internet connection.
The offline page contains no account or home information. Reconnect before viewing or changing a home.
View your home
- Open Recoheat to see your default home. Use the home name menu to switch home or create another when your account permits it.
- Use the prominent Floor control to move between floors. Selecting a room in viewing mode opens its detail without entering editing.
- Choose Air profile to colour room readings by condition. Green is healthy, amber needs attention and red needs action.
- Use the compact table icon for exact room values. Return to Model view for the spatial picture.
A warning reflects the least healthy current room reading. Open Air profile or Table view to identify the room and measurement responsible.
Read heat, energy and air insights
- Open your account tools and choose Heat, energy and air insights.
- Use Day, Week or Month to change the room-monitor history. The heat-flow and daily-energy cards retain one consistent model scenario so comparisons remain fair.
- The central heat-flow view shows heating supplied, heat moving between rooms, mean air temperature and heat leaving through fabric or outside air.
- Energy values are model estimates from the home’s geometry, heating appliances and fabric assumptions. Air-quality trends are observed readings and remain visibly empty when no monitor has reported.
- Pro accounts can switch to Customer portfolio. Only homes covered by an active Manage grant are included, and no aggregate is returned until at least two customer homes contribute.
- For a home you own with saving access, set the model conditions and select Save this model run. Select an earlier and a later saved run, then Compare estimates to review their assumptions and results together. Model runs stay with their owner; a client data grant does not share them.
Saved heat-flow runs are modelled estimates, not measured device readings or central research data. Portfolio responses contain means and sample counts only; they omit customer names, addresses, home identifiers, room identifiers and device identifiers.
Create a home
- Choose the property form, number of floors and bedrooms. Recoheat selects the matching architecture template directly.
- Choose Central heating and its fuel, or choose Other to add heating later. Saved templates contain architecture only.
- Name the home and create it. The new model opens in the shared editor.
- Connect an existing Home Assistant installation now or later, or use Recoheat’s supported device setup when you do not have one. Device connections belong to this home.
Edit structure and contents
Structure
Edit rooms, walls, corners, doors, windows, vents and stairs. Contents remain protected from accidental structural gestures.
Contents
Add or move furniture, sensors, appliances and heat sources without dragging the architecture.
- Select Edit, then choose Structure or Contents.
- Select the target directly in the model. The toolkit changes to the tasks available for that target.
- For a room, open Details and choose Measure this room with your phone. Supported LiDAR iPhones can scan with Apple RoomPlan; every device can enter checked tape, laser or phone measurements. Review the result before applying it.
- Use drag controls for direct changes or Settings for exact values. Sensors expose vertical position; other objects start on the floor.
- A highlighted save control means that target has unsaved work. Green means its changes are saved.
Add rooms and floors
- In Structure mode, choose Add room and select External extension or Internal room.
- For an extension, select the existing room in the plan, then select one of its highlighted outside walls. Use the form for exact position, dimensions, storeys and joining opening.
- Windows, outside doors and vents covered by the extension move to the corresponding new outside wall automatically. Adjust or remove them afterward if required.
- For an internal room, select the room and highlighted wall to divide. Move any object that crosses the proposed dividing line before completing the split.
- Shared walls and openings are saved atomically so airflow and heat-flow paths are recalculated from one consistent plan.
Connect monitors and devices
- Open Add device and select the home that will own the connection. Choose your existing Home Assistant installation or Recoheat’s supported setup path; some hardware still needs a coordinator or an external setup step.
- For your own Home Assistant, first follow the identity companion installation steps. Then authorise as an administrator in Home Assistant; Recoheat does not ask for its password in the app. Your installation is not copied into Recoheat’s shared backend.
- When supported devices appear, give each one a recognisable name and assign it to a room. Review its reported state and available controls in Device control. A saved assignment alone does not verify a physical response.
- For an AirGradient cloud monitor, connect your AirGradient account separately and choose the room it measures. This direct connection does not need Home Assistant.
- In that home’s model editor, save a sensor in the same room (an older saved monitor object also works), then select it. Choose the connected physical AirGradient monitor and select Save monitor link. Map a Home Assistant monitor to this sensor is a separate action for Home Assistant connections.
- Check that the editor shows the saved link, then check Air profile or Table view for reported readings. A saved link alone does not verify a physical monitor or current readings; empty rooms do not generate sensor data.
After a Home Assistant monitor is mapped, the owner may separately choose future account-linked research copies by reading the V2 notice, ticking the choice and selecting Start future research copies. The monitor works without this choice. A prior V1 grant continues copying for authorised Recoheat research staff under its original notice until the owner chooses Upgrade future research copies to V2 or Stop future research copies. The V2 choice applies only to new readings; it does not upgrade or backfill V1 or operational history. Stopping future copies leaves already submitted account-linked history until home or account deletion. Linked Pro or Enterprise access also requires a separate, current per-home data-access grant. The older Home Assistant pilot operational retention remains a separate policy. An independently anonymised research bank is not active.
Pair Zigbee, Tuya and other devices
Home Assistant is the pairing adapter for these platforms. Follow the manufacturer's instructions to power and prepare a device, then use the relevant Home Assistant integration. Home Assistant support alone does not establish that a device or entity has been verified with Recoheat.
- In Recoheat, choose Add device and the home that will own it. For your own Home Assistant installation, complete the Recoheat identity companion steps and authorise that installation as its administrator.
- Pair a Zigbee device in Home Assistant using Zigbee Home Automation (ZHA) with a compatible coordinator, or use Zigbee2MQTT pairing with its own coordinator and Home Assistant discovery through MQTT. Choose the stack that manages that Zigbee network; these are alternative setup paths.
- For Tuya devices, first add the device to Tuya Smart or Smart Life, then follow Home Assistant's Tuya integration guide. This Home Assistant route does not require Recoheat's use of the Tuya app SDK or a Tuya developer account. Available device functions vary by model and integration.
- For other hardware, consult Home Assistant's Matter, Z-Wave JS, Shelly or ESPHome guidance, or its integration directory. Matter over Thread needs a Thread border router; Z-Wave and Zigbee need suitable adapters. These are Home Assistant pairing options, not a Recoheat compatibility list.
- Confirm the expected entity and a changing reading or state in Home Assistant. Return to Recoheat's Add device and Device control to inspect supported entities, name the device and assign it to the selected home's room. If an entity is unavailable, finish its platform setup in Home Assistant before trying the Recoheat assignment. A saved room link alone does not prove live readings or a physical control response.
- For energy monitoring, check that the device actually exposes power in watts or cumulative energy in kWh. See Home Assistant's individual-device energy guide. Recoheat's own-Home-Assistant metered-plug recording path is still an inactive preview; pairing a meter in Home Assistant does not start Recoheat polling, recording or switch control.
AirGradient cloud monitors use Recoheat's separate direct connection. For any future retained account-linked Home Assistant reading, the owner must make the separate source-specific V2 choice; sharing a design or pairing a device is not research consent.
Metered-plug recording preview
The metered-plug link and recording flow in Device control is not yet active. Recoheat will enable it after verifying the owner's Home Assistant installation identity and signed-in account isolation. It cannot currently add switch, power or energy readings to your retained history.
- Once the flow is enabled, first pair a compatible metered smart plug in your own Home Assistant installation. In Add device, connect that installation to the selected home and follow its supported setup steps. Some integrations still require a coordinator or a step in Home Assistant; support for any particular plug or Tuya device remains unverified.
- In Device control, you will name the switch and assign it to a room. A switch reporting power and cumulative energy can then be linked for read-only monitoring. Linking alone will not record history.
- Recording will require you to read and affirm the separate V2 research-history notice for that plug. This choice will apply only to new account-linked readings; earlier operational or V1 readings will not be upgraded or backfilled.
- When active, Record current readings will capture the plug's reported switch state, watts and cumulative kWh only when you press it. This preview does not include automatic polling or plug commands. You will be able to review saved history in Connected data; stopping future recording will not erase previously submitted account-linked history.
The planned path uses your own Home Assistant as a pairing and reading adapter, not Recoheat's shared Home Assistant backend. A linked Pro or Enterprise account would also need your current per-home data-access grant to view retained history. Physical plug response and supported models still need real-device verification.
Run a heating simulation
- Open Simulation and set starting indoor temperature, outdoor temperature, target temperature and duration.
- Review heat-source output, efficiency, radiator provision and valve opening; these determine the useful heat delivered.
- Run the model. Playback advances in five-minute model increments and the settings panel closes on compact screens.
- Review room temperature, airflow, heat loss, fuel use and estimated daily cost. Edit unit fuel prices in the report when your tariff differs from the default.
A simulation is a decision aid, not an energy certificate or a substitute for a heating engineer’s calculation.