Instructions & Guidelines

Create add-on

How to create add-on? 

You’ll have complete independence and autonomy over building your add-on. This means that you’ll build it locally, but before submitting your code for a review, you should test it in the testing environment provided to you. Also, check out our REST API documentation and Development Toolkit section to get a better insight on how to build and maintain add-ons. Add-on then needs to be approved by our developers in the reviewing process and then it can be published.  
To make sure the whole process goes smoothly and your request is approved shortly, we will provide you with the necessary requirements and standards all add-ons should meet in order to be published.  

When creating an add-on you’re actually creating the first version of your add-on. All subsequent iterations will be defined as versions in the Marketplace (e.g. v 1.0.1).

To create add-on: 

  1. Go to app.clockify-marketplace/developer 
  2. Create your developer account
  3. Go to Add-ons page 
  4. Click CREATE ADD-ON 

Now, complete a two-step process and enter the required data. 

1. Basic information

  • Add-on icon: Upload image
  • Add-on name: Choose a descriptive name that users can easily understand
  • Add-on manifest: Enter URL
  • Product: Refers to the application for which you are creating add-on 

At the moment, you can only choose Clockify. You’ll be able to create add-ons for Pumble and Plaky soon. 

  • Visibility: Public – Add-on is visible to everyone and allows users within the community to share it.

At the moment, add-ons can only be public. Private add-ons are coming soon.

  • Pricing model: Define pricing model for your add-on. Free is the only option available at the moment. Paid pricing model is coming soon.
  • Next: Save all information and proceed with the step 2.

After you click NEXT, all the information is saved. At this step, you can only change add-on’s name and logo. However, you can save the form as draft and edit it later.

2. Listing

Information you add in the listing will be available in the Marketplace. Use it to help drive users to your add-on.

  • Choose category: Define a niche or business sector you’d like to improve by building this add-on. In the Marketplace, published add-on will be placed in the category you selected here. 
  • Short description: Give a short overview of the purpose of your add-on and solution it provides 
  • Long description: Explain what your add-on is providing in greater detail and the value it brings to users 
  • Privacy policy: Define privacy policy and clearly disclose which information you’re collecting in this manner
  • Terms of use (optional): Along with privacy policy, you can also add terms of use users need to agree to, in order to proceed with installation

Please keep in mind that, if there are some contradictory statements in terms of use you provided here, to those written by our legal team,’s legal policy should be followed. 

  • Website (optional): Add a link to the website that contains more information about add-on. Creating a website that promotes your add-on can help you attract more users.
  • Add-on gallery (optional): Upload a set of images, or screenshots that reflect the purpose and promote your add-on in the best way. You can upload up to 5 images.
  • Demo video (optional): Add demo to spread the word, boost traffic, or use it as an instructional video. Video needs to be publicly accessible on YouTube. 

We encourage you to provide some additional instructions, including information that would be relevant to the person doing an add-on review like some additional notes or any other kind of specific guidelines.

Finally, by checking the Marketplace Listing Terms box you agree that you’ll meet and oblige the listing terms stated there as long as your add-on is part of the Marketplace.

Information provided in this step will be published and available along with the add-on on the Marketplace website.

Information provided in the two-step forms above, must be written in English.  

After you’ve completed the two steps, click the SUBMIT FOR REVIEW button and your add-on will be submitted to the Marketplace team for a review.  

Once you’ve submitted your add-on for a review, our team will start the reviewing process soon as possible.

How does reviewing work?

In order to successfully submit your add-on version for a review, all the fields need to be filled out correctly and there should be no pending requests. 

Once you click the SUBMIT FOR REVIEW button, a new add-on version request will be created. Request will get a pending status and will be sent to our team for a review. You will get an email that confirms you have successfully submitted a request for new version. 

Reviewing process will take approximately two weeks. 

When it’s done, you will receive an email informing you that your request is approved, or denied. The request will also be appropriately marked as approved or denied in your profile.  

If denied, we’ll send you the feedback notes from our team that could help you understand why the request was denied. You’ll also be able to see the request, edit it based on the feedback you received and submit it for a review again. 

If approved, you can continue and publish the version directly from the email you received, by clicking PUBLISH. You’ll receive another confirmation email that will inform you that your add-on is published and available in the marketplace. Click View [addonname] to see it in the marketplace.