Add people
You don’t need to know a platform’s URL format. Copy whatever the app gives you, paste it into Homestead, and check the result.
Add someone
Section titled “Add someone”-
Select Add (the centre button on phones, or in the sidebar).
-
Paste into the box: one link, a share message, an
@handle, or many of them on separate lines. Homestead starts reading as soon as you stop typing. -
Check each row Homestead found:
- Platform. For a bare
@handle, Homestead guesses and asks you to confirm. - Who is this? A new person (the name is filled in when Homestead can find it), an existing person, or “Same as above” to give one person several accounts.
- Circles. Where they go, such as Family.
- Platform. For a bare
-
Select Add. A message confirms how many people were added.
Rows Homestead couldn’t read are listed under “Couldn’t read” so nothing disappears quietly. Accounts you already have are marked “Already added”.
What you can paste
Section titled “What you can paste”These are real inputs from Homestead’s resolver tests
(corpus.yaml),
with what Homestead makes of them.
| You paste | Homestead finds |
|---|---|
https://www.instagram.com/lin.cooks/ | Instagram, lin.cooks |
https://instagram.com/stories/lin.cooks/3456789012345678901?utm_source=ig_story_item_share | Instagram, lin.cooks (the story link leads to the profile) |
ig: lin.cooks | Instagram, lin.cooks |
@lin.cooks | A guess (Instagram), with Facebook, LINE and Bluesky offered as alternatives |
https://m.facebook.com/somchai.k?mibextid=ZbWKwL | Facebook, somchai.k, tracking removed |
https://www.facebook.com/profile.php?id=100012345678 | Facebook, numeric profile 100012345678 |
https://line.me/ti/p/~grandma_noi | LINE, ~grandma_noi, visit only |
ไลน์ @thaicook | LINE official account @thaicook (Thai platform name works as a prefix) |
微信:grandma_noi | WeChat ID grandma_noi (a full-width colon works), visit only |
https://bsky.app/profile/alice.bsky.social | Bluesky, alice.bsky.social |
bluesky @alice | Bluesky, alice.bsky.social |
https://twitter.com/jack | X, jack (Twitter and X are one platform) |
https://x.com/jack/status/20 | X, jack, the author of the post |
https://truthsocial.com/@realexample | Truth Social, realexample |
https://example.com/not-a-platform | Nothing: listed under “Couldn’t read” |
Share text from Chinese apps
Section titled “Share text from Chinese apps”Douyin and Xiaohongshu share buttons give you a block of text with a short link inside. Paste the whole thing:
7.43 复制打开抖音,看看【小厨娘的作品】今天做红烧肉 https://v.douyin.com/iAbCdEf/ 12/31 abc:/Homestead follows the v.douyin.com short link, which leads to a video, and picks up the
name 小厨娘 from the text. If someone in your Homestead already has that name, it suggests
them. Because the link points at a video rather than a profile, your agent looks up the
creator’s profile afterwards.
【小厨娘的个人主页】 小红书号:12345678 http://xhslink.com/a/AbCdEf 复制本条信息,打开【小红书】App查看Here it follows the xhslink.com link to the Xiaohongshu profile and reads the name too.
A bare 抖音号 or 小红书号 without a link, or a link to a single Instagram or Douyin post, can’t be turned into a profile on the spot. Homestead adds the account and asks your agent to look up the profile; the row says “An agent will find the full profile”.
The notes under each row
Section titled “The notes under each row”| Note | Meaning |
|---|---|
| Needs an agent to fetch updates | The platform needs a logged-in browser. Connect an agent to see posts. |
| Visit only. This app keeps posts private. | A closed platform. You’ll get visit suggestions instead. |
| An agent will find the full profile | Homestead needs an agent lookup before it can fetch. |
Short links and safety
Section titled “Short links and safety”Homestead only follows short links on hosts the platform registry lists (such as
v.douyin.com and xhslink.com), up to 5 redirects with a 5 second timeout, and only to that
platform’s own hosts. Private and local network addresses are always refused.
Other ways to add
Section titled “Other ways to add”- Share to Homestead. Install the web app as a PWA on Android Chrome and share text to it. The add screen opens with the text filled in.
- The phone app’s share sheet. Available on main (M-05)
- Your agent. Tell it “add @lin.cooks on Instagram to Family”. See Agents.
- The API.
POST /api/v1/resolve, thenPOST /api/v1/quick-add. See API examples.