Skip to main content
Skip table of contents

Release notes (Studio)

CleverMaps platform release notes contain updates on all our products - Data Marketplace, Semantic layer (Shell), Studio and Stories builder.


Data Marketplace

  • Significant performance improvements

  • Search Engine Optimization


  • SDK 2.3.8 (Detailed documentation): Added options to enable/disable filtering in Studio using the following booleans:

    • tools.filters hides/reveals the filter button in the top right corner

    • infoBox.globalFilters sets filterable metadata option to false for all category blocks thus disabling filtering in the dashboard

          controls: {
              menu: false
          tools: {
              measure: true,
              search: true,
              compare: true,
              filters: true
          infoBox: {
              viewSwitch: false,
              defaultExpanded: true,
              share: true,
              bookmark: false,
              export: true,
              globalFilters: true
  • Bugfix: Admin not able to edit map legend.

  • Bugfix: Fixed static breakpoint behaviour when legend min and max intervals do not work with distribtion custom breakpoints.

  • Bugfix: User can not click on infobox header close icon.

  • Bugfix: Fallback category legend missing in dotmap legend when categories are empty.

  • Bugfix: Visualized category values (percentage metrics) in map tooltip fixed.

Semantic Layer

  • New field spatialIndex added to geometryPoint dataset type. The value is boolean, default is false. More in Datasets | DWH ref. Enabling the option creates geospatial indexes which significantly speed up operations such as function_distance and filters like nearest or polygonWithin.

  • Shell 2.0.2 (latest Shell version)

    • Fixed removeMetadata --objectName when using with .json extension

    • Removed support for overlap in defaultCompareType in view

    • Added support for property compareCollapsed in view

    • Added support for property compared in defaultActiveFilters in view

    • Added support for customTileLayer in mapOptions in view

    • Added support for filterBy nearest in metric

    • Added support for function_distance in metric

    • Added support for referencing attributeStyle from indicatorDrill

    • Added support for categories, distribution, ranking and timeSeries in blockRows in dashboard

    • Added support for enabling spacialIndex in dataset

    • Property categories in attributeStyle is now optional


  • Restricted content loading from third-party servers using subresource integrity and JavaScript nonce thus better protecting end users from manipulated content.

  • Hidden unnecessary details from error response from REST API.

  • Common Vulnerabilities and Exposures covered:

    • CVE-2024-34447

    • CVE-2024-29857

    • CVE-2024-30171

    • CVE-2024-30172

  • Spring boot updated to 3.1.11



  • New map layer feature: allows to visualize a static indicator in a map layer - same as in chart blocks.

  • Added an option to use custom Map layer in a View: content.mapOptions.customTileLayer - e.g. this one is a Unicorn 🦄 (by Mapbox). More in Views.


  • REST API change: View.content.defaultCompareType now only supports type dominance, the overlap value is no longer supported. More in Views - content.

  • Bugfix: Array content.defaultSelected of values in Metadata object View stores items as numbers or strings. Only strings were supported before.

  • Bugfix: Fixed broken Dominance block in Compare function displaying zero for metric values in blue regions.

  • Bugfix: Overlap Compare flow shows jiggely map visualization - After fix Compare Block overlap cannot be visualized, vizualization of dominance can be turned off in map view.

  • Bugfix: Geo search ignores country set in project settings.

  • Bugfix: Measuring using isoline not working.

  • Bugfix: Spatial query over heatmap not working.

  • Bugfix: Heatmap gradient colors incorrect.

  • Bugfix: Heatmap memory leak.

Semantic layer

  • Updated documentation of Metric’s options object. Key descriptions have been improved and the types of functions they support have been listed. The validations on the REST API have been modified accordingly.



  • New map experience: We are getting close to official support. We added support for measuring distances and isolines, iframe embedding and categories visualization.

  • Bugfix: Missing title in cloning of project modal

  • Bugfix: displaying of block headers with long titles

Semantic layer



  • Improved filtering interaction. Primary action on click is select the clicked thing now and filter-out all others. Like checkboxes. Previously the click unselects the clicked thing and keep the others. This change applies for categories, distribution, and multiselect filters.


  • Improved collapsible blocks visual with little arrows.

    Screenshot from 2024-03-01 13-52-53.png

  • Ability to place blocks and charts right under the group on dashboard. Previously only indicators were allowed.

    Screenshot from 2024-03-01 13-59-24.png

  • Show feature filter in dashbord header which corresponds to the visible map layers.

    Screenshot from 2024-03-01 14-02-08.png

  • Update all base map layers to the newest version. Containing up-to-date data.

  • Improved JSON schema validation while editting metric, dashboard, map or view on UI.

  • Performance optimization: Data for collapsed categories are not loaded.

  • Ability to style map layers in the new map freely with new attributeStyle metadata object. New map experience is heading slowly to the Beta phase. Stay tuned.

  • Migrate data model components to new modern React framework.

  • Better automated tests coverage.

Semantic layer

  • Add new attributeStyle metadata object on BE

  • Hide unnecessary details from error response from BE

  • New role LOCATION_API_CONSUMER which has access only bulkQueryPoints API, but not the raw data in the project data model.

  • Implement basic credit counting system for bulkQueryPoints, so Admins can charge LOCATION_API_CONSUMER accordingly by usage of bulkQueryPoints.

Stories builder

  • Bugfix: Authentication error when coming back to UI after some time.

  • Bugfix: Stale values in global filters in editor.

Data Marketplace

  • Add filtering datasets in left menu by For sale/Not for sale field.

  • Bugfix: Filtering dataset with multiple values. (e.g. when dataset is available in multiple countries)

  • Redesign of Data Marketplace.

    Screenshot from 2024-03-01 13-43-00.png



  • Bugfix: Closing of share view modal via cross icon

  • Bugfix: Hiding map while changing base layer

  • Bugfix: Ordering of map layers

  • Bugfix: Allow to compute categories while are under half-width indicator

  • Bugfix: Keep authenticated session while moving between projectc with anonymous access

  • Bugfix: Scrolling in data model

Semantic layer

  • Implement new bulkPointQuery REST API endpoint - more in API documentation

  • Improve of JSON schema validation with nullable array elements

  • Add s3 configuration attributes to DataPullRequest + update API documentation on how to use PULL CSV from S3 or HTTPS URL



  • Upgrade okta-sdk to fix CVE-2022-45688

  • Upgrade Amazon AMI for EKS nodes fixes CVE-2022-22822, CVE-2022-22823, CVE-2022-22824

  • Upgrade PostgreSQL RDS 15.2 -> 15.5

  • Upgrade client images in k8s to be PSA restricted level compliant

  • Upgrade to spring-boot 3.1.x



  • Add possibility to open selected location in Google Earth via map context menu.

  • Prepare Studio to cloud-agnostic deployment. Main configuration is loaded externally from a file.

  • Continue working on new map experience. Stay tuned.

  • Bugfix: Buggy scrolling of sidebar in data model

  • Bugfix: Showing annotations in timeseries block.

  • Improve debug capabilities. Deploy our sourcemaps to Sentry tool.

  • Improve maintainability and security. Migrate upload dataset and edit indicator modals to React framework.

Stories builder

  • When user has insufficient permissions or story does not exists, user see an explanatory message and is redirected to stories list

  • Scroll text and fix embedded map when text is longer then map height.

  • Remove visibility settings. Visibility tool was removed from Studio.

  • Bugfix: fractional numbers in range filter

Semantic layer

  • Getting ready for Cloud agnostic deployment. Replace AWS SQS for RabbitMQ.

  • Provide project & organization title for auditlog records

  • Update version of Spring boot



  • Bugfix: Using anonymous access logs out user in other browser window.

Stories builder

  • Bugfix: Adding filter in Studio embedded in Stories builder with same filter with no value.

Semantic layer

  • Bugfix: Numeric IDs in Full text search

  • Upgrade AWS S3 SDK to version 2

  • Implementation of RabbitMQ



  • Remove deprecated login and sign up via Facebook

  • Improve performance of views where ranking is used

  • Upgrade our codebase to React 18.2 (currently the newest React version)

  • Migrate Edit project modal to modern React framework

  • Remove page informing Internet Explorer is not supported.

  • New map experience (builded on top of MapGL) Stay tuned.

    • Map can have unlimited number of layers of arbitrary type

    • Map objects can have a tooltip

    • You can filter directly by clicking on objects in a map, search and ranking

  • Bugfixes

    • Fix loading project with more than 2000+ metadata object

    • Fix exporting from ranking when fitness is disabled

    • Fix other minor bugs

    • Fix setting distribution of objects by indicator

    • Fix empty JSON metadata editor

Stories builder

  • Bugfixes

    • Fix situation when filter is stuck in disabled state

    • Fix filters with more than 200+ values

    • Fix setting filters from Studio when there is no value present in Stories builder

Semantic layer

  • Prepare layer to log Computation time by given feature (e.g. for queries from Studio)

  • Metadata now accepts placeholder $projectId in references to other metadata obejcts and translates it to current project id

  • Bugfixes

    • Fix audit log records with cache_uri

    • Fix queries with complex split properties (used in some Studio categories blocks)

  • Security fix CVE-2022-45688



  • Remove fallback page for Internet Explorer

  • We use metric references in queries to know how much Computation time each metric consumed.

  • We are working on new map experience (builded on top of MapGL). Stay tuned.

  • Bugfixes

    • Fix reported minor technical bugs.

    • Fix visualized indicator with N/A value.

Semantic layer

  • Logging of Computation time by metric and user granularity. So we know how much individual users and metrics consume.

  • Migrate ElasticSeach client to OpenSearch client

  • Make sending failed stream-binder-kinesis records to DLQ more robust

  • Bugfixes

    • Missing eventType in intercom events in OpenSearch

    • Fix computing queries with metric reference in Overlaps endpoint

  • We released Shell version 2.0.0. See release notes here:



  • Distribution / Histogram / Indicator filter improved interaction (filtering the data) with breaks

  • New Templates and Demo projects page with featured use cases and categorized content

  • Full width Edit JSON modal (Edit / View Metric, Dashboard, View and Map JSON)

  • Moved Layer settings and Edit map JSON (only displayed, when project has been migrated already), added minimize legend functionaity

  • Bugfixes:

    • Fix project list blank page (cased by h3_grid dataset without dwh dataset reference)

    • Map tooltip title and subtitle are missing

    • Fixes linked layers bug

    • User can not scroll to whole compare content

Semantic layer

  • The views.defaultTools metadata key no longer supports the visibility value. Valid values are: [search, filter, measure].

  • All microservices were migrated to Spring Boot 3.x

  • We tuned CPU usage in the Kubernetes cluster to improve HTTP response times.



  • Add possibility to disable fitness values in a whole view trough disableFitness view setting. It may significantly reduce computation time which may reduce costs and improve performance.

  • Remove visibility tool and move its settings to map legend.

  • Bugfix: editing of categories block

  • Bugfix: Saving/sharing of visualization of categories block

  • Bugfix: Saving/sharing of collapsed state of dashboard and drill blocks

  • Beginning of reimplementing our map to WebGL (for now inaccessible to regular users)



  • Add validation for max 1 visualized categories block in dashboard

  • Bugfix: Setting of exact value in indicator filter.

  • Bugfix: Czech translation in Data model.

Semantic layer

  • Added new Map and Attribute metadata. So far they have no effect on projects. But it is a first step towards new refactored map experience

Stories builder

  • Bugfix: Redirect back to Story when it user opens link to the Story but is forced to log in first.

  • Bugfix: Reset filter in a when user reset the filter in embedded Studio map.



  • Admins and editors has possibility to save (overwrite) state of view trough UI.

  • We moved base map selector to a map legend.

  • We moved markers and their visibility controls from visibility tool to legend. (We plan to replace visibility tool by legend entirely)

  • Bugfix: visualizating categories without fixed indicator while switching indicators.

  • Bugfix: Edit categories on indicator drillu.


  • Split documentaiton between: Data Marketplace, Data Toolktit, Semantic layer, Studio and Stories builder.

  • New overview, Main concept and other articles

  • Stories builder tutorial

Semantic layer

  • Bugfix: Not prepared FilterByAttribute for nested metric

  • Bugfix: KBC Writer crashes

  • Bugfix: Uploading of datasets



  • Page opened by clicking button from project description opens in new browser tab

  • Bugfix: Order of granularities from different origins in granularity map layer

  • Bugfix: Visualize of categories block without indicator

Semantic layer

  • Bugfix: Not prepared FilterByAttribute for nested metric

Stories builder

  • New filter type - Multiselect with search



  • Map tooltip for linked layers with title and subtitle

  • We add new access permission role called “Data editor“. It is for users who are not allowed to edit project metadata but are allowed uploads new data to the project. We also renamed original “Editor“ role to “Metadata editor“ to better distinguish with new one. (see overview of all roles and their permissions here: )

  • Time series block has Y axis and new fresh tooltip.

  • Add posibility to change export filename and prefill it with currently selected object.

  • Added UI switch for view visibility (Project vs. Personal) to clone view, save as view and edit view modal dialogs.

  • Deprecated bookmarks functionality was removed. Please use Save as… and Personal views instead.

  • Add support for h3Grid over basic datasets with materialized column with h3Grid ID.

  • Bugfix: Default order of items in ranking and categories block (they did not repsect metadata setting)

  • Bugfix: Automatic refreshing of auth session (it caused not loading data on UI)

  • Bugfix: Cloning project from organization page

  • Bugfix: Visual bugs with empty dashboards and scrolling

  • Bugfix: Filtering h3grid from distribution and legend.

  • Bugfix: Visualize categories by default when it is set in metadata.

Semantic layer

  • Remove unused required parametr filename in REST API export endpoint.

  • Deprecated bookmarks functionality was removed. Please use Save as… and Personal views instead.

  • Bugfix: Cache invalidation for metric expansion (causing returning old invlaid data)

  • Bugfix: Fix forbidden description property in indicatorGroup


  • Added support for new role “Data editor“

  • Fixed defaultViews links in projectSettings when importing project

  • Added check in loadCsv for file, s3Uri, url - only one can be specified

  • Fixed links to new documentation

  • Added replacing of dataset names in other metadata objects when renaming dataset

  • Added support for adding of prefix to property identifiers when importing project

  • Added renaming of references to h3Grid dataset in other datasets

Stories builder

  • Allows to hide infopanel and other elements and edit theme of a map.

  • Add support for numbers and null values in filters

  • Bugfix: Filters affect embedded maps which should not be affected

  • Bugfix: Edit and delete stories buttons were shown to users with viewer role.

  • Bugfix: Do not allow to see stories for disabled users.

  • Bugfix: No need to set trusted origin for in project setting.



  • Users with role ADMIN, EDITOR are able to clone views (VIEW_CREATOR is able to clone its personal saved views)

  • We extended indicator filter histogram with segments. It means you now can interact with indicator filter the same way as distribution block on dashboard.

  • Visual and interaction improvements in User management page.

  • We increased timeout of exports from 2 to 10 minutes to support big data exports.

  • Bugfix: Incorrect indicator values in categories block when followed with indicator filter.

  • Bugfix: projects with multiSelect filter default values equal to [null] fails to load.

Stories builder

  • Implement full two-way communication between Story filter and in-app filter. Both beside-map filter and top-level filters works. Means all filters are correctly synchronized as expected.

  • Bugfix: Disabled members does not see project stories in list.



  • Views can be deleted directly from UI (both default and personal).

  • Bookmark functionality has been deprecated in favor of Save as.. and will be deleted soon.

  • Categories filtering is now synchronized with standard filters. Sometimes it is referenced as migrate categories soft filters to hard filters.

  • New user role VIEW_CREATOR has been added

    • VIEW_CREATOR is somewhere between EDITOR and VIEWER.

    • It is allowed to do all the things VIEWER can and in addition to that create and delete its own views. It means Save as… feature is available to the role.

  • We have launched new documentation at (you probably looking at it right now). Please update your saved links.

    • We've deprecated old documentation site and updated all known links pointing to it.

  • Fix filtering of empty string values within multi-select filter.

Stories Builder

  • We have released beta version of Stories Builder at

  • We fixed automatic logout after 2 hours of activity

  • Add first version of two-way communication between Story filter and in-app filter. For now only filters beside map view works.

  • Fix radio buttons filtering.

  • Limit add, edit and remove project stories to only ADMIN, EDITOR and VIEW_CREATOR roles. So VIEWER can now only safely view created stories.


New features and improvements

  • Introducing new kind of map view called Personal saved view. In contrast to standard Project-wide view it is displayed to on project page its creator only. It is still accessible to all project members via link though.

    • Add new property defaultViews in projectSettings metadata. All map Project-wide views meant for all project members must be included there. Otherwise view is considered as Saved personal view.

    • CODE
          "name": "project_settings_template",
          "type": "projectSettings",
          "content": {
              "defaultViews": [
  • Add functionaliy Save as … to create Personal saved view including map and dashboard state.

    • Save as … functionality is accessible only for ADMIN and EDITOR members.

    • In contrast with share and bookmark functionality persisted state is reliable and is not damaged when original map view metadata is updated.

  • Allows to view and edit map view metadata JSON on UI. Only ADMIN and EDITOR roles are allowed to edit.

  • block.onDashboard functionality was removed after beeing deprecated for several months. Use blocks directly on dashboard instead.

  • * domain and all subdomains are allowed as Trusted origin of project by default.


  • Fixes histogram labels (e.g. incorrectly mixed less than and less or equal than).

  • Fixes categories editation on UI.

  • Fixes showing indicator values in public projects.

  • Fixes importProject error Specific key does not exist. Among other things, it fixes cloning of projects on UI.

  • Fixes failing dwh queries caused by too long property ids.

  • Fixes displaying of blocks within indicator group.

  • Fixes order of number attribute values in multiselect filter, column and bar chart.


New features and improvements

  • All drill blocks can be put under indicator directly on dashboard

  • Drill blocks under indicator can be collapsed like rest of blocks

  • Metadata migration of drill block with onDashboard to drill blocks directly on dashboard under indicator

    • (warning) block.onDashboard functionality is considered deprecated and will be deleted soon. Do not use it anymore. Use blocks directly on dashboard.

  • Viewer can show metric and dashboard metadata JSON definition

  • Improved condensed categories block

  • New dual categories block with more than one distinct attributes



  • Fix duplicated property ids in dwh queries which app constructed

  • Fix app freeze in infinite loop when adding a pinpoint to compare

  • Use reversed metric in categories values on drill in Arrival/Departure view

  • Fix collapse of distribution block

  • Show ranking even if loading of ranking item fitness fails


New features and improvements

  • Allows to place Distribution, Categories, Time series and Ranking blocks directly on dashboard.

  • Allows to customize invitation outgoing email address per organization. We also whitelabel invitation email content to does not include CleverMaps identity.

  • Allows to edit disabled indicator (when indicator is not able to be visualized on selected granularity).

  • Improved cloned indicator, metric and drill naming to fix occuring errors (leading letter, name length, name already exists).

  • Adds activity panel in project detail for admins only.


  • Let iframe publish data about filters via the js message api. So parent page can listen on filter changes.

  • Let a parent apge open bookmark modal, export modal and execute fit map functionality within iframe.

  • Allows to creates overlay (for better scrolling experience).

  • Allows to add full screen button in iframe.

  • Allows to hide dashboard panel and map tool buttons.

  • Allows to change primary color and loading logo in map view. In other words it allows to whitelable map view to look&feel like part of your company brand.


  • Fixes dashboard JSON editor which didn't accept two indicator blocs in a row inside indicator group.

  • Fixes dashboard JSON editor which didn't accept datasetProperties and featureAttributes.



  • Arrivals/Departures views now works properly

  • InAttribute performance optimalization does not work with max_function


New features and improvements

  • User can clone indicator on UI

    • After the edit dashboard feature we announced last time, we added the option to clone and edit an indicator directly from the UI. This allows you to add any number of indicators to your project without launching a command line.

  • Granaluarities/vizualizations are sorted like in GIS (markers, points, line, delivery zones, areas, grid, heatmap)

  • Filter reset button is now icon (was icon and text)

  • Add color (dark blue) when hovering over link on dashboard.

  • REST API support an optional strict mode

    • clients of our REST API can used a new header parameter X-CAN-STRICT-JSON-VALIDATION=true to enable a strict restriction of JSON payloads. The payload will be rejected if it contains any unknown JSON keys. This is useful mainly for development. The default REST API behavior is that the unknown key is ignored and not stored on backend.

Shell Release

This release of CleverMaps Shell has completed the addition of the new feature GIT versioning support for metadata. The last missing feature was a command restoreMetadata.

Read more about project versioning in the new Tutorial 11.


  • Added restoreMetadata command for restoring older versions of metadata objects.

  • Fixed Bad Request when completing multipart upload in loadCsv.

  • Added strict mode for validating additional properties in MD objects.


  • Let a client open bookmark and export modal and fit map via the sdk library.

Platform Security

We are thrilled to share that CleverMaps has accomplished its SOC 2 Type II and ISO 27001 certifications!

The SOC 2 Type II and the CleverMaps' ISO 27001 certifications only emphasize our commitment to protecting our customer's data and facilitating a safe and secure Location Intelligence ecosystem.

Learn more about our security measures in this blog post.

In addition, the CleverMaps platform successfully passed external penetration tests in August 2022 with only a few minor findings.


  • Fix of missing geo search marker in map

  • GPS result circle stays on the map

  • Unable to authenticate to CleverMaps stories

  • Unable to navigate through views with share link


New features and improvements

  • Edit a dashboard from UI

    • We added a feature to edit the JSON dashboard definition directly from the UI.

    • To edit a dashboard click on right menu in dashboard header

  • Redesigned visualization/granularity component

    • We have simplified the design of component for selecting visualization and granularity. User can now see all available visualizations and granularities.

Shell Release

We have released a new version 1.5.5 of CLI tool CleverMaps Shell that changed the directory structure of dumps.

We made these changes to allow the CleverMaps Shell to be used with GIT to version metadata.


  • Changed dump structure. Removed dumpIds. Now there is only one dump per project.

  • Changed dumpProject --force. It now overwrites existing dump.

  • Added dumpProject --ignoreFailedDatasets. It skips failed datasets dumps.

  • Share metadata objects are no longer dumped.

  • Removed --directory from dumpProject.

  • openProject now opens dump if it exists.

  • Removed --dump from openDump.

  • Removed --directory from openDump.

  • dumpCsv now doesn't create new dump.

  • Added dumpCsv --force. It overwrites current dataset data dump.

  • importProject --dump is now boolean option (previously required dumpId).

  • importProject --dump now also requires --project.

  • importDatabase now doesn't create new dump.

  • Removed listDumps command.


  • Fix of missing geo search for markers and search by GPS coordinates

  • Increased maximum number of attribute values in MultiSelect filter to 20000

  • Fix duplicate marker icon when selecting a marker from the map.


New features and improvements

  • Redesigned share/bookmark functionality

    • We have refactored life cycle of share objects and bookmarks. Share link stores a user state of a view. In previous version, we have tried to keep share links working although the parent view object has been changed. Now the share links are valid until any change in correspondent view is made. When you or the administrator change any metadata of the corresponding view, all related share links become invalid. This will lead to simpler and more predictable behavior of share links. For more information see Help Center or Shares (Developer documentation).

    • If the share object is invalidated, the user is informed by a message: “The link you followed is broken, no longer valid or inaccessible due to insufficient rights.”

    • The share objects are now immutable so there is no need to dump them by CleverMaps Shell.

  • Allows to show relative values in both categories and map tooltip


  • Some categories are missing in map tooltip when visualized and some feature is selected

  • Heatmap - select marker loop

  • Markers not enlarge on map objects selection

  • Organization selector is not working correctly while cloning


New features and improvements

  • Improved filter functionality

    • Added Active Filters section where you can see all your active filters

    • Filters are displayed and applied in the order they were added, meaning filters on a higher level apply to the ones beneath them. This rule applies to indicator filters.

    • The order of filters can be changed from the UI

For more information about filters, visit the CleverMaps help center.


New features and improvements

  • Ranking with millions of rows

    • Ranking block has been migrated to React, allowing to show millions of records.

  • New REST API for access audit log records

    • A new REST API endpoint /rest/auditlog was released to support programmatic access to CleverMaps platform audit log records. The API is designed primarily for enterprise customers and enables integration with SIEM systems.

    • See REST API documentation for more details:

  • Let nested organization button leads to the organization

    • Click on a organization name does not open the list of organizations but return user back to list of projects.

    • Clicking on “CM DEMO” button returns user immediately back on list of projects


  • Long text shifts button visualize over the sub-menu icons

  • Fixed bug of showing a dot map visualization

  • Fixed second step of sign-up form


New features and improvements

  • Add organization selector in project cloning modal dialog

Clone project dialog allow to set target organization for a cloned project

  • Performance optimization for computing with wide tables

    • If possible, cross joined attribute tables are filtered by bounding box to improve performance.


  • Fixed selection of markers with non-computable metrics

  • Date filter selector is cropped because of overflow

  • Fix spatial query on marker

  • Edit categories sorting radio input is not working

  • Fixed error in My Projects for new user without any project

  • Fixed style sheets for Internet explorer page

  • Fixed freezing of zoom in/out buttons

  • Markers not enlarge on map objects selection


New features and improvements

  • Released new organizations menu and breadcrumb navigation on project list

  • Organizations menu has been moved on the left site

    New breadcrumb navigation for listing projects in an organization

  • Performance improvements for granularities with millions of objects

    • The performance of the map tooltip has been improved by adding filters to calculate data only for current bounding box.

    • Maximal report size is now limited to 100 000 items for HASH cache type

    • Fixed bounding box filter calculation after granularity switch


  • Fixed problem with downloading sample data from projects created from a template

  • Categories block does not react on color changes from editation

  • Fixed issues with no indicator value when map object selected


New features and improvements

  • UI improvements of a Project list page

    • Unified a top bar for All Items, My Projects and Template and Demo Projects

    • Moved Search bar

  • Set dynamic colors in categories

    • Dynamic colors as set a default colors when switching off the dynamic model


  • MetricValuesDistribution endpoint does not handle properly metric references.

    • Example: offline_turnover_ratio_metric that reuses two already defined metrics:

    • CODE
          "name": "offline_turnover_ratio_metric",
          "type": "metric",
          "content": {
              "type": "function_divide",
              "content": [
                      "type": "metric",
                      "metric": "/rest/projects/$projectId/md/metrics?name=offline_turnover_metric"
                      "type": "metric",
                      "metric": "/rest/projects/$projectId/md/metrics?name=turnover_metric"
  • Improved DWH Query engine to process multiple nested inAttribute filters.

Shell Release

We have released a new version 1.5.2 of CLI tool CleverMaps Shell.


  • Fixed importProject --prefix that overrides metadata objects

  • Added support for metric references

  • Reviewed help messages for all commands

  • Removed command alias import, use importProject command instead

  • Added a new command cloneProject for server-side project clonning

Download the new version here.


New features and improvements

  • Allows to set categories colors from UI

    • Users can set a custom colors for each attribute values on UI

    • A same color can be now set to multiple attribute values

      Choose Edit Block in right menu of Categories

      Set a custom color for each attribute value

  • Added searching bar in modal of editing categories block

    • User can use full text search for find attributes in data model when editing Categories block.


  • Fixes long project titles wrapping in left menu

  • Markers were not properly showed on map during the first map load


New features and improvements

  • Faster loading of data into the map

    • map data is displayed immediately after loading the visualized indicator

    • map popup data is loaded on-the-fly when user hover on map area or marker

  • Added static thumbnail images for demo and template projects

  • Export data from rankings block

    • this feature is enabled by default for all ranking blocks

    • export contains all properties of ranked granularity dataset


  • rebase of shareLinks throws Missing field exception in cloned projects

  • update of projectSettings.geoSearchCountries was fixed to accept empty set of countries


New features and improvements

  • Markdown syntax is now supported for a project description

    • A simple way to format text of descriptions in CleverMaps platform.

    • supported features: Markdown reference

  • Global date filter behaviour and design has been aligned with the attribute filters

    • blue highlight when a custom filter value is set

    • reset button on hover

  • Bookmarks

    • All users can create their own custom bookmarks for a specific map.

    • Bookmark persists complete user settings including map position, selected objects, attribute and fact filters and selected tools.

Minor bugfixes

  • Dataset is not evaluated as an orphan object when it is referenced by a MarkerSelector

  • ImportProject with prefix overrides metadata objects


New features and improvements

  • Keboola Writer supports authentication by user’s Access Token. Email/password authentication has been set as obsolete.

  • Advanced setting for import CSV. User can choose a seperator for CSV file and upload CSV files without a header row.

  • Settings for Categories block was extended of these options on UI:

    • User can change a dataset attribute for categories split

    • Change order of attribute values

      • Order by attribute values (alphabetical):

      • Or order by another attribute. This allows to order attribute values in a natural order (e.g.: days in week, age categories or stage of oportunities)

      • In both cases, user can select ascending or descending sorting and limit the maximum number of attribute values.

  • Edit indicator scale breakpoints. Set a custom static breakpoints for indicator per granularity:

Minor fixes

  • Fixed Overlaps in heatmap compare (eg. exposure index metric)

  • Unlimited XLS exports

  • Removes Slovak localization


New features and improvements

  • Enable address filter to search with Mapbox service.

  • Implemented login using generated access token in Shell and allow all users to generate refresh token2020-04-06

  • Redesign attributes block

  • Enhance map loading

  • Show inactive non default filters in toolbar counter.

  • Allow to use metrics in metric metadata definition

  • Push filters to CleverMaps IFrame

  • Added new DWH query function function_percent_to_total

Minor fixes

  • Fixed wrong order orphan metadata removal in Shell (removeMetadata --orphanObjects).

  • Fixes scrolling on dashboard. It is not possible to scroll completely down because of badly set infobox height.

  • Fixes selecting features in filter

  • Registration failed

  • Fixed cloning of projects when executed in parallel.

Other (internal)

  • Remove deprecated username and password URL parameters from IFrame


New features and improvements

  • Extended Export with option to select export file format.

  • Added Edit Project functionality.

  • Added quick menu with Share and Export links to the info box.

  • Extended Search with GPS coordinates search.

  • Changed marker references in marker selector from name to link.

  • Extended export object metadata with default output type, file format, custom filename and header format.

  • Implemented cascade import in Shell (importProject --cascadeFrom).

  • Implemented orphan metadata removal in Shell (removeMetadata --orphanObjects).

  • Added ability to load data from any HTTPS URL to Shell (loadCsv --url).

Minor fixes

  • Fixed problem with returning partial query results (e.g. H3 grid queries with lot of results).

  • Fixed Data Preview and CleverMaps Stories on Safari browsers.

  • Project List adjustments:

    • Clickable project title.

    • Template buttons aligned to right.

    • Display project skeletons instead of throwing error when opening organization with no projects.

    • Shows disabled projects on project list.

    • Slow scrolling on touchpad.

    • User always lands on project list after logging in.

  • Fixed DWH validate command comparing 'character' and 'char' SQL types as not equal.

  • Improved geosearch in Germany, fixed highlighting and some other bugs.

  • Fixed project title not showing when Clone project fails.

  • Fixed “current transaction is aborted” error when using dumpProject --force.

  • Fixed indicator filters in Branch Network Reporting Demo.

  • Fixed ranking block on dashboard ignoring dontAgregateBy.


New features and improvements

  • Added new Project list.

  • Enabled Compare functionality on heatmap visualization. Redesigned dominance and overlap flow in Compare.

  • Added new Filter toolbar for better user experience.

  • Implemented support for H3 grid with materialized columns. This use case fits when the performance of regular H3 grid is not sufficient (for more info, contact us at

  • Added --s3Uri parameter to loadCsv command, which allows you to upload CSV files directly from AWS S3 to CleverMaps.

  • Implemented more robust share links.

    • Intelligent JSON array rebase (it’s now possible to move view filters or indicator drill blocks up/down in the array without breaking existing shares).

    • Share objects no longer store the changes in JSON objects. It’s easier to rebase them when the change applies to one string, integer, number, or boolean value. (see documentation).

    • Removed rendundant share object properties (“/etag“, “/content/blocks/0/id“).

Minor fixes

  • Export function is no longer adding indicators from indicator filters to the exported file.

  • Fixed Compare ignoring dominance with defaultVisualized indicator.

  • Removed limit of loading maximum 20 000 H3 grid polygons.

  • Fixed unsupported browser screen visible on the app loading page when on slow internet connection.

  • In case of geometryPoint datasets, the latitude and longitude properties had to be named “lat“ and “lng“. This is no longer required, you’re free to name them however you want.

  • Fixed vertical categories block not being editable from UI.

  • Null categories are displayed using the same color in categories block, map legend and map.


New features and improvements

  • Implemented native support of Uber H3 grid visualization (see documentation).

  • Exports are now defined per view - it’s required to configure which exports will be visible in which view. Current projects' metadata were migrated (see documentation).

  • Added Organization column to listProjects command output, added --organization parameter.

  • Added ability to dump and push Share objects which represent the state of the application persisted when using the Share function (see documentation). Available since Shell 1.4.5-RELEASE.

  • Improved performance of data preview in data model. Number of rows in the DWH query is limited to 1000.

  • Longitude and latitude columns of geometryPoint datasets must not be null.

Minor fixes

  • Fixed data upload task which failed with illegale state error.

  • Fixed highlight sticking when selecting and hovering areas/grid/lines.

  • deleteProject task does not fail when DWH/MD database does not exist.

  • listProjects does not show organizations of deleted projects.


New features and improvements

  • Added selector icon for switching base map layers. Details in developer documentation.

  • Show empty string values in both select filters and categories.

  • Improved performance of map and ranking block with many areas or lines.

  • Show tooltip on compare header hover.

  • Adds support to choose any hex color for qualitative visualization in metadata. See valueOptions.hexColor in Datasets documentation.

  • Implemented query.orderBy.nulls for specifing sort of null values (=“last”, “first”). Details in developer documentation.

  • Initial support of organizations. Each project can belong to an organization which is uniquely identified by its ID. Extended Shell createProject and editProject commands to assign projects to organizations.

  • Extended /shares API - it's possible to dump, push and delete Share objects like any other metadata object.

  • Added new applyDiff command, which allows you to create a metadata diff between to live projects, and apply this diff to a Shell dump. Details in developer documentation.

Minor fixes

  • Fixes in in share links:

    • Spatial query

    • Collapsed/expanded state of indicator groups and blocks

  • Improved character limit counter behaviour in Edit indicator.

  • Fixed bug when indicators in groups does not show second value in Compare.

  • Fixed project page background on disabled projects.

  • Fixed bug in tooltip for multiple records at the same location.

  • Fixed issue with sending an email invitation to email address containing character '+'.


New features and improvements

  • Finalization of in-memory caching - all queries in the app are now cached. The old synchronous endpoint was disabled.

  • Extended Edit indicator dialogue with visualization and scale settings.

  • Support of multiple dots at the same location. This can occur when two or more dots have the same latitude and longitude when using the dotmap visualization. After hovering the dot, all records are displayed and it’s possible to drill on each one of them.

  • Links in featureAttributes are now being shortened to the hostname.

  • It’s possible to open the app in a new tab using Ctrl (Cmd) + left click on the Project page button.

  • Google Maps and Google Streetview are the default options when using Ctrl (Cmd) + right click in the map.

  • Increase character limits while editing indicators, blocks and views on UI. Each Title can be long up to 150 characters, and Description to 1500.

  • Use modern browser message is displayed to users which open the app in unsupported browsers.

Minor fixes

  • Fixed failing geosearch queries which contained slash (e.g. address “Brno Lidická 1869/28”).

  • Fixed ordering of vertical categories. Null values are not specified as the last value, which is consistent with regular categories.

  • Disabled automatic translation of the app page in Chrome browser.

  • Error messages of failed queries are now propagated to the client - ie. to the broswer developer console.

  • Fixed error when creating a share link, while someone already updated some of the view’s metadata in the meanwhile.

  • Fixed bug with editing an indicator which is used in multiple views using Edit indicator.

  • Improved Clone project feature on UI which failed on expired authentication token (The token is always renewed when cloning or deleting a project).

  • Improved dotmap performance when rendering a lot of dots and hovering over them.


New features and improvements

  • Allowed to use one metric property in inAttribute filter. The value of this metric (typically min or max) will be joined with the parent main dwh query. This allows filtering last dates for KPI use-case. See the examples starting with filter_by_metric in Metrics cheatsheet.

  • Added ability to set a precise value in isoline and metric variables.

  • The active indicator value is shown on the map for each polygon. This option can be turned on/off in the Visibility tool, and showIndicatorValuesOnMap in marker selector metadata.

  • Enabled editing indicator title, description and format values. Please note that this feature is only available to project editors and administrators.

Minor fixes

  • Fixed serialization of dates as timestamps (e.g. 1602483514) for in-memory caching queries.

  • Fixed globalDate filter overflow - when there were too many years available.

  • Fixed bug when cached dwh queries still remained in the project after truncateProject. As a result, incorrect query results were shown even after full data upload.

  • Fixed bug when selecting some categories and the metrics were not computed correctly.

  • Do not append zero values to the end of chart in vertical categories.

  • Fixed failing metrics with variables in Compare.

  • Fixed format of line Measure - too many digits after decimal point were shown.

  • Improved meta tag content. When sharing a link to CleverMaps, and link preview was generated, “can“ title was shown. Now, the title says “CleverMaps”.

  • Fixed broken layout of vertical categories with negative values.


New features and improvements

  • New visuals of blocks on Dashboard

    • The “disabled” filter functionality was removed. Users can “select all” values with standard UI tools to disable data filtering.

  • Now it’s possible to edit Block title and description on UI if the Block has some of these properties.

  • It is possible to disable full-text search on the dataset - useful for datasets with generated IDs, like grids. Can be disabled using the fullTextSearch property in Datasets.

  • Map in view is centred according to data if mapOptions doesn't specify the exact centre and zoom.

    • This is useful for Templates, where users can upload their own data from any location and immediately see their views centred appropriately.

    • Default Czech settings were removed.

Minor fixes

  • The data preview button is easier to find.

  • Switch to heatmap visualization forces to turn off qualitative categories visualization.

    • User does not have to turn off qualitative categories visualization to go to the heatmap.

  • Cloning projects on UI was improved:

    • It should now handle big sized projects.

    • When the cloning fails, a proper error message is displayed.

  • The spatial query can be configured to set more precise distances.


New features and improvements

  • View title and description can be edited on Project page UI. It is available for Administrators and Editors of the current project.

  • Indicator with Block can be used inside Indicator group. Standard on dashboard metadata property is used to turn on this feature.

  • Spatial query headers display all selected coordinates if more than one coordinate is selected.

  • Data in the map are loaded only for active Indicators and Indicator groups. Indicators from collapsed Indicator groups are ignored.

    • Breaking change: Visibility of objects in the map now depends on active Indicators, previously all Indicators from Dashboard were taken into account.

    • This can significantly improve the performance of map layers if there is a lot of Indicator groups on Dashboard.

Minor fixes and improvements

  • Collapsed state of blocks is saved for Sharing.

  • “Eye icons” in the Visibility panel were replaced with the Show/Hide tool.

  • Improved positioning of large map tooltips. The whole view height is used to display tall tooltips.


New features and improvements

  • Created new variation of Categories block called Column chart. Can be turned on by vertical property (See Indicator drills ).

    • These are useful for visualization of some trend-like data (days of week, months of year...).

  • Improved internal processing of metrics with attributes

    • Better performance of these metrics

    • Fixed duplicated rows with null values in Export

  • Users can select multiple custom locations in the heatmap and combine spatial queries.

  • Spatial query configuration in header is always visible when it's available.

  • Enabled sorting of categories on UI.

    • Users can switch order of Categories by value or by some default (ie. alphabetically).

Minor fixes and improvements

  • Fixed hideNullItems in Categories when the indicator was formatted as percentage.

  • Better error message when user doesn’t have sufficient access rights in Shell. (E.g.: dumping data from demo).

  • Optimized reloading of granularity layer.

    • Layer is not repainted/reloaded when some feature from the same layer is selected.


New features and improvements

Spatial query

  • User can set distance and different types of coordinate spatial query (air, walk, bike, car) in the heatmap.

  • Detailed description is in the article How to understand Heatmap in our Help center

  • Default radius (distance) and type can be set up in Views metadata, see spatialQuery configuration.


  • Attributes can be available on Indicator drills

    • set up in Views metadata

    • select object with indicator allows you then to see all attributes in the bottom of dashboard (it is not possible to set up the order of indicators, blocks and attributes

Categories can limit number of displayed items

  • It is possible to limit the number of categories in Categories block. Other categories are displayed together as Other.

Modified map URLs

  • Selected objects and indicator drills are not updated in the URL. Use Share function instead to create links to any map state.

  • This brings improved performance and smoother transitions when user selects any objects on the map.

Clone project

  • User with role administrator is allowed to clone project directly from Project list.

Authentication with custom Identity Provider

  • It is possible to set up any company’s Identity provider to be used for logging to our platform. Discuss it with our support if you’re interested.

Minor fixes and improvements

  • Fixed scrollbar in filter dropdown in Data model preview.

    • all of the columns will fit on the view if there are many of them

  • Qualitative visualization use stripe pattern to visualize first N categories with the same value.

    • Formerly, one from the first N was used randomly as the top category for visualization.


New features and improvements

  • Open location in 3rd party app

    • Google Satellite, Google StreetView, Ortophoto, Panorama, ČÚZK Parcel Informations

    • Open context menu with right click anywhere in the map. It is not available by default - has to be set up in metadata.

    • See it in action in Exposure Index Demo.

  • Business user can create project from Template and load own data.

    • Templates are our simplified projects targeting some specific use-case

  • Alphabet symbols are available as symbols inside markers.

    • It brings another way to differentiate between many marker types.

    • Details and pictures can be found in Markers documentation.

  • Enabled travel time selection of Marker or Dotmap objects.

    • Measure tool Isolines were enhanced with selection functionality for point datasets - available automatically.

    • Selection is currently limited to 500 objects

  • Lines can be styled with color, weight and pattern without Categories with Indicator, only by data attribute.

  • Update width of lines proportionally according to map zoom

    • Improves readability and interaction with line visualization.

  • Dotmap layer is able to display accuracy circle for any dot when you hover over it.

    • Useful to display mobile data accuracy etc.

    • See the featureAccuracy metadata in Datasets documentation.

  • User with role administrator can delete project directly from Project list page.

    • It's easier to remove outdated or test projects that are no longer needed.

  • It’s possible to display dataset featureAttributes on indicator drill

    • See the metadata in Views (showAttributesOnDrill property)

Minor fixes and improvements

  • Export support indicators with same title

  • Improved menus on Project list page and added Help menu to Project page


New features and improvements

  • Added new localization – Slovak

  • Upload CSV data button in Data model Dataset view available for project Administrators.

    • Each dataset data can be uploaded from UI, if user has correctly formatted CSV file.

  • Improved filters in Data Model – enabled filtering NULL values and empty strings.

  • Demo projects have new Template banner with call to action button “Contact us”.

  • Single select filter (Views)

  • Selections from Ranking

  • 3rd party map links (Views)

    • Available services: Google Satellite, Google StreetView, Ortophoto, Panorama, Czech Cadastre Parcel Info.

    • Right-click on any position on the map and open this place in 3rd party map.

Minor fixes

  • Unified Reset all filters and Reset to defaults labels. (The label now says "Reset all filters to defaults".)

  • Fixed MultiSelect filter label in header.

  • Fixed Reset to defaults for Variables.

  • Fixed interaction with Benchmarks in TimeSeries. Dropdown list with Benchmarks was trimmed if it was too long.


New features and improvements



  • Enabled quick reset of active Filters directly from map (in blue filters badge).


  • NULL values in histogram filter

    • Extra histogram column is visible only if filter property has some NULL values.

    • By default, nothing is filtered – all NULL value records are included.


  • Multipart Upload

    • enables to upload any size CSV file

    • not default, usage: specify --multipart parameter in loadCsv or pushProject commands

  • New shell command - setup. Allows user to setup config and credentials files with single command (without creating file system files).

    • Since 1.3.9-RELEASE

New metadata options

  • Default state of keepFiltered settings in the Visibility tool.

    • The defaults keep markers unfiltered and granularity filtered.

    • Setting filterable in Marker categories is now deprecated in favor of this new option.

    • Details can be found in Marker selectors metadata docs.

  • Default Object filters (normally added from map selection).

    • Add to docs

  • Default Time series period.

  • Default Compare type (Dominance or Overlap)

  • Default Measure tool state

    • Default Lines or Isolines panel

    • Default settings in panels (e.g. the default zone for Isolines measuring)

    • Details can be found in View metadata docs.

  • Default Ranking block state

  • Added hint to Indicator group header, fixed overflow.

    • It is easier to describe indicator group in more detail, just add the attribute description.

    • Details can be found in Dashboard metadata docs.

  • Default Distribution block state

    • Default range and breaks for standard dynamic distribution. It’s active on first load and reset when user changes filters, selects other objects etc.

    • staticOptions are not affected by other actions in view vs defaultDistribution breaks setting is affected by other actions in view


Minor fixes

  • Fixed definition of “default settings” and “filtered” in all filter types.

    • Reset always reverts filters to default setting

    • No badge on Filter icon only if nothing is filtered

    • Each filter is counted as “filtered”, if it basically filters something. If default setting filters some data, it is counted as well.

  • Fixed collapse/expand all blocks feature.

  • Save defaultTool (Search, Visibility, Measure…) for sharing, fixed loading if some feature is selected.


New features and improvements

Data model

  • We have improved user interaction with Data model schema. You can use it in similar way as you use our map – mouse scroll works for zooming in or out and dragging can be used to pan the schema.

  • Relations between datasets in the schema are interactive. In case you select or hover some dataset, all related links and datasets remain active, others are muted. It helps you find the relations in large data models.

  • There is a new block Data Load History on the detail of dataset. It is available for administrators of the project. This gives you quick summary of all data modifications in the project. You can see when it happened and who made the change.

    Date of load, time, type (Incremental or Full), count of records added, total count of records, user (details on hover)

  • You can preview the content of your datasets in with Data preview feature. You can enter this preview in dataset detail in the bottom of the Overview block.

    It is possible to sort the records by any column, filter records by property value with equality operator or easily go to linked datasets by clicking on blue key icon. It is useful for checking that your data load was successful or checking the geometry columns if you don’t see your data in the map.


  • CleverMaps has completed map legend. It displays not only standard visualization legend, but also markers and qualitative color scales, if it’s turned on. All of that works automatically without any metadata changes.

  • All types of map objects are divided into individual sections, you can collapse each of them or all.

  • Qualitative visualization legend is interactive like standard visualization legend – hover any object to highlight features in the map that has selected quality.

Block Dominance

  • Compare tool was completed with block Dominance

  • Indicators that have enabled Dominance option have its drill completed with this block automatically.

  • It is useful to find out how the indicator value is distributed in catchment areas of two compared branches. You can hover the dominance categories to highlight it in the map.

Block with coordinates

  • New block in the Isolines tool.

  • Displays coordinates of selected point or marker in the map.

Yellow colour

  • Yellow colour was added to our colour palette.

  • It is available for markers and also for qualitative visualization.

  • Use it with caution, since it is similar with standard highlight colour.

  • Many colour scales where adjusted to represent yellow and highlight color as clearly as possible.

Dedicated DWH

  • CleverMaps platform has implemented support for Dedicated Data warehouses. This brings improved performance, isolation, scalability and availability for our customers.

  • Selected projects or customers can use dedicated, custom sized PostgreSQL cluster.

  • Hit us at if you would like to hear more details.

Performance optimization

  • Optimized loading of all filters in a view. It can significantly reduce initial map view loading time.

  • Rewritten marker layers loading and styling. It improves marker loading times, especially in views that use many types of markers for one marker category.

New metadata options

  • Added option to set filter to disabled state by default.

    • It can be useful to prepare some initial values of filter, but disable it by default.

    • Details can be found in View metadata docs.

  • Enabled setting of default Visualization

    • Visualization is set automatically if it’s only one possible visualization for dataset. For point datasets, it’s better to set defaultVisualization to decide if heatmap or dotmap should be used.

    • Details can be found in View metadata docs.

  • Enabled setting of default period in block Time series to days, weeks, months quarters or year.

  • Enabled setting of featureType, the default feature type in block Ranking. Set “featureType”: “granularity” or “featureType”: “markers”.

  • Enabled setting of direction in block Ranking to specify the order of features.

Minor fixes

  • Fixed null values handling in block Categories.

  • Fixed order of bars with null values in block Categories.

  • Fixed rectangular marker styles in Compare.

  • Fixed some Vector tiles loading issues in map (no blank tiles, improved world level zoom)

  • Fixed some issues with our onboarding Tour (missing popup, z-index…)

  • Fixed style of Missing attribute in Attribute block.

  • Fixed Date filter issue with 29th February.

  • Fixed benchmark dropdown height in block Time series.

  • Optimized query for loading count of records in Data model dataset

  • Fixed content of Exports list – it shows only available exports for current view.

  • Fixed downloading (dump) of large CSV files.

  • Fixed loading of interval counts in block Distribution.

  • Fixed invalid projectId in object references in metadata.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.