Public Release Guide

To make a version of your add-on available to alpha sellers you will need to publish it. Note that publishing a version does not make it available to your own seller account, for that you will need to follow the Private Installation Guide. Only one version of an add-on can be published at any time. If you already have a published version and you publish a new version all sellers using your addon will automatically switch to the new version

How to publicly release an Add-on

Step 1: Submit for Review

Before you can publish a version of your add-on it needs to be reviewed and approved by Square. To submit a version of your add-on for review send us an email to dashboard-add-ons-alpha@squareup.com. Include the version number of the build and the ID of the application associated with the add-on. You can find the ID of the applications in Square Developer > Applications

E.g.:

Version: 1.0.2
App ID: sq0ids-fDPu-UkqgL-4bCNXvRDDuQ

Screenshot of the list of developer's applications and their IDs.

Once we receive your email you will see the status of the versions switch to “In review”

Screenshot of add-on builds where one build is 'In review'

Step 2: Get an Approval

Once we review the version we will notify you via email if it was approved or rejected. You will also see the Approved / Rejected status on the Add-ons tab of your Square Developer page.

If a version gets rejected we will provide you with the reason why it was rejected and what needs to be changed for it to be approved. You will need to upload a new version that addresses all the issues and submit it for review.

Screenshot of add-on builds with examples of approved and rejected builds

Step 3: Publish

An approved version does not get automatically published to your sellers. To publish it send us an email to dashboard-add-ons-alpha@squareup.com. Include the version number of the build and the ID of the application associated with the add-on (see “submit for review” above). We will notify you via email once the version gets published. You will also see the version’s status change to “Released (public)” on the Add-ons tab of your Square Developer page.

Screenshot of add-on builds where one build is released