API reference › @evolu/common › local‑first/Evolu › maxMutationSize

const maxMutationSize: PositiveInt;

Defined in: packages/common/src/local-first/Evolu.ts:1005

The largest Mutation, in bytes.

A mutation's size is its change as encoded for sync: the table name, the ID, and every column name and value, with a few bytes of overhead. A string takes at most three bytes per UTF-16 code unit. Every mutation within the limit fits one protocol message, so it can always sync. A larger mutation throws and is not saved. Mutations of local-only tables are exempt, because they never sync. Measure a mutation in advance with Evolu.getMutationSize.