• Workflows
  • Automated Submission

Submit Your Extension

The Plasmo Framework ships with a convenient GitHub action called Browser Platform Publish or BPP. This action will automatically publish your extension to all supported browser extension markets. It runs on a manual trigger by default, but changing its config can make it run on every push.

To start publishing your Plasmo extension, set up a keys.json file with the schema:

  "$schema": "https://raw.githubusercontent.com/PlasmoHQ/bpp/v2/keys.schema.json"

This schema is helpful if your editor supports JSON schema. Make sure only to declare valid submission credentials. Otherwise, the action will fail.

NOTE: git ignores this file thanks to our friendly neighborhood .gitignore

Please see this token guide to learn more about the tokens required to submit. The final key might look like this:

  "$schema": "https://raw.githubusercontent.com/plasmo-corp/bpp/v2/keys.schema.json",
  "chrome": {
    "clientId": "123",
    "refreshToken": "789",
    "extId": "abcd",
    "clientSecret": "efgh"
  "edge": {
    "clientId": "aaaaaaa-aaaa-bbbb-cccc-dddddddddddd",
    "clientSecret": "abcdefg",
    "productId": "aaaaaaa-aaaa-bbbb-cccc-dddddddddddd",
    "accessTokenUrl": "https://login.microsoftonline.com/aaaaaaa-aaaa-bbbb-cccc-dddddddddddd/oauth2/v2.0/token"

Copy this key, and add it as a repository secret on GitHub called SUBMIT_KEYS

Then, go on GitHub and trigger the action manually when you need to submit a new extension version!