Syntax

$cropText[text;maxLength;suffix]

Parameters

• text (string, required) — The source text.
• maxLength (integer, required) — The maximum character count (a non-negative integer, otherwise the function raises Maximum characters must be a non-negative integer.). Text longer than this is truncated.
• suffix (string, required) — String appended after truncation. Pass an empty value for a hard cut with no indicator. The call is refused with fewer than 3 arguments.

Return Value

• Type: string
• If text.length ≤ maxLength: returns text unchanged (no suffix).
• If text.length > maxLength: returns the first maxLength characters + suffix.

Usage

$cropText[Hello World;5;...]   → "Hello..."
$cropText[Hello World;20;...]  → "Hello World" (no truncation)
$cropText[Hello World;5;~]     → "Hello~"
$cropText[Hello World;3;]      → "Hel" (hard cut)

Common Patterns

Embed Field Truncation

Discord embed fields have character limits. Use $cropText to ensure compliance:

$cropText[$getUserVar[bio];1024;...]

Message Preview

Show a snippet of a long message:

$sendMessage[Latest post: $cropText[$getUserVar[lastPost];100;...]]

Title Formatting

$var[title;$cropText[$message;50;...]]

Important Notes

• Suffix is not included in maxLength: The maxLength value controls how many characters of the original text are kept. The suffix is added on top. For example, $cropText[abcdef;3;...] produces "abc..." (6 total characters).
• Hard cut with empty suffix: $cropText[text;5;] with an empty third argument simply returns the first 5 characters.
• Works with numbers/symbols: All characters count equally; a Unicode character made of a surrogate pair (such as most emoji) counts as one character.

Examples

Truncating Long Text

$title[Text Cropping]
$description[Preview: **$cropText[$message;50;...]**]
$footer[Original length: $charCount[$message] chars]
$color[#5865F2]