v2.0.0

umami-software/umamiv2.0.0Apr 17, 2023by mikecao

AI Summary

Major v2 release introducing Teams, clean URLs, page titles, and improved location tracking.

Key Highlights

  • Improved location tracking now includes city and region information
  • Clean URLs show path only, with query parameters in a separate section
  • Page titles are now recorded for every page
  • New Teams feature allows sharing websites without Share URLs

Breaking Changes

  • Requires data migration from v1 to v2
  • Underlying schema and libraries have been changed

New Features

  • City and Region tracking
  • Clean URLs
  • Page Titles
  • Teams
  • Redesigned Event Data
  • Lightweight Tracker
  • New Languages (Sinhala, Khmer, Swiss German)

Full Release Notes

## News

Hi everyone, the long awaited v2 release is finally here! With this release we're introducing many new features, a revamped look, and lots of bug fixes. We've made major changes to the underlying schema and libraries for improved performance and allows us to quickly add new features in the future.

## Features
### Improved location

In addition to country location, Umami now collects city and region information.

![image](https://user-images.githubusercontent.com/477975/232599010-d0eb3d94-049e-4e0a-8a63-97cdda584fa0.png)

### Clean URLs

Previously, Umami would include the query string as part of the page URL. Now we show only the path. Query parameters can still be found in the **Query parameters** section.

![image](https://user-images.githubusercontent.com/477975/232599724-a98d7ce1-f2c6-4b3a-943c-40da03caf26a.png)

### Page titles

Umami now records page titles.

![image](https://user-images.githubusercontent.com/477975/232599474-4d54b753-6312-41db-984f-53f60b1e3263.png)

### Teams

The new teams feature allows you to share websites with other users without having to create a Share URL. When a user joins a team, they can select which website they want to share with the team.

![image](https://user-images.githubusercontent.com/477975/232597791-6d81ce8b-b0a7-4ebb-9502-93628ed52350.png)

### Event data

The event data feature has been completely redesigned. We've updated the documentation on how it works:

- Track events, https://umami.is/docs/track-events
- Tracker functions, https://umami.is/docs/tracker-functions

There is no UI available in this release, but event data will be core to a lot of upcoming features. Stay tuned!

### Tracker

The tracker script has been refactored to be much more lightweight and performant. It can now also track outbound link clicks.

### Documentation

The documentation on the website has been updated with v2 information. See https://umami.is/docs.
The old docs are still available under https://umami.is/docs/v1/getting-started.

### New languages
- Sinhala
- Khmer
- Swiss German

## Migrating v1 to v2

Updating the application should be pretty straight-forward, but you will need to migrate your data in a separate step.
We've written a guide on how to migrate your install from v1 to v2. See https://umami.is/docs/migrate-v1-v2.

## Updates
- Upgraded Next.js to `13.2.3`
- Upgraded Prisma to `4.11.0`

A huge thanks to all the contributors on this release! @screendriver @franciscao633 @kaisteinke @BennyDeeDev @seanghay @briancao @BE-CH @vidschofelix @slawiko @d19dotca @enricopaulini @juangacovas @EffakT @ppnplus