Roll out a plugin to your whole organization changedplugins/org-rollout
Nearest release: v2.1.283, published under an hour after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 25 Sep 2026 18:00 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 20 Oct 2026 18:07 UTC.
Upstream edited
Recorded here
Lines+29added
Lines−33removed
From line
9
where the diff opens
First seen
25 Sep 2026
this site's first read of the page
Recorded edits4to this page, all time
The whole hunk
from line 9, old and new numbered
/
from line 9
99
1010This page is for the person rolling out a plugin their organization built, on a Team or Enterprise plan.
1111
12<Note>
13 * If you want to list a plugin publicly, see [Publish to the directory](/docs/directory/publish)
14 * If you haven't built the plugin yet, see [Build your first plugin](/docs/plugins/quickstart) and [Plugin structure and testing](/docs/plugins/build)
15</Note>
12> [!NOTE]
13>
14> * If you want to list a plugin publicly, see [Publish to the directory](/docs/directory/publish)
15> * If you haven't built the plugin yet, see [Build your first plugin](/docs/plugins/quickstart) and [Plugin structure and testing](/docs/plugins/build)
1616
1717## Choose a rollout route
1818
from line 33
3333
3434Use both routes when the plugin is for people in chat and Cowork and also for developers whose Claude Code sessions don't sync from a claude.ai account.
3535
36<Steps>
37 <Step title="Lay out the repository as a marketplace">
38 Put the plugin in a Git repository with a `.claude-plugin/marketplace.json` that lists it. You use the same repository for both routes. [Create a marketplace](https://code.claude.com/docs/en/plugins/create-marketplace) in the Claude Code docs covers the format.
39 </Step>
36**1. Lay out the repository as a marketplace**
4037
41 <Step title="Check the repository against the organization sync rules">
42 Organization sync is stricter than Claude Code about the repository's visibility and about which plugin source types it accepts, and it rejects a plugin with a top-level `bin/` directory. Check [the plugin sources that organization sync accepts](/docs/plugins/org-sync#plugin-sources-that-organization-sync-accepts) before you continue.
43 </Step>
38Put the plugin in a Git repository with a `.claude-plugin/marketplace.json` that lists it. You use the same repository for both routes. [Create a marketplace](https://code.claude.com/docs/en/plugins/create-marketplace) in the Claude Code docs covers the format.
4439
45 <Step title="Sync the repository from organization settings">
46 In [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory), add the repository as [Add your own plugins](/docs/plugins/admin#add-your-own-plugins) describes, then [set each plugin's availability](/docs/plugins/admin#set-availability).
47 </Step>
40**2. Check the repository against the organization sync rules**
4841
49 <Step title="Register the same marketplace in managed settings">
50 Set `extraKnownMarketplaces` and `enabledPlugins` as [Pre-install and require plugins](https://code.claude.com/docs/en/plugins/org#pre-install-and-require-plugins) describes. To limit developers to your marketplace, see [Restrict what users can install](https://code.claude.com/docs/en/plugins/org#restrict-what-users-can-install).
51 </Step>
42Organization sync is stricter than Claude Code about the repository's visibility and about which plugin source types it accepts, and it rejects a plugin with a top-level `bin/` directory. Check [the plugin sources that organization sync accepts](/docs/plugins/org-sync#plugin-sources-that-organization-sync-accepts) before you continue.
5243
53 <Step title="Confirm on each surface">
54 * **In claude.ai**: as a member, open [**Customize > Plugins**](https://claude.ai/customize/plugins) and check that the plugin appears there
55 * **On a developer's machine**: start Claude Code and run `/plugin`, which lists the marketplace and the plugin
56 </Step>
57</Steps>
44**3. Sync the repository from organization settings**
5845
46In [**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory), add the repository as [Add your own plugins](/docs/plugins/admin#add-your-own-plugins) describes, then [set each plugin's availability](/docs/plugins/admin#set-availability).
47
48**4. Register the same marketplace in managed settings**
49
50Set `extraKnownMarketplaces` and `enabledPlugins` as [Pre-install and require plugins](https://code.claude.com/docs/en/plugins/org#pre-install-and-require-plugins) describes. To limit developers to your marketplace, see [Restrict what users can install](https://code.claude.com/docs/en/plugins/org#restrict-what-users-can-install).
51
52**5. Confirm on each surface**
53
54* **In claude.ai**: as a member, open [**Customize > Plugins**](https://claude.ai/customize/plugins) and check that the plugin appears there
55* **On a developer's machine**: start Claude Code and run `/plugin`, which lists the marketplace and the plugin
56
5957### If a developer has the plugin from both routes
6058
6159A developer can end up with the plugin from both routes. Claude Code loads one plugin per name. It loads the copy that managed settings install and reports the synced copy as not loaded, as [Name conflicts](https://code.claude.com/docs/en/plugins/loading#name-conflicts) describes.
from line 72
7472
7573**Re-sync** syncs the marketplace now, so members get the version on the default branch without waiting for a push. To re-sync:
7674
77<Steps>
78 <Step title="Open the Marketplaces tab">
79 Go to [**Organization settings > Plugins & skills > Marketplaces**](https://claude.ai/admin-settings/skills?tab=marketplaces).
80 </Step>
75**1. Open the Marketplaces tab**
8176
82 <Step title="Re-sync the marketplace">
83 Open the menu in the marketplace's row and select **Re-sync**.
84 </Step>
77Go to [**Organization settings > Plugins & skills > Marketplaces**](https://claude.ai/admin-settings/skills?tab=marketplaces).
8578
86 <Step title="Retry if you synced recently">
87 If you see **You synced recently**, wait the number of seconds the message gives, then select **Re-sync** again.
88 </Step>
89</Steps>
79**2. Re-sync the marketplace**
80
81Open the menu in the marketplace's row and select **Re-sync**.
82
83**3. Retry if you synced recently**
84
85If you see **You synced recently**, wait the number of seconds the message gives, then select **Re-sync** again.
9086
9187### Update through managed settings
9288
No line in this hunk matches that.