Skip to main content
linkapp.config.ts decides who can see your LinkApp and how they discover it. Focus on four areas: manifest.author.accounts, manifest.search_terms, manifest.category, and url_match_rules.

​
Visibility States

  • Draft – Only the accounts listed in manifest.author.accounts can find or install the app. Add every teammate (and yourself) so you can test. 
    manifest: {
  author: {
    accounts: ["your-username", "qa-account"]
  }
}
  • Published – Available to everyone on Linktree. Publishing happens in the Linktree admin after review; the CLI always uploads drafts.

​
Discovery Basics

  • URL matching – Provide hostnames and patterns so pasting a matching URL suggests your app. 
    url_match_rules: {
  hostnames: ["youtube.com", "youtu.be"],
  patterns: [{ pathname: "/watch", search: "v=:videoId" }]
}
  • Keyword search – Add up to 10 specific manifest.search_terms so admins can find you.
  • Marketplace browse – Choose the most relevant manifest.category (grow, sell, share, or other) to control where the app appears once published.
  • Direct link – Share https://linktr.ee/admin?action=create-link&linkType=<your-app-id> to open the admin with your app preselected. Works for draft and published apps, but only whitelisted accounts can install a draft.

​
Draft Testing Checklist

  1. Add every tester to manifest.author.accounts.
  2. Run npx @linktr.ee/linkapp deploy to upload the draft.
  3. Sign in to Linktree with a whitelisted account and confirm you can:
    • Trigger URL suggestions with a matching link
    • Find the app via keyword search
    • Install from the direct link

​
Going Public

  1. Ship and test as a draft until it behaves exactly how you expect.
  2. Request publishing through the Linktree admin or support team.
  3. After approval the status switches to Published, the app appears in the marketplace, and all Linktree users can discover it.