Tokens and Patterns

Tokens

Think of tokens as variables for renaming—they can represent parts of the object’s name or the entire name without requiring you to type them manually. They can also reference the object’s collection name or expand into letters A-Z.

You can mix and match them to create different naming variations.

For example:

• $_~1
• ~1 #2 @

List of tokens

$ (Object’s name trimmed of leading/trailing non-letters and number)
$* (Object’s Full name)
;; (Object’s collection name)

~n (The n-th word in the name)
~~n (The n-th word in the name + trailing separators)
~~-n (The n-th word in the name + leading separators)

#n (The n-th number in the name)
##n (The n-th word in the name + trailing separators)
##-n (The n-th word in the name + leading separators)

@ (Letter A-Z)

Using token or special characters in names

You can enclose tokens in angle brackets < > to neutralize their special meaning, allowing them to be treated as regular characters in the name.

That said, it’s best to avoid using token characters in names whenever possible. If you run into any issues, don’t hesitate to report them.

Self Token: $

$ represents the core of the object’s name, trimmed of leading/trailing non-letters and number. For example:

Selected objects:

Text Field:

Result:

Self Token: $*

$* represents the object’s full name. For example:

Selected objects:

Text Field:

Result:

By using $* , you can add prefix and suffix to the name like so

Text Field:

Text Field:

Text Field:

Collection Token: ;;

;; represents each object’s collection name.

Selected objects:

*Each object’s collection name is indicated within square brackets: [ ]

Text Field:

Result:

Word Token: ~n, ~~n, ~~-n

Note: n == integer number

~1 refers to the first word of the object’s name.
~~1 refers to the first word of the object’s name + its trailing separators
~~-1 refers to the last word of the object’s name + its leading separators

The double tilde (~~) removes the word along with its trailing separator.

Using a negatif number lets you select words from the end of the name and targets the leading separator instead of the trailing one.

Selected objects:

Text Field:

Result:

Selected objects:

Text Field:

Result:

Selected objects:

Text Field:

Result:

Number Token: #n, ##n, ##-n

Note: n == integer number

#1 refers to the first number of the object’s name.
##1 refers to the first number of the object’s name + its trailing separators
##-1 refers to the last number of the object’s name + its leading separators

The double pound (##) removes the number along with its trailing separator.

Using a negatif number lets you select numbers from the end of the name and targets the leading separator instead of the trailing one.

Selected objects:

Text Field:

Result:

Selected objects:

Text Field:

Result:

Selected objects:

Text Field:

Result:

Regular Expressions

When tokens aren’t enough for complex naming tasks, you can use regular expressions (regex) to target specific patterns in object names.

• Wrap your regex pattern in curly brackets { }.
• Text inside the brackets is treated as a regular expression.
• Use parentheses ( ) to capture specific parts of the name.

Selected objects:

Text Field:

Result:

Text Field:

Result:

* This pattern captures a version-like pattern (starting with v) at the end of the string after an underscore.

Tip: Regular expressions offer great flexibility but require some familiarity with regex syntax.
Need help crafting patterns? Try tools like regex101.com for testing and quick explanations.

Fallback value

If the regular expression doesn’t find a match, instead of returning an empty string (""), you can specify a fallback value using the /or:replacement_text/ syntax. Place this at the end of the expression.

For example:

Regex:

Text Field:

Result (when no match is found):