Skip to main content
Version: v10.x - Umbraco 10

Exporting

What is an Export?

the uSync export process takes everything from within your Umbraco site and writes the settings, content, media to disk in the uSync folder. This can then form the basis of any reporting or importing you do on this on other Umbraco sites you copy the uSync folder to.

note

By default, uSync will export the changes for individual items to disk every time they are saved within Umbraco, for normal operation you probably won't need to manually run an export as uSync's "export on save" operations will keep the files on disk in sync with your installation.

Running an Export

Dashboard

To run an export you click on the export button either within a specific group (e.g export all settings), or in the everything group.

uSync will run through all the relevant items within your site, and write their settings to disk, this will overwrite any files already on disk for these items.

Should I Run a Clean Export?

You may notice that on the export button in the "Everything" group you can select "Clean Export".

Clean export button

A clean export will first remove all existing files from the uSync folder, this means if you have orphaned or merged files within the uSync folder they will be removed so you can be sure that only the items from your Umbraco install are within the uSync folder.

Caution About a Clean Export

When you delete an item within Umbraco, uSync will create a 'empty' marker file in the uSync folder, so when a report or import is ran on the folder uSync will know to delete any items that match the fingerprint in the file.

When you run a clean export these marker files will also be deleted and because the items no longer exist in your Umbraco site, nothing will be written to disk. You will essentially lose these delete events.

This is fine if you are aware of it, and know that the items you have deleted are not on any of the sites you intend to target with the uSync files.

However if you delete an item locally, run a clean export and then use the resulting files to run an import on a site with the item on it you have deleted locally then uSync will not delete that item from the target site, as it has no way to know that you intended for the item to be deleted.