Skip to content

Clarify org-owner requirement for Marketplace app listing#43740

Merged
Sharra-writes merged 1 commit intogithub:mainfrom
luanzeba:luan/marketplace-org-owner-listing-note
Apr 8, 2026
Merged

Clarify org-owner requirement for Marketplace app listing#43740
Sharra-writes merged 1 commit intogithub:mainfrom
luanzeba:luan/marketplace-org-owner-listing-note

Conversation

@luanzeba
Copy link
Copy Markdown
Member

@luanzeba luanzeba commented Apr 8, 2026

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 404 in the Marketplace flow.

What's being changed (if available, include any code snippets, screenshots, or gifs):

  • Updated data/reusables/apps/github-app-managers.md to 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.
    • Wrapped this in ifversion fpt or ghec so the Marketplace note does not render for GHES docs.
  • Updated content/apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md with 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:

  • A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
  • The changes in this PR meet the docs fundamentals that are required for all content.
  • All CI checks are passing and the changes look good in the review environment.

Copilot AI review requested due to automatic review settings April 8, 2026 19:15
@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Apr 8, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

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 links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
apps/github-marketplace/creating-apps-for-github-marketplace/requirements-for-listing-an-app.md fpt
ghec
fpt
ghec
apps/maintaining-github-apps/about-github-app-managers.md fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
from reusable
organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization.md fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.20 3.19 3.18 3.17 3.16 3.15 3.14
from reusable

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).
Copy link

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).

Suggested change
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).

Copilot uses AI. Check for mistakes.
@Sharra-writes Sharra-writes added this pull request to the merge queue Apr 8, 2026
Merged via the queue into github:main with commit 6b9e486 Apr 8, 2026
52 of 53 checks passed
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

triage Do not begin working on this issue until triaged by the team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants