Migration of existing profiles

Profile management can migrate existing profiles "on the fly" during logon if the user has no profile in the user store.

The following event takes place during logon: if an existing Windows profile is found and the user does not yet have a Citrix user profile in the user store, the Windows profile is migrated (copied) to the user store on the fly. After this process, the user store profile is used by Profile management in the current and any other session configured with the path to the same user store.

If this setting is enabled, profile migration can be activated for roaming and local profiles (the default), roaming profiles only, local profiles only, or profile migration can be disabled altogether.

If profile migration is disabled and no Citrix user profile exists in the user store, the existing Windows mechanism for creating new profiles is used as in a setup without Profile management.

If this setting is not configured here, the value from the .ini file is used.

If this setting is not configured here or in the .ini file, all types of existing profiles are migrated.

Supported on: At least User Profile Manager 2.0.0
Types of user profiles to be migrated if the user store is empty:


  1. Local and Roaming
    Registry HiveHKEY_LOCAL_MACHINE
    Registry PathSoftware\Policies\Citrix\UserProfileManager
    Value NameMigrateWindowsProfilesToUserStore
    Value TypeREG_DWORD
    Value1
  2. Local
    Registry HiveHKEY_LOCAL_MACHINE
    Registry PathSoftware\Policies\Citrix\UserProfileManager
    Value NameMigrateWindowsProfilesToUserStore
    Value TypeREG_DWORD
    Value2
  3. Roaming
    Registry HiveHKEY_LOCAL_MACHINE
    Registry PathSoftware\Policies\Citrix\UserProfileManager
    Value NameMigrateWindowsProfilesToUserStore
    Value TypeREG_DWORD
    Value3
  4. None
    Registry HiveHKEY_LOCAL_MACHINE
    Registry PathSoftware\Policies\Citrix\UserProfileManager
    Value NameMigrateWindowsProfilesToUserStore
    Value TypeREG_DWORD
    Value4


ctxprofile5.2.0.admx