Publishing actions in Marketplace

You must accept the terms of service to publish actions in Marketplace.

About publishing actions

Before you can publish an action, you'll need to create an action in your repository. For more information, see Sharing automations.

When you plan to publish your action to Marketplace, you'll need to ensure that the repository only includes the metadata file, code, and files necessary for the action. Creating a single repository for the action allows you to tag, release, and package the code in a single unit. also uses the action's metadata on your Marketplace page.

Actions are published to Marketplace immediately and aren't reviewed by as long as they meet these requirements:

• The action must be in a public repository.
• Each repository must contain a single action metadata file (action.yml or action.yaml) at the root.
  • Repositories may include other actions metadata files in sub-folders, but they will not be automatically listed in the marketplace.
• Each repository must not contain any workflow files.
• The name in the action's metadata file must be unique.
  • The name cannot match an existing action name published on Marketplace.
  • The name cannot match a user or organization on , unless the user or organization owner is publishing the action. For example, only the organization can publish an action named .
  • The name cannot match an existing Marketplace category.
  • reserves the names of features.

Publishing an action

You can add the action you've created to Marketplace by tagging it as a new release and publishing it.

To draft a new release and publish the action to Marketplace, follow these instructions:

1. On , navigate to the main page of the repository.

2. Navigate to the action metadata file in your repository (action.yml), and you'll see a banner to publish the action to Marketplace. Click Draft a release.

3. Under "Release Action", select Publish this Action to the Marketplace.

   Note

   The "Publish" checkbox is disabled if the account that owns the repository has not yet accepted the Marketplace Developer Agreement. If you own the repository or are an organization owner, click the link to "accept the Marketplace Developer Agreement", then accept the agreement. If there is no link, send the organization owner a link to this "Release Action" page and ask them to accept the agreement.

4. If the labels in your metadata file contain any problems, you will see an error message or a warning message. Address them by updating your metadata file. Once complete, you will see an "Everything looks good!" message.

5. Select the Primary Category dropdown menu and click a category that will help people find your action in Marketplace.

6. Optionally, select the Another Category dropdown menu and click a secondary category.

7. In the tag field, type a version for your action. This helps people know what changes or features the release includes. People will see the version in the action's dedicated Marketplace page.

8. In the title field, type a release title.

9. Complete all other fields and click Publish release. Publishing requires you to use two-factor authentication. For more information, see Configuring two-factor authentication.

Removing an action from Marketplace

To remove a published action from Marketplace, you'll need to update each published release. Perform the following steps for each release of the action you've published to Marketplace.

1. On , navigate to the main page of the repository.

2. To the right of the list of files, click Releases.

   

3. Next to the release you want to edit, click .

   

4. Select Publish this action to the Marketplace to remove the check from the box.

5. Click Update release at the bottom of the page.

Transferring an action repository

You can transfer an action repository to another user or organization. For more information, see Transferring a repository.

When a repository admin transfers an action repository, automatically creates a redirect from the previous URL to the new URL, meaning workflows that use the affected action do not need to be updated.

Actions published on Marketplace are linked to a repository by their unique name identifier, meaning you can publish new releases of an action from the transferred repository under the same Marketplace listing. If an action repository is deleted, the Marketplace listing is also deleted, and the unique name identifier becomes available.

About badges in Marketplace

Actions with the , or verified creator badge, indicate that has verified the creator of the action as a partner organization. Partners can email [email protected] to request the verified creator badge.