|
| 1 | +--- |
| 2 | +title: About GitHub Copilot Extensions |
| 3 | +shortTitle: Copilot extensions |
| 4 | +intro: 'Learn about {% data variables.copilot.copilot_extensions_short %}.' |
| 5 | +allowTitleToDifferFromFilename: true |
| 6 | +product: '{% data reusables.gated-features.copilot-extensions %}' |
| 7 | +versions: |
| 8 | + feature: copilot-extensions |
| 9 | +topics: |
| 10 | + - Copilot |
| 11 | +redirect_from: |
| 12 | + - /copilot/reference/copilot-extensions/copilot-extensions-faq |
| 13 | + - /copilot/reference/copilot-extensions |
| 14 | + - /copilot/concepts/copilot-extensions/about-copilot-extensions |
| 15 | + - /copilot/concepts/copilot-extensions/about-extensions |
| 16 | +contentType: concepts |
| 17 | +--- |
| 18 | + |
| 19 | +## About {% data variables.copilot.copilot_extensions_short %} |
| 20 | + |
| 21 | +{% data reusables.copilot.copilot-extensions.about-copilot-extensions %} |
| 22 | + |
| 23 | +## Supported clients and IDEs |
| 24 | + |
| 25 | +{% data reusables.copilot.copilot-extensions.supported-clients-and-ides-table %} |
| 26 | + |
| 27 | +## Visibility of {% data variables.copilot.copilot_extensions %} |
| 28 | + |
| 29 | +{% data variables.copilot.copilot_extensions %} can be private, public and shareable, or public and listed on the {% data variables.product.prodname_marketplace %}. Which visibility option you choose will depend on your use case and the audience you are targeting. |
| 30 | + |
| 31 | +* Private extensions are often preferred by large enterprises or companies that: |
| 32 | + * Want more customization and controls over data access |
| 33 | + * Need to integrate with a large volume of internal documents and databases |
| 34 | + * Have strict security policies making it difficult to authorize permissions for third-parties |
| 35 | +* Public extensions are suitable for: |
| 36 | + * Open-source projects |
| 37 | + * Collaborative development and use across organizations within an enterprise |
| 38 | + * Sharing your tool and getting feedback before publishing to the {% data variables.product.prodname_marketplace %} |
| 39 | +* {% data variables.product.prodname_marketplace %} extensions are ideal for third-parties that want to: |
| 40 | + * Offer their service to a broader audience |
| 41 | + * Integrate their tool into the developer workflow on {% data variables.product.company_short %} and the IDE |
| 42 | + * Leverage the {% data variables.product.company_short %} ecosystem to raise awareness for their product |
| 43 | + |
| 44 | +## {% data variables.copilot.copilot_extensions %} permissions |
| 45 | + |
| 46 | +Permissions vary by extension, depending on the level of authorization that the extension requires in order to respond to your query. You can view the required permissions on the extension’s installation page, located after the billing information step and before the install and authorize step. |
| 47 | + |
| 48 | +**For extension users**: At a minimum, the **{% data variables.copilot.copilot_chat_short %}** permissions must be set to "Read-only". Additional permissions may include executing write actions on other surfaces and authorizing read access to repository and organization level data in {% data variables.product.github %}. |
| 49 | + |
| 50 | +**For extension creators**: In addition to the above, you may also request local context from a user’s editor to further tailor responses. To do so, the **{% data variables.product.prodname_copilot_short %} Editor Context** permissions must be set to "Read-only". Users will be notified to provide the required authorization. |
| 51 | + |
| 52 | +For more information on {% data variables.product.prodname_github_app %} permissions, see [AUTOTITLE](/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app). |
| 53 | + |
| 54 | +### Granting permissions to access organization resources |
| 55 | + |
| 56 | +Users with an individual {% data variables.product.prodname_copilot_short %} subscription can install and use {% data variables.copilot.copilot_extensions_short %}. Users with a {% data variables.copilot.copilot_business_short %} or {% data variables.copilot.copilot_enterprise_short %} subscription need an organization administrator to enable this feature. |
| 57 | + |
| 58 | +Only organization administrators can grant permissions for {% data variables.copilot.copilot_extensions_short %} to access organization resources. |
| 59 | + |
| 60 | +To grant organization members access, the organization administrator must: |
| 61 | + |
| 62 | +* Install the extension |
| 63 | +* Grant the extension permission to access specific repositories |
| 64 | +* Authorize access for all, or specific repositories |
| 65 | + |
| 66 | +### Controlling access at the enterprise level |
| 67 | + |
| 68 | +If you are an enterprise administrator, you can disable {% data variables.copilot.copilot_extensions_short %} across your enterprise by setting the **{% data variables.copilot.copilot_extensions_short %}** policy to "Disabled". The "No Policy" setting allows organization administrators to set their own policy. |
| 69 | + |
| 70 | +No, there is no allowlist or blocklist at the enterprise level. |
| 71 | + |
| 72 | +## Sharing data with {% data variables.copilot.copilot_extensions_short %} |
| 73 | + |
| 74 | +The following data is shared when you interact with {% data variables.copilot.copilot_extensions_short %}: |
| 75 | + |
| 76 | +* Data attached to your account and {% data variables.copilot.copilot_chat_short %} usage, such as {% data variables.product.github %} user ID, and timestamps of messages. |
| 77 | +* Past messages within the chat thread where you are invoking an extension. Only one extension can be used per thread, preventing data sharing across extensions. The data retention period for thread context is 30 days. |
| 78 | +* Any additional organization and repository data that is authorized for the extension by your organization administrator. Administrators installing extensions must approve access to the required permissions prior to completing installation. |
| 79 | +* For {% data variables.copilot.copilot_chat_dotcom_short %}, if your administrator has approved the extension to access repository or organization metadata, that data will be shared as well. |
| 80 | + |
| 81 | +## Further reading |
| 82 | + |
| 83 | +* [AUTOTITLE](/copilot/concepts/extensions/build-extensions) |
0 commit comments