move_instance

Reparents an instance to a new location in the DataModel.

What it does

move_instance takes an existing instance and changes its parent. The instance keeps its name, children, scripts, and properties — only the location changes. The new path is the new parent's path with the instance's existing name appended, and the tool returns that new path so Revix can use it for follow-up operations.

This is the right tool when something is in the wrong place: a script that belongs in ServerScriptService instead of Workspace, a UI element under the wrong ScreenGui, a folder that should live under ReplicatedStorage instead. Renaming an instance is done with set_properties on the Name property, not with move_instance.

Parameters

NameTypeRequiredDescription
`path`stringyesCurrent DataModel path of the instance.
`new_parent`stringyesDataModel path of the new parent.

When Revix uses it

  • Moving a misplaced script into its correct service container
  • Reorganizing UI elements under a different Frame or ScreenGui
  • Promoting a local-only folder into ReplicatedStorage so clients can see it
  • Tidying up after a create_instance that landed in the wrong parent

Example

text
move_instance(path="Workspace/GameManager", new_parent="ServerScriptService")
=> ServerScriptService/GameManager

Troubleshooting

If a move silently does nothing, the source path or new parent may be invalid. See building instances for path conventions.