Clarify org-owner requirement for Marketplace app listing#43740
Conversation
How to review these changes 👓Thank you for your contribution. To review these changes, choose one of the following options: A Hubber will need to deploy your changes internally to review. Table of review linksNote: Please update the URL for your staging server or codespace. The table shows the files in the
Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server 🤖 This comment is automatically generated. |
There was a problem hiding this comment.
Pull request overview
Clarifies a permissions constraint in the GitHub Marketplace docs: for organization-owned GitHub Apps, delegated GitHub App managers can manage app settings but cannot create or submit Marketplace listings—only organization owners can.
Changes:
- Updated the GitHub App managers reusable to explicitly call out the Marketplace listing limitation (gated to fpt/ghec).
- Added a NOTE to the Marketplace listing requirements article clarifying the org-owner requirement for organization-owned apps.
Show a summary per file
| File | Description |
|---|---|
| data/reusables/apps/github-app-managers.md | Adds a version-gated clarification that app managers can’t list org-owned apps on GitHub Marketplace. |
| content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md | Adds a NOTE under general requirements clarifying only org owners can create/submit listings for org-owned apps. |
Copilot's findings
- Files reviewed: 2/2 changed files
- Comments generated: 1
| @@ -1 +1 @@ | |||
| Organization{% ifversion enterprise-app-manager %} and enterprise{% endif %} owners can designate other users{% ifversion org-app-manager-teams %} or organization teams{% endif %} as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the account. The {% data variables.product.prodname_github_app %} manager role does not grant recipients access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization{% ifversion enterprise-app-manager %} or enterprise{% endif %}. For more information about the specific app settings that {% data variables.product.prodname_github_app %} managers can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app). | |||
| Organization{% ifversion enterprise-app-manager %} and enterprise{% endif %} owners can designate other users{% ifversion org-app-manager-teams %} or organization teams{% endif %} as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the account. The {% data variables.product.prodname_github_app %} manager role does not grant recipients access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization{% ifversion enterprise-app-manager %} or enterprise{% endif %}.{% ifversion fpt or ghec %} For organization-owned apps, the role also does not grant permission to list apps in {% data variables.product.prodname_marketplace %}. Only organization owners can list apps in {% data variables.product.prodname_marketplace %}.{% endif %} For more information about the specific app settings that {% data variables.product.prodname_github_app %} managers can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app). | |||
There was a problem hiding this comment.
There are double spaces inside the {% ifversion enterprise-app-manager %} blocks (" and enterprise" and " or enterprise"), which will render as double spaces in the published text when the condition is true. Remove the extra leading space(s) so the output reads naturally (single space).
| Organization{% ifversion enterprise-app-manager %} and enterprise{% endif %} owners can designate other users{% ifversion org-app-manager-teams %} or organization teams{% endif %} as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the account. The {% data variables.product.prodname_github_app %} manager role does not grant recipients access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization{% ifversion enterprise-app-manager %} or enterprise{% endif %}.{% ifversion fpt or ghec %} For organization-owned apps, the role also does not grant permission to list apps in {% data variables.product.prodname_marketplace %}. Only organization owners can list apps in {% data variables.product.prodname_marketplace %}.{% endif %} For more information about the specific app settings that {% data variables.product.prodname_github_app %} managers can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app). | |
| Organization{% ifversion enterprise-app-manager %} and enterprise{% endif %} owners can designate other users{% ifversion org-app-manager-teams %} or organization teams{% endif %} as {% data variables.product.prodname_github_app %} managers. {% data variables.product.prodname_github_app %} managers can manage the settings of some or all of the {% data variables.product.prodname_github_app %} registrations that are owned by the account. The {% data variables.product.prodname_github_app %} manager role does not grant recipients access to install and uninstall {% data variables.product.prodname_github_apps %} on an organization{% ifversion enterprise-app-manager %} or enterprise{% endif %}.{% ifversion fpt or ghec %} For organization-owned apps, the role also does not grant permission to list apps in {% data variables.product.prodname_marketplace %}. Only organization owners can list apps in {% data variables.product.prodname_marketplace %}.{% endif %} For more information about the specific app settings that {% data variables.product.prodname_github_app %} managers can control, see [AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app). |
|
Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues ⚡ |
Why:
Closes: https://github.com/github/marketplace/issues/4654
A support escalation showed that our docs did not clearly call out a permissions constraint: for organization-owned apps, delegated GitHub App managers can manage app settings but cannot create or submit Marketplace listings. This caused confusion when users saw listing actions but then hit a
404in the Marketplace flow.What's being changed (if available, include any code snippets, screenshots, or gifs):
data/reusables/apps/github-app-managers.mdto explicitly state that, for organization-owned apps, the GitHub App manager role does not grant permission to list apps in GitHub Marketplace and that only organization owners can do so.ifversion fpt or ghecso the Marketplace note does not render for GHES docs.content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.mdwith a note under the general requirements section clarifying that only organization owners can create and submit Marketplace listings for organization-owned apps, and that App managers cannot.Check off the following: