Skip to content

Preferences and Troubleshooting

Open the add-on preferences in Edit > Preferences > Add-ons > RIn.Rename. The settings are split into tabs: Display, Naming, CSV, Hotkeys, Favourites, Aliases and Switch.

The most used settings are also available:

  • inside the rename dialog, by typing /. (Quick Options)
  • in the RIn.Rename panel of the 3D Viewport header

Favourites, Aliases and Switch are explained on Favourites, Switch Words, and Aliases.

  • HUD1: Display the new name above each object’s origin (on by default).
  • HUD2: Display the renamed results in the bottom-left corner of the 3D Viewport.
  • Viewport Name: Temporarily turn on each object’s viewport name (Object Properties > Viewport Display > Name) while RIn.Rename is open (on by default).
  • Selection Order: Show the selection order number next to each name in HUD1 (on by default).
  • Header Icon: Show the RIn.Rename icon in the 3D Viewport header.
  • Preview Text: Show the renamed result under the text field (only shown in Blender 4.1 and earlier, see below).
  • HUD Font Color, HUD Font Size, and HUD Bottom Left Font Size.
  • No Selection Mode HUD Margin X / Y: The position of the name list in No Selection Mode.
RIn.Rename Preferences > Naming Tab
RIn.Rename Preferences > Naming Tab
  • Auto Rename Mesh Data Name: Also rename the object’s data (eg. the mesh) to the new object name.
  • Case Sensitive Search & Replace: Off by default, so cube/Box also matches Cube. See Search and Replace.
  • Collapse non-alphanumeric runs for ^ and Characters ignored by ^: See Replace Non-Alphanumeric Characters.
  • /title ignores all-uppercase words: Keep words like GEO or LOD uppercase when using /title .
  • Apply default post-filter and its options: See Default Post-Filter.
  • Reset Numbering on each collection: See below.
  • Only Auto-Number the Last Number (on by default): When a typed name has several numbers, only the last one counts up. See Which numbers count up?
  • Change Numbering Format: Format Last Number by Default (on by default): <4> formats only the last number; use <4a> for all numbers. See Change Numbering Format.
  • Increment Typed Numbers (on by default): The checkbox shown under the text field when a pattern mixes @ with a typed number. See Alphabet Numbering.
  • Bones: settings for renaming bones:
    • Mirror Bone Renames (off by default): Also rename each bone’s mirror on the other side.
    • Add Side to Bone Names (on by default): Add the side each bone is on to names typed without one, eg. arm01 → arm01.L.
    • Default Side Style (.L / .R by default): The side added when the bone’s old name has no side style to keep.
    • Bone Numbering: Symmetric (default) or Continuous, when bones on both sides are selected.
    • Bone Mirror Tolerance (0.001 by default): How close a bone must be to the centre line, or to a mirrored position.
  • Separator and Number of Zeros: The default numbering format, see below.
  • Enable Expressions Left / Right and $ to ignore left / right: See $ Expressions.

This setting (on by default) resets the numbering on each collection. It affects the numbering in your input (you need to have numbers in the text input eg: ‘name_01’) and the @ letters.

RIn.Rename Preferences > Naming > Reset Numbering on each collection
RIn.Rename Preferences > Naming > Reset Numbering on each collection
Reset Numbering on each collection Example
Reset Numbering on each collection Example
RIn.Rename Preferences > Naming > Numbering format
RIn.Rename Preferences > Naming > Numbering format

The Separator and Number of Zeros settings let you customize the numbering format that is added when names aren’t unique. By default, it follows Blender’s format (.001), but you can change it to _01, -0001.

Example:

Input:
Separator:
Number of zeros:
Result:

The Separator is also the default separator of /sc .

RIn.Rename Preferences > Naming > $ to ignore
RIn.Rename Preferences > Naming > $ to ignore

These settings let you customize how the $ token expands.

By default, $ only trims characters that aren’t letters from the beginning and end of a name. Turn on Enable Expressions Left and/or Enable Expressions Right (both off by default) to also remove the patterns in $ to ignore left and $ to ignore right. This is useful for automatically stripping common naming patterns like GEO_, _GRP, _HI, or _LO.

  • Both settings accept regular expressions, and you can define multiple patterns by separating them with commas.
  • Left patterns are only removed from the start of the name, right patterns only from the end.
  • To make an expression case-insensitive, add \i at the end.

Default Expressions in Rin.rename:

  • $ to ignore left: geo[-_]+\i
  • $ to ignore right: [-_ .]+(hi|low|lo)$\i,[-_ .]+grp$\i
Selected objects:
$ (expressions on):

The default post-filter is a command that runs on every rename result after your own command, for example to always clean up separators and use title case. It is off by default.

  • Apply default post-filter: Turn the filter on.
  • Default post-filter: The command to run. It can be a chain, the default is ^/_|/title.
  • Default post-filter ignored regex patterns: Comma-separated regular expressions for parts of the name the filter should leave unchanged. Add \i at the end of a pattern for case-insensitive matching.
  • Apply post-filter to list modes: Also run the filter on the object data lists (/m, /mo, /vg, /sk, /uv, /at, /ca). Off by default.

The filter is skipped when your command adds a prefix or suffix (>, >>, <, <<), and for actions such as /d that don’t create names.

  • Open CSV with: The application used to open rename list files. Leave it blank to use the operating system’s default application.
  • Export as Text File: Use a plain text list instead of CSV. See Rename List Workflow.
  • The RIn.Rename hotkey (default: F2).
  • Single Selection Mode: How RIn.Rename opens when one item is selected: Popup, Dialog (default) or Blender Native. See Selection Modes.

The Save/Load/Open User Settings buttons at the bottom of the preferences let you store your settings in a configuration file named user-config.json.

RIn.Rename Preferences > Save/Load/Open User Settings
RIn.Rename Preferences > Save/Load/Open User Settings
  • Save User Settings: Write your current preferences, hotkeys, favourites, aliases and switch words to the file.
  • Load User Settings: Apply the settings from the file.
  • Open User Settings: Open the file in your text editor.

The file is kept in Blender’s user config folder, in a rinrename folder (next to your command history, history.json):

  • Windows: %APPDATA%\Blender Foundation\Blender\{version}\config\rinrename\
  • macOS: ~/Library/Application Support/Blender/{version}/config/rinrename/
  • Linux: ~/.config/blender/{version}/config/rinrename/

Because the file is outside the add-on folder, it survives reinstalling or updating RIn.Rename, and a fresh install picks up most of the saved settings. Use Load User Settings to restore all of them. A file left in the add-on folder by older versions is copied there automatically.

If the file can’t be read (eg. after a bad manual edit), RIn.Rename starts with default settings and keeps the broken file as user-config.json.broken.

The json file looks like this (shortened):

{
"hotkey": [
"F2",
0,
0,
0
],
"display_hud_above_object": 1,
"display_hud_left_corner": 0,
"separator": ".",
"num_of_zeros": 3,
"reset_numbering_on_each_collection": 1,
"increment_only_last_number": 1,
"dollar_token_to_ignore_left": "geo[-_]+\\i",
"fav1": ";;|/lo| /-",
"fav1_comment": "Rename according to collection",
"alias1": "",
"alias1_text": "",
"single_selection_mode": "DIALOG",
"switch_words": [
[
"Bake",
"high, hi, hp, highpoly, hipoly"
]
]
}

RIn.Rename gives the best experience in Blender 4.2 or newer. It still runs in Blender 3.6 to 4.1, but with the limits below.

In Blender version 4.1 and earlier, there’s a known issue where the preview text (highlighted at the picture below) doesn’t update in real-time as you type.

RIn.Rename Blender 4.2 Operator Window > `Preview renamed texts`
RIn.Rename Blender 4.2 Operator Window > Preview renamed texts

To work around this, you can disable the preview text and instead rely on the Heads-Up Display (HUD) in the bottom-left corner of the 3D view. In these versions, RIn.Rename uses this setup by default.

RIn.Rename Preferences > Display > Turn On `HUD2`, Turn Off `Preview Text`
RIn.Rename Preferences > Display > Turn On HUD2, Turn Off Preview Text

When you run RIn.Rename with nothing selected, the no-selection preview HUD appears only after you type a rename pattern. The HUD position controls are shown only while that preview HUD is visible, so the position settings stay hidden when there is no HUD on screen.

If you encounter bugs or unexpected issues, please don’t hesitate to reach out. The more details you provide, the easier it will be for me to troubleshoot:

✅ Console error messages
✅ Screenshots (if necessary) ✅ Videos (if necessary)

I’ll do my best to respond promptly.

  1. Run Blender from the console (command line).
  2. Enable the “Enable Console Logging” option in the add-on preferences to display helpful debugging information.
RIn.Rename Preferences > Enable Console Logging
RIn.Rename Preferences > Enable Console Logging

Got feedback? Ideas for new features? Or just not happy with how something works? I’d love to hear from you!

📧 Email me directly
💬 Comment on my YouTube video
📝 Post on the Blender Artists thread 💻 Join the discussion on my Discord channel

Your input helps make RinRename better!

Just some ideas, not yet commited:

  • New command to convert numbering format [NOV2025]
  • Search and replace feature ability to ignore case for the search text (eg. search/ will match Search or SearCH) [NOV2025]
  • Simple expression for in search and replace
  • Type token? (Light, Geo, Lattice, grp, etc)
  • Rename vertex groups [MAY2026]
  • Rename textures, materials [MAY2026]
  • Rename all instead of selected (No Selection Mode)
  • Rename everything in a collection without having to select the objects
  • Improve +text@position to support negatif numbers, and get dynamic position using regular expressions
  • Make @ more flexible: to be able to use lowercase, to be able to start from a specific Alphabets
  • Invert word and number token !~1 (every word except the first one?)
  • etc…