From d7d35443b3f89a244a0e1eefef6d19895e0bc004 Mon Sep 17 00:00:00 2001
From: Brian Smith <5679695+brismuth@users.noreply.github.com>
Date: Thu, 19 Feb 2026 12:03:36 -0600
Subject: [PATCH] Adding docs for overriding event timestamp

---
 content/docs/tracker-functions.mdx | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/content/docs/tracker-functions.mdx b/content/docs/tracker-functions.mdx
index 8533d56..ed1c8d9 100644
--- a/content/docs/tracker-functions.mdx
+++ b/content/docs/tracker-functions.mdx
@@ -101,6 +101,18 @@ Event Data can work with any JSON data. There are a few rules in place to mainta
 - Arrays are converted to a String, with the same max length of 500.
 - Objects have a max of 50 properties. Arrays are considered 1 property.
 
+## Overriding Event Timestamps
+
+You can override the event timestamp by adding a UNIX timestamp in seconds to the payload:
+
+```js
+umami.track(props => ({
+  ...props,
+  name: 'signup-button',
+  timestamp: 1771523787, // new Date().getTime() / 1000
+}));
+```
+
 ## Sessions
 
 Pass in your own ID to identify a user.