Skip to Content
Author's profile photo Former Member

How to migrate Custom MDF objects to other Successfactors Instance


Instance Synchronization Tool is one recommended solution for Customer using which objects of one instance can be copied to another within the same Customer landscape. A week before I was working on MDF basics and this is one of the part which I tried to explore as well. I found no such documents which describes this tool in details starting from enabling it in provisioning to set up the permission in instances. So I thought of consolidating my findings in a single blog for easy reference. While writing this blog, I have discussed on some points with Luke Marson in his blog Extending SuccessFactors with the Metadata Framework to find out that this is only applicable in customer instances and for demo instances assigned to Provisioning user. That helped me a lot in understanding the functionality of this tool.

Customers can use the Instance Sync Tool to migrate their configurations from one instance to another. The sync tool acts as a push model. The source instance selectively chooses configuration objects to push to the target instance.

How to enable the Instance Synchronization Tool in Provisioning:

  • Login to Provisioning and select the company for which the tool needs to be enabled.


  • Go to Company settings:


  • Check the option “Instance Synchronization Tool”


  • For enabling the MDF data synchronization using the tool also select the option “Enable MDF Data sync via Instance Sync Tool”


Configure the target instance for Instance Synchronization Tool:

  • In provisioning, select the source instance (instance where the tool needs to be enabled) and select “Instance Synchronization company Permissions”


  • Here we can add target instances for this company. They can be the instances in the same data center or in different data center.


  • In this case, we have selected the instance on the same data center.


  • On selecting the instance, a new window opens up for providing the object types that needs to be pushed to this target from source instance.


  • Select the relevant options as per requirements and save the form. This completes the configuration steps under provisioning.


Setting up permission in instance for using the tool:

  • For the given instance, go to “Manage Permission Roles” from Admin Tools and open the system administration permission page


  • In this window, now the new option should be there – “Manage Instance Synchronization” is. Select the permission and choose the object types that needs to be synced with the target instance.


Configuration Objects Supported:

We can transfer the following configuration objects in the Instance Sync tool:

  • PM Templates
  • Goal Templates
  • Families and Roles
  • Competency Libraries
  • Picklists
  • Route Maps
  • Rating Scales
  • Form Label Translations
  • RBP Roles
  • RBP Groups
  • Dashboard Settings
  • System Properties Settings
  • MDF Picklists
  • MDF Object Definitions
  • MDF Configuration UI
  • MDF Rules

How to launch the tool:

  • From the admin tools, select “Synchronize Instance Configurations”.


  • This opens a new wizard for synchronization tool. We need to select the instance where the objects need to be pushed.

Please note that this tool only works to sync from one customer instance to another. We can’t sync from a demo instance to a customer instance. As currently I am not having any customer instance for running this, I am not able to show the synchronization steps inside the tool.




Simulation Wizard:

  • For Test Sync: No configurations are actually transferred. The test sync is then sent to the monitor. You can check the simulation results in the monitor.


Run Sync Now: This is for actual synchronization


Instance Synchronization Monitor tool:

  • There is a monitor available in the Admin Tools that displays the progress of a sync operation. Additionally, you can use the monitor to view the summary of the objects that were transferred, that is, pass or fail. All administrators who have access to the sync tool have access to this monitor in Admin Tools:



  • The Instance Synchronization Monitor Tool displays as follows: There are options to check both test sync as well as actual sync


Example showing the sync job  for given time instances;


Description of the fields in Monitoring Tool:

Data Point Description
Sync ID ID of the sync request that was run

Status of the sync request

  • Queued
  • In Progress
  • Completed
  • Test Run Complete
Submission Date Date of Submission
Run Date Date the request ran
Actions Link to what the sync request included
Created by User ID of the user who created the request
Target Instance Company ID to which the configurations are being pushed
Sync Type

Test Sync: A test sync of the request

Actual Sync: A sync that is live and that transfers configurations

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Luke Marson
      Luke Marson

      Great blog Sourav.

      You can use Instance Sync Tool with demo instances, but only for demo instances assigned to your Provisioning user.

      All the best,


      Author's profile photo Former Member
      Former Member
      Blog Post Author

      Thanks Luke 🙂

      I have made the changes accordingly in the blog.

      Kind Regards,


      Author's profile photo Martina Stoeger
      Martina Stoeger

      Thanks for this very useful blog Sourav.

      There is also an Implementation Guide for the Instance Sync Tool available here:

      Currently I am using the Instance Sync Tool for an EC migration. But it seems that it is not possible to sync eg Foundation Objects which have no values, eg "Pay Group".

      But this object is needed as it is associated within standard with the MDF Object "Legal Entity". So I tried to import the FO "Pay Group" manually to Production. BUT via Admin Tools > Import Foundation Data there is no selection for "Pay Group" available at all and also lots of other FO are missing. So a manual import is also not possible at the moment.

      Does anybody have any hints?

      Thanks a lot in advance.



      Author's profile photo Luis Garcia
      Luis Garcia

      Sourav, My name is Luis García.

      I am facing a problem in my instance when I try to configure the Source: the configuration is not kept, once I press the botton "save". Therefore I don't have the option to select it when I launch the tool.

      I would appreciate any recommendation that you may have, I have followed all the steps according to the guide; but it is not working. As I mentioned before, I don't have the option to save the source Instance (Dev) in the provisioning for production.

      Kind Regards

      Author's profile photo Luke Marson
      Luke Marson

      If this is a customer system, raise a support ticket. Bear in mind there are some issues on DC4 and HCM4 right now that might impact this.

      Author's profile photo Former Member
      Former Member

      Hi Saurav,

      Very useful blog.

      Thank you.