Sharing Access
Homecast supports two ways to share: home members (invite someone to your entire home) and share links (share specific accessories, rooms, or collections via URL).
Invite a home member
Home members are a Homecast Cloud feature; the Community Edition has no member invites.
How to invite
- Open the home's Share dialog:
- With a mouse: right-click the home in the sidebar → Share Home
- On touch: select the home, tap the top-right ⋯ menu → Share
- In the Members section, click + to open Add Member
- Enter their email address and choose a role (Control is preselected):

| Role | See accessories | Control accessories and run scenes | Create and edit scenes and Apple Home automations | Manage members | Manage share links |
|---|---|---|---|---|---|
| Admin | Yes | Yes | Yes | Yes | Yes |
| Control | Yes | Yes | Yes | No | No |
| View | Yes | No | No | No | No |
- Click Invite — they receive an email with the home's name and their role
Only the owner and admins see the Members section. Members don't need a paid plan of their own; they see the accessories the owner's plan includes.
What the invited person sees
- If they already have a Homecast account, a Home Invitations dialog appears when they next sign in, with Accept and Decline
- If they don't have an account yet, the invitation waits — once they sign up with the same email address and verify it, the invitation is offered
- Until then, their row in Members shows Awaiting sign-up or Awaiting acceptance
- Once accepted, the home appears in their sidebar and under Settings → Homes → Homes shared with you
Change a member's role
Open the home's Share dialog and pick a new role from the dropdown next to their name.
Remove a member
Open the home's Share dialog and click the trash icon next to their name. Their access is revoked immediately. Members can't remove themselves — ask an owner or admin.
Relay access in Apple Home
Separate from Homecast's own roles above, the relay's Apple ID has its own permission level inside Apple Home:
| Level | What works | HomeKit automations |
|---|---|---|
| View-only (default for invited members) | Accessory control, scenes, monitoring, APIs, AI assistants, Homecast automations | Read-only — view and inspect, but not create or change |
| Add & Edit Accessories ("Allow Editing" on older iOS) | Everything above | Full — Homecast and AI assistants can create, edit, enable/disable, and delete |
Both levels are fully supported — choose based on how much you want Homecast to manage. The current level is shown under Settings → your home → Apple Home access, and can be changed anytime in the Apple Home app: Home Settings → tap the relay user → toggle "Add & Edit Accessories".
Share an accessory, room, or collection via link
A share link gives someone access to one thing — an accessory, a group, a room, a collection, or the whole home — without a Homecast account. Good for guests, a babysitter, or a cleaner.
Create a share link
Permissions
Only home owners and admins can create and manage share links. Control and View members see the dialog but can't change it.
- Open the Share dialog for what you want to share:
- With a mouse: right-click it in the sidebar → Share Home, Share Room, or Share Group; for an accessory, right-click its tile → Share
- On touch: select the home or room and tap the top-right ⋯ menu → Share; for an accessory, tap the tile to expand it → Share
- Each item has one link, shown at the top with Copy, Open, and a QR code. Decide who it works for:

| Setting | Options |
|---|---|
| Public Access | Off (nobody without a passcode), View (anyone with the link can see), or Control (anyone with the link can control) |
| Passcodes | Click + → Add Passcode: an optional name, the passcode, an access level (View or Control), and an optional schedule |
You can combine them — for example, public View for everyone with the link, and a Control passcode that unlocks control for the people who know it. When public access is already Control, passcodes aren't needed.
Limit when a passcode works
Turn on Limited Access in Add Passcode to restrict when that passcode can be used:
- Start Date and Expiration Date (both optional) — e.g. a guest's arrival and departure
- Time Windows — Add Window, pick days (or Weekdays / Weekends), and a From / Until time in half-hour steps, in the timezone you choose
The schedule is checked on every request, so an expired passcode stops working at once. Two limits to plan around:
- A window can't cross midnight — for 10 pm to 6 am, add two windows (10 pm–11:30 pm and 12 am–6 am)
- The latest Until time is 11:30 pm, so a window ends at 11:30 pm rather than midnight
Outside its schedule, a passcode is refused with the same Access Denied message as a wrong passcode — tell your guest when it will work.
Public access has no schedule; to time-box access, use a passcode.
What the recipient sees
A standalone page showing only what you shared, with a View Only or Control Access badge. No app or account is needed. A passcode-protected link asks for the code first; a link with public View and a Control passcode offers Unlock Control.
If the owner has turned on Analytics on shared links, the page can also show charts for what it shares.
Share links also work as API endpoints. GET https://api.homecast.cloud/s/{hash} returns the current state as JSON — useful for scripts and dashboards. See Share Links reference.
Revoke access
- Public access: set Public Access to Off
- A passcode: click the trash icon on its row
- Everything you've shared: Settings → Sharing → Shared Items
Removing a passcode doesn't change the link — public access and other passcodes on it keep working. The link itself stays the same for as long as the item is shared.
For developers
Access tokens and OAuth clients can also be scoped to specific homes with view or control permissions. See Authentication and the Share Links API reference.
Something not working? Sharing issues