Badges and Workflows

Features that work in tandem to drive repeat engagement, help you capture and analyse customer data and do all this with ease and in real time.


What is it? 

Badges allow users to earn badges for taking action across your Hub. Whether it's engaging with content, playing games, or completing forms, Badges provide incentives for customers to return to your Hub repeatedly. 

To support the Badges feature, contacts allow you to assign achievements to certain users based on their activity within your hub! Contacts also support Profiles, allowing users to identify themselves with an avatar while they engage with the games across your hub. 

With Workflows, you can set up customised user flows that are triggered when a user fills out a form or completes a game. These triggers lead to actions that can be used to assign achievements (a.k.a. Badges) to certain users.

Watch it come to life: 

How do I build one? 


Step 1: Turn on Accounts in Hub Settings 

CleanShot 2023-10-27 at 12.52.13
  • Navigate to your Engagement Hub and then head to the Settings tab.
  • Click on Users on the left sidebar.

Note: User Accounts are not technically required, however, if you do not enable User Accounts, a Contacts's badges will be tied to one device/browser session only. If it's important that the Badges persist over time, across devices, then enable User Accounts.


Step 2: Turn on Badges in Hub settings

CleanShot 2023-10-27 at 12.56.41@2x

  • (1) While you're still in Settings, enable the Badges Feature.

Step 3: Set up your Badges 

CleanShot 2023-10-27 at 13.01.05@2x

  • Click on Manage badges and then Create badge.
  • (1) Here you will input an Internal name for the badge.
  • (2) Upload an image of your badge.
    Note: We highly recommend uploading an image with a transparent background.

CleanShot 2023-10-27 at 13.14.20@2x

  • (A) Update the Title of the badge that will be displayed to users on the Hub.
  • (B) Add a Description for the badge. Here is where you'll provide more detail on how to earn this badge. For example, Cast your vote in the controversial poll to unlock this badge!
  • (C) This is the image of the badge you uploaded in Step 3. We automatically greyscale these badges to show they're locked.
  • (D) Clicking on the ... you can edit the earned badge settings.

    • (a) This is the Internal name for the badge set in Step 3(1).
    • (b) Here is the Title of the badge set up in Step 3A.
    • (c) Enter a Description for when the badge is unlocked. For example, Congrats! You've unlocked this badge!
  • After clicking on Update, you will see your badge is in draft mode. To make this live, click on ... next to the badge and select Publish. This will make the badge visible on the Hub and to users.


Step 4: Configure your Badge Variants [Optional]

CleanShot 2023-10-27 at 13.24.16@2x
  • Badge Variants are an easy way to group relevant badges and create a tiered structure where a user can earn different levels of badges within a group.
  • Should you wish to group certain Badges, under the Definitions tab, click on the on a Badge you've created and navigate to the Variants section of the modal. 
  • (1) Click on the Add variant button. 

    CleanShot 2023-10-27 at 13.17.31@2x

    • (A) Enter an Internal name for your Variant
    • (B) Enter a Title for your Variant. 
    • (C) Add a Description for each Badge Variant Group that you create.
      Tip: While descriptions are optional, they are a great way to encourage your users to play again by inviting them to improve their score to unlock the next Badge level. This, in turn, drives repeat engagement!
    • (D) Upload an image to represent this Variant. 
      • (2) Once you have created your desired Badge Variants, use the Drag functionality (the three horizontal lines to the left of each Badge) to order the Badges in your desired tiering system. Then click save.

      Note: The Badge order is ranked from 1 being the most important or highest, and less important or lower as the numbers increase. 

      Step 5: Customise the Style of your Badges

      CleanShot 2023-10-27 at 13.27.18@2x
      • (1) Use a Hex code, the eye dropper tool or the sliders to select a border and text colour for your Unlocked Badges.
      • (2) Use a Hex code, the eye dropper tool or the sliders to select a border and text colour for your Locked Badges.
      • (3) Under the Settings tab, you can choose to overwrite the locked Badge filter, i.e. the way the modal will automatically apply a grayscale to your locked Badges. This way, you can upload your own locked state badge imagery.

      Step 6: Edit the Badge Album [Optional]

      CleanShot 2023-10-27 at 13.28.52@2x
      • The Badge Album allows users to share the Badges they've earned on your Hub by downloading them as a customised image.
      • (1) Navigate to the Album tab on the left sidebar. 
      • (2) To edit the Badge Album, click on the Create Album button. 

      CleanShot 2023-10-27 at 13.31.20@2x

      • (A) Click the Awarded badges row to edit the settings.
        Note: Use the icon next to the stage to add different elements to your Badge Album like Contact Properties, Awarded Badges, etc. 
      • (B) Alter the padding around the badges.
      • (C) Control how you want to present the badges by editing the number of rows and columns.
      • (D) Edit the amount of space between the rows and columns of each badge.
      • (E) Upload a background image and set a solid colour.
      • Use the toolbar on the righthand side of this modal to edit spacing, layout, background, fonts and colours. Here, you can add elements of a users Profile (first name, avatar, etc.) to help them differentiate their Badge Album from those of other users. If you get stuck here, our Live Data Feeds article will help!
      • (3) Here you can also edit the share button that allows users to share their Badge Album.
      • (4) Once ready, you can enable the badge album.

      Step 7: Create Workflows to Award Badges

      CleanShot 2023-10-27 at 13.40.12@2x
      • (1) Navigate to the Workflow tab. 
      • (2) Click on the Create workflow button. 
      • (3) Enter a name for the workflow.

      CleanShot 2023-10-27 at 13.41.48@2x

      • (A) Click on edit icon to set up the trigger.

      CleanShot 2023-10-27 at 13.49.14@2x

        • (a) Using the drop-down, select when you want to award a badge.

          Trigger Definitions: 

          • Contact identified: When a user on your Hub becomes identifiable by their first-party data.
          • Contact property updated: When details of a user are updated to a specific contact property.
          • Gameplay data captured: When a user fills out a data capture form on your Hub. Add filters to only award Badges on certain Cards.
          • Gameplay action occured: When a user completes a specific action within a game mechanic.
          • Gameplay ended: When a user completes a game on your Hub. Add filters to only award Badges for certain games, scores, etc. 
          • Receipt validated successfully: When a receipt using our auto-receipt validation tool has been approved.
        • (b) Once you've selected your trigger, you'll need to Add a filter to connect this to a specific card. 
          Note: You can link this workflow to multiple cards by adding more filters.
        • (c) Click on Save to continue.
      • (B) Click on the edit icon to connect the badge to the workflow.

      CleanShot 2023-10-27 at 13.55.17@2x

        • (a) Using the drop-down, select the badge you want to connect.
        • (b) Then click on Save to continue.
      • After clicking on Save on the workflow screen, you will see your workflow is in draft mode. To make this live, click on ... next to the workflow and select Activate. This will make the workflow live and will award all badges based on the rules setup.
        Note: Repeat step 7 for each Badge or Badge Variant. 

      Note: You can view each execution of an individual Workflow by navigating to the 3 dots next to a flow and selecting Edit.

      Tip: To pause a particular workflow, navigate to the 3 dots next to a flow and select Pause

      • (4) Here you can see all the workflows executed. You can see if the workflows were successful or if any have failed.

      Step 8: Enable & Configure Profiles [Optional]

      CleanShot 2023-10-27 at 14.04.53@2x
      • Profiles allow users to identify themselves with an Avatar while they play.
      • (1) To edit your Profiles, click on the Manage Profiles button. 

      CleanShot 2023-10-27 at 14.06.19@2x

      • (A) Here you can edit the messaging shown on the profile. Include instructions on what to do. For example, collect all badges to go in the running to win X!
      • (B) You can change the background and text colours of the Profile Drawer.
      • (C) Here you can also edit the Active tab colours
      • (D) Click here to edit the profile avatars.

        • (a) Here you can upload images for users to select from to use as their profile avatars.

          • (I) Have your avatars only available on this Hub.
          • (II) Allow uploaded avatars to be used across all Hubs.
          • (III) Click on Add to upload your avatar images.
        • (b) Here you can also toggle on and off the ability for users to edit their Profiles.
      • CleanShot 2023-10-27 at 14.14.04@2x
        • (a) Enter a name for your avatar. 
        • (b) Upload an image to reflect the avatar then hit Add.
      • (2) Toggle the Profiles Feature on.  


        "Go Live" Checklist 

        Ready to go live with your Badges, Contacts & Workflows? We recommend reviewing the following list before launching and double-checking if you have:

        • Ensured that all images uploaded for Badges, Badge Groups, Profile and Badge Album are the correct dimensions. Export image files in 2x to ensure none of the images appear pixelated. Review the design guidelines for Badges here if needed.
        • Activated each workflow to award individual Badges to users. You can do this by checking that each workflow has the green Active badge. 
        • Set up all communications with your contacts using the Accounts settings.
        • Edited all the styling of your Badges and various screens that appear for the end-user as a part of this feature. 
        • You've run a test of your Badges and Workflows to ensure Badges are awarded correctly. 

        Then you're ready to go live! Congratulations, you've built out your very own Badges feature! 

        How can I promote it? 




        Is there a limit to the amount of Badges I can have on my Hub?

        No, there's no limit to the amount of Badges you can create! Just remember, you have to set up a Workflow to award each individual Badge and/or Badge Variant. 

        Can I launch a Badges campaign to run across a certain timeline to encourage repeat engagement? 

        Absolutely! Through our client M&C Saatchi, Woolworths have created a Hub in sponsorship of Netball Australia where there are different games running for each week of the Netball season, so users can return to the Hub repeatedly in order to collect all the Badges. Remember, repeat engagement is driven by how you promote your campaign! Check out some promotion ideas here


        Top Tips

        • The Badges feature provides an excellent opportunity to drive user-generated content (where your users promote your Hub for you!). Make sure you encourage sharing in the copy across your games, the Badge Album, etc. 
        • While Badge Variants are an optional part of this feature, they do create a tiered and layered experience that encourages users to return to your Hub and play again and again in order to collect all the Badges in a given group, so definitely consider configuring these! 
        • Get creative with how you reflect your brand in the design of your Badges. This will help to drive brand recall and recognition, making users even more familiar with your brand. 
        • As with any game or feature of the Komo Platform, the Badges feature is incredibly easy to configure yourself. But as there are a few steps involved, this is an important one to test before you go live. 

        One last note: 

        At Komo, we pride ourselves on not only the results our clients achieve with us but the service they receive whilst bringing their Hub's to life. 

        If you ever have any questions about an upcoming activation, how you can best utilise Komo to get the best possible outcome, or just a general query, please don't hesitate to reach out to your Customer Success Specialist or email us at

        We also love your feedback, so please let us know if this article helped you by selecting from the options below. 


        Louis Docherty 

        Head of Customer Success