Skip to content

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

Relax custom events limitations

Blue Mouse2f685ace4e98
diff --git a/backend/apps/cloud/src/analytics/dto/events.dto.ts b/backend/apps/cloud/src/analytics/dto/events.dto.ts
index 769d5d8e5..21fd04dc8 100644
--- a/backend/apps/cloud/src/analytics/dto/events.dto.ts
+++ b/backend/apps/cloud/src/analytics/dto/events.dto.ts
@@ -101,16 +101,13 @@ export class EventsDto {
profileId?: string
@ApiProperty({
- example: 'user-subscribed',
+ example: 'User Subscribed',
description: 'Event name',
- maxLength: 64,
+ maxLength: 256,
})
@IsNotEmpty()
- // Smaller than 64 characters, must start with an English letter and contain only letters (a-z A-Z), numbers (0-9), underscores (_) and dots (.)
- @Matches(/^[a-zA-Z][\w.]{0,62}$/, {
- message:
- 'Event name must start with an English letter and contain only letters (a-z A-Z), numbers (0-9), underscores (_) and dots (.). Maximum length is 63 characters.',
- })
+ @IsString()
+ @MaxLength(256)
ev: string
@ApiProperty({
diff --git a/backend/apps/cloud/src/analytics/dto/get-custom-event-meta.dto.ts b/backend/apps/cloud/src/analytics/dto/get-custom-event-meta.dto.ts
index 8fec5f5ff..66cb94583 100644
--- a/backend/apps/cloud/src/analytics/dto/get-custom-event-meta.dto.ts
+++ b/backend/apps/cloud/src/analytics/dto/get-custom-event-meta.dto.ts
@@ -1,7 +1,9 @@
import { ApiProperty, PickType } from '@nestjs/swagger'
-import { IsNotEmpty, IsString } from 'class-validator'
+import { IsNotEmpty, IsString, MaxLength } from 'class-validator'
import { GetDataDto } from './getData.dto'
+const MAX_CUSTOM_EVENT_NAME_LENGTH = 256
+
export class GetCustomEventMetadata extends PickType(GetDataDto, [
'pid',
'period',
@@ -15,5 +17,6 @@ export class GetCustomEventMetadata extends PickType(GetDataDto, [
@ApiProperty()
@IsNotEmpty()
@IsString()
+ @MaxLength(MAX_CUSTOM_EVENT_NAME_LENGTH)
event: string
}
diff --git a/backend/apps/cloud/src/analytics/dto/get-custom-events.dto.ts b/backend/apps/cloud/src/analytics/dto/get-custom-events.dto.ts
index b17e1a414..0f5de25a9 100644
--- a/backend/apps/cloud/src/analytics/dto/get-custom-events.dto.ts
+++ b/backend/apps/cloud/src/analytics/dto/get-custom-events.dto.ts
@@ -1,6 +1,9 @@
import { PickType } from '@nestjs/swagger'
+import { IsOptional, IsString, MaxLength } from 'class-validator'
import { GetDataDto } from './getData.dto'
+const MAX_CUSTOM_EVENTS_QUERY_LENGTH = 10000
+
export class GetCustomEventsDto extends PickType(GetDataDto, [
'pid',
'period',
@@ -10,5 +13,8 @@ export class GetCustomEventsDto extends PickType(GetDataDto, [
'filters',
'timezone',
] as const) {
+ @IsOptional()
+ @IsString()
+ @MaxLength(MAX_CUSTOM_EVENTS_QUERY_LENGTH)
customEvents: string
}
diff --git a/backend/apps/community/src/analytics/dto/events.dto.ts b/backend/apps/community/src/analytics/dto/events.dto.ts
index 769d5d8e5..21fd04dc8 100644
--- a/backend/apps/community/src/analytics/dto/events.dto.ts
+++ b/backend/apps/community/src/analytics/dto/events.dto.ts
@@ -101,16 +101,13 @@ export class EventsDto {
profileId?: string
@ApiProperty({
- example: 'user-subscribed',
+ example: 'User Subscribed',
description: 'Event name',
- maxLength: 64,
+ maxLength: 256,
})
@IsNotEmpty()
- // Smaller than 64 characters, must start with an English letter and contain only letters (a-z A-Z), numbers (0-9), underscores (_) and dots (.)
- @Matches(/^[a-zA-Z][\w.]{0,62}$/, {
- message:
- 'Event name must start with an English letter and contain only letters (a-z A-Z), numbers (0-9), underscores (_) and dots (.). Maximum length is 63 characters.',
- })
+ @IsString()
+ @MaxLength(256)
ev: string
@ApiProperty({
diff --git a/backend/apps/community/src/analytics/dto/get-custom-event-meta.dto.ts b/backend/apps/community/src/analytics/dto/get-custom-event-meta.dto.ts
index 8fec5f5ff..66cb94583 100644
--- a/backend/apps/community/src/analytics/dto/get-custom-event-meta.dto.ts
+++ b/backend/apps/community/src/analytics/dto/get-custom-event-meta.dto.ts
@@ -1,7 +1,9 @@
import { ApiProperty, PickType } from '@nestjs/swagger'
-import { IsNotEmpty, IsString } from 'class-validator'
+import { IsNotEmpty, IsString, MaxLength } from 'class-validator'
import { GetDataDto } from './getData.dto'
+const MAX_CUSTOM_EVENT_NAME_LENGTH = 256
+
export class GetCustomEventMetadata extends PickType(GetDataDto, [
'pid',
'period',
@@ -15,5 +17,6 @@ export class GetCustomEventMetadata extends PickType(GetDataDto, [
@ApiProperty()
@IsNotEmpty()
@IsString()
+ @MaxLength(MAX_CUSTOM_EVENT_NAME_LENGTH)
event: string
}
diff --git a/backend/apps/community/src/analytics/dto/get-custom-events.dto.ts b/backend/apps/community/src/analytics/dto/get-custom-events.dto.ts
index b17e1a414..0f5de25a9 100644
--- a/backend/apps/community/src/analytics/dto/get-custom-events.dto.ts
+++ b/backend/apps/community/src/analytics/dto/get-custom-events.dto.ts
@@ -1,6 +1,9 @@
import { PickType } from '@nestjs/swagger'
+import { IsOptional, IsString, MaxLength } from 'class-validator'
import { GetDataDto } from './getData.dto'
+const MAX_CUSTOM_EVENTS_QUERY_LENGTH = 10000
+
export class GetCustomEventsDto extends PickType(GetDataDto, [
'pid',
'period',
@@ -10,5 +13,8 @@ export class GetCustomEventsDto extends PickType(GetDataDto, [
'filters',
'timezone',
] as const) {
+ @IsOptional()
+ @IsString()
+ @MaxLength(MAX_CUSTOM_EVENTS_QUERY_LENGTH)
customEvents: string
}
diff --git a/docs/docs/api/events.md b/docs/docs/api/events.md
index 56e89d880..9c56bba3f 100644
--- a/docs/docs/api/events.md
+++ b/docs/docs/api/events.md
@@ -71,7 +71,7 @@ All of the values are numbers in milliseconds.
| Name | Type | Required | Description |
| -------- | --------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pid` | `string` | `true` | A project ID to record the pageview event for |
-| `ev` | `string` | `true` | An event identifier you want to track. This has to be a string, which:<br />1. Contains only English letters (a-Z A-Z), numbers (0-9), underscores (\_) and dots (.).<br />2. Is fewer than 64 characters.<br />3. Starts with an English letter. |
+| `ev` | `string` | `true` | An event identifier you want to track. Can contain any characters (including spaces, unicode, etc.) with a maximum length of 256 characters. |
| `unique` | `boolean` | `false` | If set to true, only 1 custom event will be saved per session |
| `pg` | `string` | `false` | A page that user sent data from (e.g. `/home`) |
| `lc` | `string` | `false` | A locale of the user (e.g. `en-US` or `uk-UA`) |
diff --git a/docs/docs/integrations/angular.md b/docs/docs/integrations/angular.md
index 9fbbb8570..19282847f 100644
--- a/docs/docs/integrations/angular.md
+++ b/docs/docs/integrations/angular.md
@@ -223,9 +223,8 @@ Usage in a template:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/aspnet.md b/docs/docs/integrations/aspnet.md
index 76908378e..9b7401dc9 100644
--- a/docs/docs/integrations/aspnet.md
+++ b/docs/docs/integrations/aspnet.md
@@ -319,9 +319,8 @@ Track clicks on external links across your site. Add this to your layout file:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `CONTACT_FORM_SUBMITTED`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/astro.md b/docs/docs/integrations/astro.md
index 3c28e67ac..07a8de50a 100644
--- a/docs/docs/integrations/astro.md
+++ b/docs/docs/integrations/astro.md
@@ -319,9 +319,8 @@ import SignUpForm from '../components/SignUpForm';
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `PDF_DOWNLOAD`, `SIGNUP_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/bubble.md b/docs/docs/integrations/bubble.md
index d32d42037..714eb1ff6 100644
--- a/docs/docs/integrations/bubble.md
+++ b/docs/docs/integrations/bubble.md
@@ -155,9 +155,8 @@ You can pass up to 20 metadata keys per event. Values are converted to strings a
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CLICKED`, `ITEM_ADDED_TO_CART`).
diff --git a/docs/docs/integrations/django.md b/docs/docs/integrations/django.md
index 834841c47..c30983727 100644
--- a/docs/docs/integrations/django.md
+++ b/docs/docs/integrations/django.md
@@ -242,9 +242,8 @@ Track clicks on external links across your site. Add this to your base template:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `CONTACT_FORM_SUBMITTED`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/docusaurus.md b/docs/docs/integrations/docusaurus.md
index bb3535675..38730e8a1 100644
--- a/docs/docs/integrations/docusaurus.md
+++ b/docs/docs/integrations/docusaurus.md
@@ -266,9 +266,8 @@ Check out the <TrackedLink href="https://github.com/Swetrix/swetrix">source code
When defining custom event names, keep in mind:
-- Names must contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`).
-- Names must be fewer than 64 characters.
-- Names must start with an English letter.
+- Names can contain any characters (including spaces, unicode, etc.).
+- Names must be no longer than 256 characters.
We recommend using `UPPER_SNAKE_CASE` for consistency (e.g. `DOCS_FEEDBACK`, `CTA_CLICK`, `SEARCH_OPENED`).
diff --git a/docs/docs/integrations/eleventy.md b/docs/docs/integrations/eleventy.md
index 0bab4de76..0aa7a5588 100644
--- a/docs/docs/integrations/eleventy.md
+++ b/docs/docs/integrations/eleventy.md
@@ -234,9 +234,8 @@ Add event tracking to any page or component using inline scripts:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `PDF_DOWNLOAD`, `NEWSLETTER_SIGNUP`).
diff --git a/docs/docs/integrations/express.md b/docs/docs/integrations/express.md
index 591225d17..742f9a022 100644
--- a/docs/docs/integrations/express.md
+++ b/docs/docs/integrations/express.md
@@ -148,9 +148,8 @@ app.post('/api/subscribe', async (req, res) => {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `NEWSLETTER_SUBSCRIBE`, `CHECKOUT_COMPLETED`).
diff --git a/docs/docs/integrations/fastapi.md b/docs/docs/integrations/fastapi.md
index f66e14a00..0a2ae4955 100644
--- a/docs/docs/integrations/fastapi.md
+++ b/docs/docs/integrations/fastapi.md
@@ -350,9 +350,8 @@ async def subscribe(body: SubscribeRequest, request: Request):
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `NEWSLETTER_SUBSCRIBE`, `CHECKOUT_COMPLETED`).
diff --git a/docs/docs/integrations/fastify.md b/docs/docs/integrations/fastify.md
index 948f32f46..bc2f24a36 100644
--- a/docs/docs/integrations/fastify.md
+++ b/docs/docs/integrations/fastify.md
@@ -174,9 +174,8 @@ fastify.post('/api/subscribe', async (request, reply) => {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `NEWSLETTER_SUBSCRIBE`, `CHECKOUT_COMPLETED`).
diff --git a/docs/docs/integrations/flask.md b/docs/docs/integrations/flask.md
index 117f741cf..1e729dcad 100644
--- a/docs/docs/integrations/flask.md
+++ b/docs/docs/integrations/flask.md
@@ -240,9 +240,8 @@ Track clicks on external links across your site. Add this to your base template:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `REGISTER_FORM_SUBMITTED`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/gatsby.md b/docs/docs/integrations/gatsby.md
index 92561cb9f..6ecebb180 100644
--- a/docs/docs/integrations/gatsby.md
+++ b/docs/docs/integrations/gatsby.md
@@ -162,9 +162,8 @@ export default function NewsletterForm() {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `PRICING_CTA_CLICK`, `NEWSLETTER_SIGNUP`).
diff --git a/docs/docs/integrations/google-tag-manager.md b/docs/docs/integrations/google-tag-manager.md
index 7db35bd4d..1d2cd25fa 100644
--- a/docs/docs/integrations/google-tag-manager.md
+++ b/docs/docs/integrations/google-tag-manager.md
@@ -150,7 +150,7 @@ swetrix.track({
```
:::tip
-Event names must contain only English letters, numbers, underscores, and dots, be under 64 characters, and start with a letter. The `meta` object supports up to 20 keys with a combined value length under 1000 characters.
+Event names can contain any characters (including spaces and unicode) with a maximum length of 256 characters. The `meta` object supports up to 20 keys with a combined value length under 1000 characters.
:::
## Error tracking
diff --git a/docs/docs/integrations/hexo.md b/docs/docs/integrations/hexo.md
index beb10e8d8..fe314251c 100644
--- a/docs/docs/integrations/hexo.md
+++ b/docs/docs/integrations/hexo.md
@@ -199,9 +199,8 @@ Custom events let you track specific user interactions — button clicks, form s
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
## Using the Swetrix npm package
diff --git a/docs/docs/integrations/htmx.md b/docs/docs/integrations/htmx.md
index c49f17aec..c434f678a 100644
--- a/docs/docs/integrations/htmx.md
+++ b/docs/docs/integrations/htmx.md
@@ -181,9 +181,8 @@ You can hook into htmx events to track actions like form submissions that happen
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
## Check your installation
diff --git a/docs/docs/integrations/jekyll.md b/docs/docs/integrations/jekyll.md
index 26bfa5557..aeea04f2a 100644
--- a/docs/docs/integrations/jekyll.md
+++ b/docs/docs/integrations/jekyll.md
@@ -148,9 +148,8 @@ swetrix.track({
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
## Check your installation
diff --git a/docs/docs/integrations/laravel.md b/docs/docs/integrations/laravel.md
index 4c13a974b..3f2c7a916 100644
--- a/docs/docs/integrations/laravel.md
+++ b/docs/docs/integrations/laravel.md
@@ -226,9 +226,8 @@ Track clicks on external links across your site. You can add this to your main l
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `CONTACT_FORM_SUBMITTED`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/mkdocs.md b/docs/docs/integrations/mkdocs.md
index b481cd59d..51be1b242 100644
--- a/docs/docs/integrations/mkdocs.md
+++ b/docs/docs/integrations/mkdocs.md
@@ -214,9 +214,8 @@ You can add event tracking to any element on a Markdown page using raw HTML:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
## Check your installation
diff --git a/docs/docs/integrations/nestjs.md b/docs/docs/integrations/nestjs.md
index cfe331e7c..0e8d35adc 100644
--- a/docs/docs/integrations/nestjs.md
+++ b/docs/docs/integrations/nestjs.md
@@ -272,9 +272,8 @@ export class SubscriptionController {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `NEWSLETTER_SUBSCRIBE`, `CHECKOUT_COMPLETED`).
diff --git a/docs/docs/integrations/nextjs.md b/docs/docs/integrations/nextjs.md
index e5b67226a..d9d3adf1f 100644
--- a/docs/docs/integrations/nextjs.md
+++ b/docs/docs/integrations/nextjs.md
@@ -277,9 +277,8 @@ export default function TrackedLink({
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `PRICING_CTA_CLICK`, `NEWSLETTER_SIGNUP`).
diff --git a/docs/docs/integrations/nextra.md b/docs/docs/integrations/nextra.md
index 88e762bcb..0109e0927 100644
--- a/docs/docs/integrations/nextra.md
+++ b/docs/docs/integrations/nextra.md
@@ -288,9 +288,8 @@ Check out the <TrackedLink href="https://github.com/example/repo">source code</T
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `DOCS_FEEDBACK`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/nuxt.md b/docs/docs/integrations/nuxt.md
index e06b8461f..9256b3ede 100644
--- a/docs/docs/integrations/nuxt.md
+++ b/docs/docs/integrations/nuxt.md
@@ -196,9 +196,8 @@ function handleClick() {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/preact.md b/docs/docs/integrations/preact.md
index 0ff6f339d..5c5b89848 100644
--- a/docs/docs/integrations/preact.md
+++ b/docs/docs/integrations/preact.md
@@ -198,9 +198,8 @@ export default function TrackedLink({
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/qwik.md b/docs/docs/integrations/qwik.md
index d1bdcb5a8..b111531c5 100644
--- a/docs/docs/integrations/qwik.md
+++ b/docs/docs/integrations/qwik.md
@@ -207,9 +207,8 @@ export const TrackedLink = component$<TrackedLinkProps>(
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `UPGRADE_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/react.md b/docs/docs/integrations/react.md
index 9dc5b2d25..2d14c55da 100644
--- a/docs/docs/integrations/react.md
+++ b/docs/docs/integrations/react.md
@@ -195,9 +195,8 @@ export default function TrackedLink({
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/remix.md b/docs/docs/integrations/remix.md
index f76512adf..c2ec5443b 100644
--- a/docs/docs/integrations/remix.md
+++ b/docs/docs/integrations/remix.md
@@ -217,9 +217,8 @@ export default function TrackedLink({
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `UPGRADE_CTA_CLICK`, `WAITLIST_SIGNUP`).
diff --git a/docs/docs/integrations/ruby-on-rails.md b/docs/docs/integrations/ruby-on-rails.md
index fc7397518..4ea946946 100644
--- a/docs/docs/integrations/ruby-on-rails.md
+++ b/docs/docs/integrations/ruby-on-rails.md
@@ -218,9 +218,8 @@ Track clicks on external links across your site. Add this to your layout file:
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_FORM_SUBMITTED`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/solidjs.md b/docs/docs/integrations/solidjs.md
index 5fe32774c..b06064f11 100644
--- a/docs/docs/integrations/solidjs.md
+++ b/docs/docs/integrations/solidjs.md
@@ -199,9 +199,8 @@ export default function ContactForm() {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/integrations/thrivecart.md b/docs/docs/integrations/thrivecart.md
index 5f828a53b..29aa01925 100644
--- a/docs/docs/integrations/thrivecart.md
+++ b/docs/docs/integrations/thrivecart.md
@@ -120,7 +120,7 @@ Update the variables at the top of the script:
| Variable | Description |
| --- | --- |
-| `EVENT_NAME` | The custom event name (e.g. `purchase`, `checkout_complete`). Must contain only letters, numbers, underscores, and dots. |
+| `EVENT_NAME` | The custom event name (e.g. `Purchase`, `Checkout Complete`). Can contain any characters with a maximum length of 256 characters. |
| `EVENT_META` | An object with event metadata. All values must be strings. |
| `PROJECT_ID` | Your Swetrix Project ID. |
diff --git a/docs/docs/integrations/vitepress.md b/docs/docs/integrations/vitepress.md
index 8b5dab743..c315bcc06 100644
--- a/docs/docs/integrations/vitepress.md
+++ b/docs/docs/integrations/vitepress.md
@@ -258,9 +258,8 @@ Check out the <TrackedLink href="https://github.com/example/repo">source code</T
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `DOCS_FEEDBACK`, `OUTBOUND_CLICK`).
diff --git a/docs/docs/integrations/vue.md b/docs/docs/integrations/vue.md
index 79ffec280..6f5c8a5f3 100644
--- a/docs/docs/integrations/vue.md
+++ b/docs/docs/integrations/vue.md
@@ -187,9 +187,8 @@ function handleClick() {
Event names must:
-- Contain only English letters (a-Z), numbers (0-9), underscores (`_`), and dots (`.`)
-- Be fewer than 64 characters
-- Start with an English letter
+- Contain any characters (including spaces, unicode, etc.)
+- Be no longer than 256 characters
We recommend `UPPER_SNAKE_CASE` for consistency (e.g. `SIGNUP_CTA_CLICK`, `CONTACT_FORM_SUBMITTED`).
diff --git a/docs/docs/script-reference.md b/docs/docs/script-reference.md
index fd6a2b59b..73f8212a8 100644
--- a/docs/docs/script-reference.md
+++ b/docs/docs/script-reference.md
@@ -60,7 +60,7 @@ swetrix.track({
| Name | Description | Default value |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
-| ev | The event identifier you want to track.<br />This has to be a string, which:<br />1. Contains only English letters (a-Z A-Z), numbers (0-9), underscores (\_) and dots (.).<br />2. Is fewer than 64 characters.<br />3. Starts with an English letter. | REQUIRED PARAMETER |
+| ev | The event identifier you want to track. Can contain any characters (including spaces, unicode, etc.) with a maximum length of 256 characters. | REQUIRED PARAMETER |
| unique | If true, only 1 event with the same ID will be saved per user session.<br />The principle of this parameter is similar to page views and unique views. | `false` |
| meta | An object that contains event-related metadata. The values of the object must be a primitive type (string, number, boolean, null) which will be converted to a string, the maximum number of keys allowed is `20` and the total length of the values combined must be less than `1000` characters.<br /> This feature is useful if you want to track additional data about your custom events, for example the custom event name might be `Sign up` and the metadata might be `{ affiliate: 'Yes', footer: 'No' }`. | `{}` |
| profileId | Optional profile ID for long-term user tracking. Overrides the global profileId if set. | `undefined` |