In uSync a Handler manages the reading and writing of the uSync Settings from the physical disk of the installation.

Handlers don't do the actual importing or exporting of items that work is done by the Serializers.

Handler Groups

Handlers are grouped within the main uSync.Config file - these groups allow you (and other uSync tools) to use diffrent sets of handlers depending on the groups.

<Handlers Name="default">
 <Handler Alias="dataTypeHandler" Enabled="true" Actions="All" />
 <Handler Alias="languageHandler" Enabled="true" Actions="All" />
 <Handler Alias="macroHandler" Enabled="true" Actions="All" />
 <Handler Alias="memberTypeHandler" Enabled="true" Actions="All" />
 <Handler Alias="templateHandler" Enabled="true" Actions="All" />
 <Handler Alias="contentTypeHandler" Enabled="true" Actions="All" />


Property Values Notes
Enabled true/false Turns this handler on or off within the handler group
Actions All,Import,Export,Report Turns the handler on or off for specific actions, by default all handlers are on for all actions


Items get to disk in one of two ways; either a user triggers an export via the uSync dashboard or uSync detects a change and triggers a single export of an item.

Handlers listen for the save/delete/move events and trigger exports when things change


Depending on settings, handlers can import settings either at startup of your site or when you trigger an import via the uSync dashboard.

Forced Import

Typically an import will only attempt to update items that have changed, this is for both speed and consistency - you can however force an import which will update all items regardless of if they have changed or not since the last import.