📈 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!
TypeScript chartsclickhousedockergdprgoogle-analyticsmetricsmonitoringmysqlnestjsprivacyredisself-hostedselfhostedstatisticstailwindcssweb-analyticswebanalyticswebsite
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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mdindex 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 aEvent 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 codeWhen 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 trackingdiff --git a/docs/docs/integrations/hexo.md b/docs/docs/integrations/hexo.mdindex 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 sEvent 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 packagediff --git a/docs/docs/integrations/htmx.md b/docs/docs/integrations/htmx.mdindex 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 happenEvent 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 installationdiff --git a/docs/docs/integrations/jekyll.md b/docs/docs/integrations/jekyll.mdindex 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 installationdiff --git a/docs/docs/integrations/laravel.md b/docs/docs/integrations/laravel.mdindex 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 lEvent 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 charactersWe 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.mdindex 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 installationdiff --git a/docs/docs/integrations/nestjs.md b/docs/docs/integrations/nestjs.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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</TEvent 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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.mdindex 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</TEvent 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 charactersWe 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.mdindex 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 charactersWe 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.mdindex 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` |