In today's guide, we're going to cover uSync. A free Nuget package that will allow you to back-up your Umbraco settings to your webroot.  Using uSync we store things like document types, data types, templates, and media file definitions.

Installing uSync


In Nuget package manager, type in uSync and you should be presented with the list of options above.  I'm installing the uSync back office so I can export and import using uSync within the Umbraco backend. After you have installed uSync if you open up Umbraco CMS and go to the 'Developer' section from the left-hand menu, as seen below:

umbraco_usync_backoffice From here make sure you have 'Automatic' set if you want and from here you can do an import from an existing site, or, an export to save your data to disk.  After exporting, within your webroot you should see a folder called 'uSync'.  Under here you will see a list of folders for the various data-types that have been saved.

umbraco_usync_folder_layout So for example, a document type definition would look like this:

Using this file you could then simply copy this config onto your production server that had uSync installed and the page type would automatically install on application start-up.  All the events are fired from Jumoo.uSync.BackOffice.Events.


In today's guide we have covered what uSync is and how it can be used to export and import your database changes to your Umbraco webroot. uSync is a great little utility to back-up Syncing Umbraco database config to disk and back. uSync combined with a file transfer app like Sugarsync or dropbox means you can update one Umbraco install and have all the other automatically update as well, all without doing a code deploy. There are pros and con's to this approach.  On one hand the back-up and sync feature is really good. uSync however is not a plug-in to enable code first.  Document types cannot be defined in code, using uSync cannot help enable out of the box strongly-typed data models.