Instructions & Guidelines

Publishing to the Marketplace is coming soon. You can set up your developer account, start building add-ons and prepare for launch. We'll let you know as soon as publishing becomes available.

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.  

By creating a new 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, you need to complete a three-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.

  • Minimal plan: Choose a minimal plan pricing plan needed to use this add-on 

This refers to a minimal pricing plan user needs to be subscribed to in order to use your add-on.

  • Pricing model: Define pricing model for your add-on. Free is the only option available at the moment. Paid pricing model is coming soon.
  • Pricing structure (coming soon): Paid or per seat

Based on the pricing structure you choose, users would pay add-on usage per number of seats (user accounts), or per month.

  • Price (coming soon): Define price per seat or month, depending on the selected pricing structure 
  • Next: Save all information and proceed with the step 2

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

2. Permissions

In step 2, define your add-on’s permission scopes. Every request to the Clockify API requires a specific permission scope. In order to access a specific API on behalf of your add-on users, you need to define the scopes your add-on will use.
For more information about permission scopes, check our API documentation.

  • Check the box to choose the option
  • Click Next

3. 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 add 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 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 page.

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

After you’ve completed all three 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. You’ll hear from us in approximately two weeks. 

How does reviewing process 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, the email will also contain 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.