GitHub Marketplace setup URL finishes the purchase
Build the Setup URL before promotion, because GitHub Marketplace cannot complete a GitHub App purchase flow if the post-install handoff has nowhere reliable to go.
Why this can grow a startup
Teams often treat the listing as the product and the setup path as a later engineering chore. GitHub's purchase flow makes that dangerous. After a customer clicks Complete order and begin installation, GitHub installs the app and redirects the buyer to the Setup URL. The docs say the field is described as optional in GitHub App settings, but it is required if you want to sell through GitHub Marketplace. That means the handoff path is part of acquisition, not cleanup. If the Setup URL is missing or thin, the marketplace surface has created demand it cannot absorb.
Company example
GitHub's purchase-handling guide says customers complete the order by clicking Complete order and begin installation, and that a GitHub App must specify a Setup URL to handle Marketplace purchases even though the field looks optional in app settings.
Source and metric
Source: GitHub Docs: Handling new purchases and free trials
GitHub redirects Marketplace buyers to the Setup URL immediately after installation, and the docs call it required for GitHub Marketplace purchases.
When to use it
Use this when Marketplaces, Onboarding, Infrastructure is relevant to setup handoff, purchase flow, developer tools and you can run a bounded test with a low budget.
When not to use it
Do not use it as a substitute for customer evidence, a clear owner, or a measurable stop condition. Local platform rules and market behavior still need checking.
Founder checklist
- Read GitHub Docs: Handling new purchases and free trials and identify what is directly supported.
- Choose one channel context: Marketplaces, Onboarding, Infrastructure.
- Define the test around GitHub redirects Marketplace buyers to the Setup URL immediately after installation, and the docs call it required for GitHub Marketplace purchases..
- Set an owner, evidence window, and stop condition before launch.
Explore the context
Apply this with an operator
Choose product surfaces that compound distribution without hiding weak activation or retention.