.. _p_moving_model_instances:

Moving Model Instances: Overview
--------------------------------

If the Move operation is enabled for a model, instances can be moved from
its current hierarchy level to another level. Data models, Device models
and Relations can be enabled for the Move operation. For lists of objects
moved during a move operation, see :ref:`objects_that_are_moved_during_the_overbuild`
for data and device models, and :ref:`p_subscriber_management_models` for Subscriber
Management models.

Instances can only be moved up in the hierarchy if the administrator is at
a higher hierarchy. For example, for an instance at level cust1.site1 and
the level cust1.site2 also exists, then the user needs to be at level
cust1 to carry out a move of this instance 'sideways' to cust1.site2
by going up and back down the hierarchy levels.

The move is typically used in conjunction with data sync, which pulls the
entities in, for example users, phones, dial plan, and so on. By default
the entities reside at the level of the cluster, so the move feature
allows them to be allocated to a different hierarchy (if needed).