New updates & improvements to Clarify.

Android Release 3.1 & 3.2

  • 3.1
    • Change the view date in Boards.
  • 3.2
    • Collections sorted
    • Engineering unit added for calculations
    • Better calculation of y-axis
    • Show numbers based on local settings
    • Misc bug fixes and improvements

iOS Release 3.7 & 3.8

  • 3.7
    • Deep links: User can now send links to Boards or Items and they will open in the App.
    • Misc. bug fixes.
  • 3.8
    • Board Metrics & Gauges shows engineering unit.
    • Misc. bug fixes.

Improved Filters

Web client improvements.

  • Filter Items to find Items with missing Labels.
  • Filter Items by their source integration.

API v1.1.2

We are introducing two new error codes to Clarify.

When a request is rate-limited, you now receive the new error code -32011 (Too many requests) instead of -32015 (Try again). This aims to allow clients to handle rate-limits in a more explicit manner.

When requesting an evaluation through clarify.evaluate, and the evaluation reference more than the allowed number of unique items, you now get the new error code -32022 (Too many items selected) instead of -32000 (Server error).

While these changes could break some code, these are changes that are explicitly allowed by our Versioning document. If you are negatively affected by this change, please let us know, so that we can take your experience into account for future patch releases.

See the V1.0 and V1.1 release notes for an overview of all changes.

iOS Release 3.6

New navigation. You'll now find My Library, Watchlist & Activity in the app tab bar.

My Library: You can now search for documents straight from My Library. You'll also find pinned documents and collections.

Watchlist: Select and find your favourite Items.

Activity: View and search the latest activities.

Bulk Edit & Sort Order

Updates to the Clarify Web Client.

  • Item Bulk Edit
    Edit "Gap duration" and "Sample interval" on multiple Items at the same time.
  • Items Sort Order
    Items are now sorted by name (instead of when they are created).

iOS Release 3.5

Now you're able to quickly add your favourite data sources straight from the Home-tab.

Look for the "+"-icon and select which data source you want to add and create your list.

Faviourites can also be displayed in iOS Widgets.

Introducing Calculations in Boards

Calculations bring "spreadsheet" like formulas, conditional logic and ad hoc analysis to Clarify Boards. Say goodbye to copy-pasting and manual input to stay up to date.

Unlike spreadsheets, Calculations let you easily construct your formula with visualized steps so that you are less likely get lost in complexity. Verify the validity of your calculation as you go.

You'll find most of the formulas you already know such as SUM, AVERAGE, COUNT, MIN, MAX, IF and many more. Combined with conditional logic you have the power to enrich your data like never before. It's time to move your spreadsheets to a better home.

Here's some use-cases we have already seen from our customers:

ESG reporting

CO2 emission calculations

Price-based calculations

Fuel and energy consumption


Production line uptime

Percentage of scrap pieces


Daily distribution of machine running / not running / error


Days left of material based on current consumption

Trigger notifications with the Clarify Evaluate API

Use no-code/low-code solutions to send messages to Microsoft Teams or similar when certain conditions happen

Check out our Board documentation for more details.

Use Calculations to create your own OEE overview
Example of calculations in Clarify

API v1.1 Release

We are proud to announce that today we release the Clarify API v1.1. This notice is relevant for you if you integrate directly to our HTTP APIs.  Updates to our Python and Go SDKs will arrive later.


Here are the most important changes from the API v1.1beta2 release. For a full list of changes since API v1.0, please see our API release notes.

New clarify.evaluate method

The new method clarify.evaluate allows defining custom aliases for your item aggregations, as well as specifying time-shift (by a number of buckets) and evaluating math expressions similar to those previously exposed through calculated items.

Breaking changes since v1.1beta2

All RPC methods from API v1.1beta2 are available in API v1.1, but there are some minor braking changes. These changes will take effect for you if you do not set the X-API-Version header, or if you  explicitly change the header value from "1.1beta2"  to "1.1".

The parameter groupIncludedByType has been replaced by a new parameter format. This allows standardized formatting options for all methods that return a resource selection. This change is only relevant to SDK/API client developers as the parameter is not intended as an end-user configuration.

Deprecation of API 1.1beta1 and 1.1beta2

API v1.1beta1 and v1.1beta2 should now be considered deprecated and will only receive security updates.

Removal of the API v1.1beta1 and 1.1beta2 versions will be announced in advance, giving  everyone a reasonable amount of time to update.

Calculated items:  Breaking change and new function

To improve the consistency in how operators work in calculated items, we are doing a breaking change to the result of  additions (+) and  subtractions (-)  when either of the input values contain empty values. To allow backwards compatibility for existing use-cases we have added a new function sum that retain the old behavior. The sum function is available now, while the changes to +/- will go live on Friday August the 25th 2023. This should give you some time to apply manual migrations, if you require it.

Is this change relevant to me?

If you use the + (or -) to summarize items that can be empty for any given calculation bucket, you should use the new sum function to retain the old behavior.

Breaking change to +/- with empty values

We will change how + and - works when combining series that contain missing (empty) values. Before the breaking change goes live, we return a result for all time buckets where at least one of the input values contains a value. We do so by replacing the empty value with 0. This is different from how other operators work, such as * (multiplication) and / (division), which only return results when both inputs contain a value. After the change,  addition and subtraction will — just like all the other operators — only return a result when both inputs contain a value.


To better understand the change, consider a calculation where you want to return the difference between the inside and the outside temperature, and consider what would happen if either of the series are missing a value. We have illustrated this below.

Before the change we produce a result when at least one input contain a value. In this use-case, the result is not what we want.

After the change, we return results only when both inputs have values. For this use-case, the result is what we want.

Introducing sum

Sometimes, you want to be able to summarize multiple series and return results, even for time buckets where one or more of the input values are empty. Before the breaking change, you will be able to do this using the + operator. However, if you want the calculation to work after the breaking change gets introduced, you must convert to using the sum function instead.

The sum function work by returning the sum of all non-empty inputs. I.e. sum(a, b, c) would work similar to how a + b + c worked before the breaking change.

Migration old calculations

Before you migrate your existing calculations, you should consider which results you really want, rather than the results you got in the past. If you need help to understand what's best for you, please do not hesitate to contact Support.

Below is a short table of how to produce backwards compatible sums, that is sums that return results even when one of the inputs are empty.

Old syntax New syntax
a + b sum(a, b)
a + b + c sum(a, b, c)
a - b sum(a, -b)

If you are calculating the diff of two items, and where smart enough to figure out that you could use ternary conditions to omit empty values, you can simplify your expression once the breaking changes go live. Note that you are note required to do this simplification, as the old expression will continue to give valid results.

Old syntax New syntax
a != null && b != null ? a - b : null a - b

For more calculation options, check out our reference documentation.

Clarify Boards - The no-code industrial dashboard

Today we're happy to announce the release of a no-code industrial dashboard in Clarify along with several other new features.

With Boards, you can enjoy hassle-free and highly customisable dashboards without vendor lock-in.

  • New visualizations such as bar, metric, gauge, line & area chart with stacking, aggregation and time-bucketing
  • Works out-of-the-box with both your existing and new data
  • Display your data on monitors and TVs with auto-refresh
  • Works with all modern desktop browsers
  • Mobile app support expected end of June
  • Already available and included in your existing Clarify subscription

Would you like a personalised demo or more information? Request access here


Calculated items can now evaluate conditionals, allowing you to create powerful state evaluations from your data. You can read more about how to build your own conditional logic in our updated guides.

Other fixes and improvements

- New guides added for Kepserver and Teltonika TRB-XXX

- Updated Node-RED nodes

New operators in calculated items

With this release we've added some new operators that you can use in your calculated items.

  • Trigonometric: sin(x), cos(x), tan(x)
  • Exponents and square root: x**n and sqrt(x)

Learn more about how to do calculations based on your raw data from our guide.

Other fixes and improvements

- New formats supported for MQTT, Data frame and Kepserver.

- iOS application has an updated menu system

- Statistics is now supported for calculated items

MQTT Broker

After weeks of testing, we are happy to announce that our MQTT Broker interface is available to all customers. You can now connect any device or software with MQTT support to Clarify in order to start logging and visualizing data. Head on over to our documentation to get started!

Clarify now provides an MQTT Broker interface.

Sparkplug B

With the release of our MQTT Broker interface also comes support for Sparkplug B. Compatible devices can now stream both data and meta-data directly into Clarify, significantly reducing the time and effort required to get started.

Sparkplug B support makes it easier than ever to add data to Clarify.


We just launched our new Golang SDK. Currently it only supports writing data to Clarify, but support for querying data is coming as well! Read more about it in our documentation or check out the Github repository.

Other fixes and improvements

Headers in the admin panel

When using the admin panel in Clarify there are some guides from our documentation that can be handy. We have now updated the headers in the admin panel to show relevant information, including links to documentation for the different menus. This means you can easily find guides for integration, item management and more when you need it the most.

Headers contains a short explanation, as well as links to documentation.

More space for labels

We have heard from some of you that you have more labels than our item cards are able to show, and now we've fixed that. Labels shown on item cards will now be shown over multiple lines, allowing for larger label structures than before without losing sight of them!

More labels on item cards

New front page for our documentation

Our documentation pages are growing a lot these days and to make it easier to navigate, we've completely redesigned the front-page to help you navigate it. If you are just getting started with Clarify, make sure you check out our user guides.

Other fixes and improvements

  • Favourite timelines on Android
  • Improved touch support for web app
  • Fixed missing translations
  • Added a button to delete created datasets
  • Admin panel drop-down menu has gotten a UI overhaul
  • Bulk-editing labels now support assigning new categories

Bulk operations

Ever wanted to add a label to multiple items, or wanted to fix a typo in the item name across twenty different items? Now you can! Simply select the items you want to edit, then choose one or even multiple operations to apply.

Updated documentation

We've been working on our documentation pages for a while and we're happy to announce that they have now been officially released. Over the next weeks we'll be adding more content, updating the front-page with a fresh look and overall adding lots of nice improvements. Head on over to to check them out!

Improved UI for visualizations

We've improved how a visualizations menu is shown in the timeline view. It's now easier to find the button to open the menu, as well as seeing if a visualization has a name or not.

Threshold menu

The menu for configuring thresholds used to be available on both items and visualizations. This could lead to some confusing situations as there was no clear way to distinguish them on the graph. Now the setting is only available on visualizations, and the design of the settings menu has been improved to make it easier to set color and name.

Quick navigation in timelines

This feature was added a while back but hasn't been properly announced until now. For longer timelines, it can sometimes be hard to navigate vertically. Now, instead of scrolling through the timeline, you can open the right-hand navigation menu and click the name of a visualization to jump to it. The timeline will scroll to the correct position and even flash the name of the visualization you clicked to make it easy to spot!

Time shift

Often when we're working with time-series data, we want to see how we are doing compared to some earlier time period. Time shift allows you to do just that. This feature has been long awaited and we're super happy to announce that time shift is now available for everyone!

Create custom datasets

Note: this feature is only available to customers on the business plan

Want to share data with another organization? You can do so now in an easy to use, safe and transparent way using Clarify datasets. Simply create a dataset from the admin panel, then choose the organization you want to share it with. You can add or remove items, or even revoke the dataset entirely at any time, giving you full control of who can access your data.

API authentication

We've heard from some of you that supporting OAuth 2.0 client credentials in your integrations isn't always easy or even possible. That's why we've added the option to choose from either OAuth 2.0 or Basic authentication when connecting with our APIs. You can also have multiple credentials per integration now, making it possible to roll over credentials without any downtime.