v2.17.0

[mikecao]

Features

Batch send

You can now send data in batches, for example when trying to import a lot of data through the API. Instead of sending a single payload object, you would send an array of objects. It will be processed by the same logic from /api/send. To use this feature, you would make a POST request to /api/batch.

Payload overrides

When you send a request to /api/send, Umami pulls data from the request such as user-agent and IP address. Now you can provide your own values in the payload. This is useful when you're sending from a server or mobile environment where you are not using a web browser. The values you can provide are:

• ip: IP address. Note that when you send a custom IP address, the normal geo headers from hosts like Vercel and Cloudflare are ignored and a local lookup will be made to get the country and city data.
• userAgent: User agent string. Note this must be in a valid format or your request might be flagged as a bot.
• timestamp: UNIX timestamp in seconds. If passed in, Umami will record the data with the given timestamp instead of the current time.

Do Not Track

You can respect users DNT setting by adding the parameter data-do-not-track=true on your tracker script.

Fixes

• Error when filtering using referrer Error when filtering using referrer after update to 2.16.1 #3255
• CORS headers missing from custom endpoints. Suddenly missing CORS headers on custom collection endpoint #3281
• Journey report regression Journey report regression #3268
• Hostname is not allowed 127.0.0.1 Hostname is not allowed 127.0.0.1 #3279
• Grouped referrers shows incorrect values Grouped referrers shows incorrect values (v2.16.1) #3257

Updates

• Improved paid ad channel detection Improve the PAID_AD_PARAMS constant #3270

Thanks

@shrutesh1 @harryo @zeroCoder1 @Maxime-J

---

This discussion was created from the release v2.17.0.

[cromelex]

Hi,

Would you have docs on how to implement the new data-do-not-track=true on the tracking script? Just looking for a sample of what it should look like.

Thanks

[mikecao]

Docs updated.

[nandi95]

The batch updating, are there any plans to bring this functionality to the delivered js? Either by manually calling a .batch() or perhaps some settings for auto configurations e.g.: send every 5 events, once a minute (whichever sooner) etc