Skip to main content
This guide explains how to rename a git-connected shared model’s display name without disrupting its git sync folder or losing previously synced files. Renaming a model’s display name is safe for saved dashboards and workbooks, but it can silently break git sync if the model’s Model path setting was never set explicitly.

Requirements

To follow the steps in this guide, you’ll need:

How model path resolution works

Every git-connected model has a Model path setting (Model > Git settings) that determines the folder in your repository where Omni reads and writes the model’s files. This setting has two distinct states:
  • Explicit Model path set: the sync folder is pinned to that value. Renaming the model’s display name has no effect on the sync folder.
  • Model path unset (the default state): Omni doesn’t use a fixed folder. Instead, it derives the sync folder from the model’s current display name at sync time (default pattern: omni/<current-display-name>). This is re-evaluated live, not a value captured once when the model was created.
If Model path is unset and you rename the model’s display name, the next git sync looks for (and writes to) a new folder derived from the new name, while your previously synced files remain in the old folder derived from the old name. Omni sees an empty or missing folder at the new path, and the model can appear to lose all of its content.

What is and isn’t affected by renaming

  • The model’s ID never changes on rename. Saved dashboards and workbooks reference the model by ID, and fields are referenced by view name, not display name, so neither depends on the display name.
  • Once Model path is pinned, renaming the display name doesn’t break existing saved content.
  • Field IDs and view names are unaffected by a model display-name rename.

Steps

1

Check whether Model path is already set

In the model IDE, go to Model > Git settings and check the Model path field. If it already contains an explicit path, you can rename the model’s display name directly and skip the remaining steps.
2

Set an explicit Model path

If Model path is empty, set it to the model’s current folder in your repository, using a leading slash (e.g. /omni/<current-model-name>).
3

Confirm the setting saved

Reload the Git settings panel and verify the Model path value persisted and matches your repository’s actual folder structure.
4

Rename the model's display name

Use the model rename UI, or the Rename Model API, to update the display name.
5

Verify the git sync

Trigger a sync and confirm the model’s files still resolve from the pinned folder, with no unexpected file additions or deletions.
Test this full sequence on a non-production, git-connected model before applying it to a production model with meaningful content.

Related constraints when renaming a git-connected model

  • The new name must be unique among active models with the same model kind and base model.
  • The name must match the git-compatible pattern (word characters, hyphens, and forward slashes only).
  • The new name can’t conflict with an existing git ref path (for example, renaming to team when team/project already exists).
  • You can’t rename a branch model that has an open pull request — doing so would desync Omni from the git remote.

Next steps