> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linktr.ee/llms.txt
> Use this file to discover all available pages before exploring further.

# Visibility & Discovery

> Control how users find and access your LinkApp

`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.
  ```ts theme={"system"}
  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.
  ```ts theme={"system"}
  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.
