Subscription
The top of Settings shows your HomeMapper Pro status and the buttons that go with it. See HomeMapper Pro for what each status and button means.
Appearance
Theme
Default: System
Choose between System, Light, and Dark mode. "System" follows your device's current appearance setting. This affects the entire app immediately.
Auto-Fit Columns
Default: On · iPad and Mac only
Automatically sizes the visible columns on the Devices table to fit the current window width; when you resize the window, columns hide or reveal as needed. Columns you've explicitly hidden in Field Settings stay hidden; auto-fit only manages the ones you haven't touched. Turn this off if you'd rather pick a fixed set of columns and let the table scroll horizontally instead.
Multiple Topology Bubbles
Default: On
A Pro setting that appears once you have the Topology map. Lets you keep several connection bubbles open at once on that map, so you can compare two links side by side. Tapping another connection line opens another bubble beside the ones already showing, and a button above the zoom controls closes them all. Turn this off and tapping a line replaces the bubble already showing. Either way a bubble stays until you close it.
Hide Unused Topology Tabs
Default: Off
A Pro setting, shown with Multiple Topology Bubbles. When on, the Topology tab leaves out its Thread, Zigbee and Bridged segments when they have nothing to draw for the homes you're looking at, so a home with no Zigbee devices or no bridges doesn't carry a segment that only shows an empty message. All and Health always show. If the segment you're on stops having anything to draw, the tab switches to All. With it off, all five segments show.
Manage Room Order
Customize the order rooms appear in on the Rooms page (and in the Room column on the Devices page). Tap to open a list of your rooms, then press and hold a room and drag it into the order you prefer. By default rooms are listed alphabetically with Unassigned at the bottom. Newly discovered rooms appear at the top of your custom list until you reorder them. The Reset to Default Order button at the bottom restores the alphabetical default.
With Pro and more than one home or more than one Place, the row reads Places, Homes & Rooms, and the screen also groups your homes into Places:
- Places: every Place you have, in the order the Rooms page shows them. Press and hold a Place to drag it into a new order. Open a Place to see its rooms and drag them into order; a room stays in its own Place. Tap a Place's name to rename it, or tap Add Place to make a new one. To delete a Place, swipe it to the left and tap Delete, or right-click it on a Mac and choose Delete. Deleting a Place with homes in it shows a confirmation first, and each of its homes moves into a new Place of its own; Cancel leaves the Place as it was. An empty Place is deleted straight away. A Place with a saved network also offers Reset in the same places, which clears the Place's saved networks and every Don't Ask Again answer that names it. The ⓘ at the top of the screen opens Places.
- Homes: each Apple Home and Home Assistant server, with a menu to choose which Place it belongs to.
- Reset to Default Order: puts both Places and rooms back in alphabetical order.
Support
Release Notes
Opens the Release Notes page showing what's new in each version. Each version is an expandable section with feature highlights and known issues.
Help
Opens the in-app help system with screen-level guides, resource articles, and a searchable FAQ.
Send Feedback
Tapping Send Feedback opens a sheet with a Describe your issue field (minimum 10 characters).
An Include Logs toggle (default on, applies per send) controls whether a diagnostic archive is attached.
What's sent: your typed description and, when Include Logs is on, a diagnostic archive: a debug log, CSV exports of your devices and how they were matched (plus your Home Assistant devices and Places when you have them), a snapshot of your display and filter settings, and a note of any backup you restored. The archive contains no personal data beyond your device, room, and home names.
What's NOT sent: HomeKit credentials or passwords, network passwords, or your Home Assistant sign-in (it stays separate in the Apple Keychain).
The email opens in your mail app so you can review it before sending. See Privacy for a plain-language summary of how we handle diagnostic data, with a link to the full Privacy Policy.
Rate HomeMapper
Opens a short prompt, Enjoying HomeMapper? Yes goes to Apple's rating sheet. Not really shows Get Support, which opens Send Feedback, and Rate Anyway.
Support Configuration ›
Opens a sub-screen with:
- App Permissions: opens your device's Settings app, directly to HomeMapper's permission page, where you can grant or revoke HomeKit (required for discovering HomeKit devices) and Local Network (required for IP Network discovery via Bonjour/mDNS, subnet scan, and SSDP). Home Assistant does not need an iOS permission; it uses an authenticated connection you set up in Settings > Discovery.
- Reset Tips: re-enables all in-app tutorial tips (the popover hints that appear on first use). Tips reset on the next app launch.
- Show What's New on Update: when on (the default), the release notes appear automatically after an app update.
Discovery
Three discovery source toggles control which protocols HomeMapper uses during a scan:
- HomeKit: Discovers accessories from your Home app, with device names, rooms, categories, battery, and reachability.
- Home Assistant: Discovers devices from your Home Assistant instance, including Zigbee, Z-Wave, MQTT, and other integrations invisible to HomeKit.
- IP Network: Discovers devices on your local network via Bonjour/mDNS, subnet scan, SSDP/UPnP, and IP resolution. Reveals non-HomeKit devices like routers, printers, and media servers.
Each toggle can be turned on or off independently. Changes take effect on the next scan.
On Free, HomeKit is always on, and Home Assistant, Thread Topology Scan, Zigbee Topology Scan, and IP Network show a Pro label instead of a switch. Tap one to see HomeMapper Pro.
When IP Network is on, a Show all IP devices toggle appears below it. Off by default; HomeMapper hides IP rows that look like duplicates of HomeKit/Home Assistant devices or low-level network services to keep the list clean. Turn it on to see everything we discover on the network, including those normally suppressed.
Thread Topology Scan (Pro) controls whether a scan reads the extra Thread mesh diagnostics that power the Topology map. On by default for Pro. iOS allows this part of the scan only while HomeMapper is open in the foreground. Turn it off for faster scans when you don't need the map.
Mapping your Apple Home Thread devices needs IP Network on as well. With IP Network off, the toggle still works, but only Home Assistant Thread devices are mapped, not your Apple Home ones. See Getting more from Home Assistant for what Home Assistant needs.
Zigbee Topology Scan (Pro) controls whether a scan reads the Zigbee network from Home Assistant's built-in Zigbee integration (ZHA) for the Topology map. On by default for Pro. It works whatever IP Network is set to. With an administrator account, each scan gets fresh Zigbee readings from Home Assistant; without one, the map shows what Home Assistant last collected.
Home Assistant
Connect your Home Assistant instance to discover Zigbee, Z-Wave, MQTT, and other devices invisible to HomeKit. Getting more from Home Assistant lists the Home Assistant settings that fill in its Thread map, Stability, Channel and Signal.
With one server connected, everything below is under Discovery on this screen, beneath the Home Assistant toggle. Connect a second and it all moves to a Servers screen of its own, opened from a row in the same place that shows how many of your servers are switched on. The Home Assistant toggle itself stays here either way.
Connecting
HomeMapper can auto-detect Home Assistant instances on your local network via Bonjour. If one is found, its URL and name appear automatically. You can also enter a URL manually.
When you tap Connect, HomeMapper checks whether your instance supports encrypted connections (HTTPS) and automatically upgrades if available, including self-signed certificates.
HTTP connections are the default for local Home Assistant installations, the same method used by the official Home Assistant app.
You sign in through a secure browser sheet. HomeMapper never receives your Home Assistant password, only the OAuth tokens Home Assistant issues after you approve access. Tokens are stored in the iOS Keychain (encrypted, hardware-backed), never in the database or logs.
Connection Status
A colored dot next to your instance name shows its health:
- Green: Connected and reachable
- Orange: Your sign-in has expired; sign in again to reconnect
- Gray: Unreachable or not yet checked
Disconnecting
To remove a server, swipe its row to the left and tap Delete, or right-click the row on a Mac (touch and hold on iPhone and iPad) and choose Delete. HomeMapper shows a confirmation first; Cancel leaves the server as it was. Confirming deletes its tokens from the Keychain, sends Home Assistant a request to invalidate them server-side, and removes the devices only that server reported. Setup codes saved for those devices are kept as orphaned setup codes.
Primary Platform
When both HomeKit and Home Assistant are connected, the Primary Platform picker determines which source is authoritative. The primary platform's data takes priority for room assignments, device naming, and display ordering. Default: Apple Home. Change this if Home Assistant is your primary system. Takes effect on the next scan.
Backup
Backup saves a snapshot of your scan results and settings so you can move to a new device or recover after a reset. It's a Pro feature. Open it from Settings > Backup.
What's saved
A backup includes your scan database (devices, rooms, correlations, and any saved setup codes) and your in-app preferences. It leaves out passwords and sign-ins: your HomeKit and network credentials and your Home Assistant login stay in the Apple Keychain, never in a backup.
Automatic and manual backups
Turn on Post-scan Backup (off by default) to have HomeMapper save a backup automatically after each successful scan. You can also tap Backup Now at any time to make one on the spot, whether or not automatic backups are on.
Where backups go
The Destination picker chooses where backups are stored: iCloud Drive or a folder on this device. iCloud Drive is the default. It keeps your backups available across your devices, in a HomeMapper folder at the top level of iCloud Drive. You'll find it in the Files app on iOS, or in Finder under iCloud Drive on a Mac. Pick a local folder instead if you'd rather keep them on one device.
How many are kept
At Most sets how often an automatic backup runs: hourly, daily (the default), weekly, or monthly; each window keeps only its newest, so they don't pile up. Max Backups caps how many are kept, separately per kind: Auto for automatic (post-scan) backups, Man for Backup Now ones. Defaults: 10 automatic, all manual (a Backup Now snapshot stays until you delete it or set a Man cap). The Backups list tags each one Auto or Man. Delete one by swiping it left and tapping Delete; on a Mac, right-click or long-press instead.
Restoring
In the Backups list, pick one and tap Restore. HomeMapper saves a safety backup of your current data first (so a mistake is recoverable), then swaps in the one you chose. To finish, quit and reopen the app, since iOS doesn't allow an app to relaunch itself. A backup from a newer version of HomeMapper can't restore to an older one, so update first if you see that message.
Setup Codes
Save each device's setup code (the number on its sticker or box) so you still have it when the sticker is long gone. A Pro feature. Add codes one device at a time, fill them in room by room from this page, or export a CSV worksheet, fill in the blanks, and import it back. See Setup Codes for the full story.
Advanced
Opens a sub-screen with always-available maintenance actions.
iCloud Sync
Keeps your room order, Places and their saved networks, Home Assistant connections, and saved setup codes in sync across your devices through your own iCloud. On by default while you're signed into iCloud; the switch is disabled when you're not signed in. Turning it off stops this device from syncing without deleting anything. iCloud Sync Now forces a sync right away, and the screen shows when the last sync happened. See iCloud Sync for the full story.
Delete iCloud Data
Removes HomeMapper's setup codes, room order, Places and their saved networks, and Home Assistant connections from iCloud and turns iCloud Sync off on this device, after a confirmation dialog. The data on this device is kept. Another device that still has iCloud Sync on can upload its copy back, so to clear it everywhere, do this on each device.
Reset Scan Data
Clears discovered devices and scan history after a confirmation dialog. Your saved setup codes are kept, and your settings, permissions, tips, and theme are not affected. After resetting, your next scan starts with a clean slate.
Purge Unreachable Devices
Removes the devices currently marked unreachable, after a confirmation dialog. Unreachable devices with a saved setup code are kept. With Places, the confirmation lists each device by Place, and devices in no Place appear under "No Place". This row appears only when there are unreachable devices to purge.
About
Version shows the app version and build number, such as "26.5.0 (181)", followed by the device database version in brackets. Tap or long-press the value to copy it; it briefly shows "Copied". Paste it when reporting issues.
Privacy Policy, Terms of Use, and Acknowledgements open in-app documents: how we handle your data, the terms you agree to by using HomeMapper, and credits for the open-source software the app builds on.