Skip to main content
Version: v16.x - Umbraco 16

appsettings.config

The majority of these settings will have default values that do not need to be changed.

appsettings.json
{
"uSync": {
"Settings": {
"AddOnPing": true,
"BackgroundNotifications": false,
"CacheFolderKeys": true,
"CustomMappings": {},
"DefaultExtension": ".config",
"DefaultSet": "Default",
"DisableDashboard": false,
"EnableHistory": true,
"ExportAtStartup": "None",
"ExportOnSave": "All",
"FailOnDuplicates": false,
"FailOnMissingParent": false,
"FirstBootGroup": "all",
"Folders": ["uSync/root","uSync/v16"],
"HideAddOns": false,
"HistoryFolder": "uSync/history",
"ImportAtStartup": "None",
"ImportOnFirstBoot": false,
"IsRootSite": false,
"LockRoot": false,
"LockRootTypes": "",
"MoveToSection": true,
"ReportDebug": false,
"ShowVersionCheckWarning": true,
"UiEnabledGroups": "All",
},
"Sets": {
"Default": {
"DisabledHandlers": [],
"Enabled": true,
"Handlers": {},
"HandlerGroups": [],
"HandlerDefaults": {
"Actions": [],
"Enabled": true,
"FailOnMissingParent": false,
"Group": "",
"GuidNames": false,
"Settings": {},
"UseFlatStructure": true
}
}
}
}
}

uSync:Settings

AddOnPing

Ping the jumoo.co.uk website to check for addons and updates.

"Settings": {
"AddOnPing": true,
}

BackgroundNotifications

Run all notifications on background thread to speed up import processing, see Background Notifications

"Settings": {
"BackgroundNotifications": false,
}

CacheFolderKeys

Use a cache for the names and keys of folders during import. This increases import speeds.

"Settings": {
"CacheFolderKeys": true,
}

CustomMappings

Custom item mappings for 3rd party or custom property editors.

"Settings": {
"CustomMappings": {},
}

DefaultExtension

Default file extension for the uSync files.

"Settings": {
"DefaultExtension": ".config",
}

DefaultSet

Name of the handler set used by default.

"Settings": {
"DefaultSet": "Default",
}

DisableDashboard

Disable the default dashboard (so people can't accidentally press the buttons).

"Settings": {
"DisableDashboard": false,
}

EnableHistory

Enable viewing the import and export history in the uSync dashboard.

"Settings": {
"EnableHistory": true,
}

ExportAtStartup

Handler groups used when exporting items at startup. This is a Group Value.

"Settings": {
"ExportAtStartup": "None",
}

ExportOnSave

Handler groups whose items will be exported when changes are saved in Umbraco. This is a Group Value.

"Settings": {
"ExportOnSave": "All",
}

FailOnDuplicates

Fail if a duplicate file of same type and key is detected during the import process.

"Settings": {
"FailOnDuplicates": false,
}

FailOnMissingParent

Should an import fail if the parent of an item is missing.

"Settings": {
"FailOnMissingParent": false,
}

FirstBootGroup

Handler group(s) to run on first boot. Default is All (i.e full import). This is a Group Value.

"Settings": {
"FirstBootGroup": "all",
}

Folders

Collection of folders uSync looks in when performing imports. uSync merges these folders together, for more info look at uSync Roots.

"Settings": {
"Folders": ["uSync/root/","uSync/v16"],
}

HideAddOns

List of addon (tabs) you don't want to show inside uSync dashboard.

"Settings": {
"HideAddOns": false,
}

HistoryFolder

Location of the history folder.

"Settings": {
"HistoryFolder": "uSync/history",
}

ImportAtStartup

Handler groups used when importing items at startup. This is a Group Value.

"Settings": {
"ImportAtStartup": "None",
}

ImportOnFirstBoot

Import the uSync folder on the first boot.

"Settings": {
"ImportOnFirstBoot": false,
}

IsRootSite

Sets this site to be the root site (so it will save into "uSync/root/").

"Settings": {
"IsRootSite": false,
}

LockRoot

When locked, you can't make changes to anything that is in the root.

"Settings": {
"LockRoot": false,
}

LockRootTypes

Lock specific types at root so they can't be changed in child sites.

Specific types such as: document, media, member, dictionary-item, macro, template, document-type, media-type, data-type, member-type, member-group, relation-type forms-form, forms-prevalue, forms-datasource, and language.

"Settings": {
"LockRootTypes": "",
}

MoveToSection

Add the "synchronisation" setting to Umbraco. Then you can move the uSync tree into its own section of the backoffice. This will give access to people who don't have settings access.

"Settings": {
"MoveToSection": true
}
note

You will have to add this section to the list of allowed sections for the groups that can access uSync (including the admin group).

warning

Access to uSync means a user can import changes to your site that would usually only be possible if they had settings access. This means that moving uSync to a new section and removing settings access is not reducing the level of control a user may have over your site. They retain full access to what uSync will let them do, just without the settings UI.

ReportDebug

Create a report while producing an export (debugging only).

"Settings": {
"ReportDebug": false,
}

ShowVersionCheckWarning

Display the warning box if the current import is from an older version of uSync.

"Settings": {
"ShowVersionCheckWarning": true,
}

UiEnabledGroups

Handler groups that show in the uSync dashboard. This is a Group Value.

"Settings": {
"UiEnabledGroups": "All",
}

uSync Handler Settings

The default handler set is called default. These settings are for that handler set, for more information on handler sets go to our selectable sets page.

"Sets": {
"Default": {
"DisabledHandlers": [],
"Enabled": true,
"Handlers": {},
"HandlerGroups": [],
"HandlerDefaults": {
"Actions": [],
"Enabled": true,
"FailOnMissingParent": false,
"Group": "",
"GuidNames": false,
"Settings": {},
"UseFlatStructure": true
}
}
}

DisabledHandlers

List of handlers to disable for this set.

Enabled

Turn on the handler set.

HandlerGroups

List of handler groups to include in this set.

uSync Handler Settings

Default settings for the handler, these values can be overridden for individual handlers.

Actions

List of actions for which the handler is valid. This is an Action Value.

Enabled

Enable or disable the handler.

FailOnMissingParent

Should an import fail if the parent of an item is missing.

Group

Override the group used for a handler.

GuidNames

Should uSync use the guid of an item as its file name. This ensures there are no clashes in names, but makes it harder to manually read what settings are in a folder.

Settings

Specific settings for each handler, this will override the defaults.

UseFlatStructure

Use a flat file structure for the file produced by the handler.

Group Values

Group values can be None, All or any Settings group that you have installed on your site. The default groups are 'Settings' and 'Content'.

Group values can be a combination of settings groups (but all or none will override any other groups set in a list)

NameDetails
NoneNo groups, effectively off.
AllAll groups, everything on.
SettingsSettings only (e.g Datatypes, doctypes).
ContentContent only (e.g media, content).
FormsUmbraco Forms elements.
UsersUsers and groups.
MembersMembers and groups.

Action Values

Actions values determine which 'actions' a handler fires for. The handler action value can be a combination of any of the actions below.

NameDetails
ReportReport any changes to items.
ImportImport items.
ExportExport items when started via dashboard.
SaveExport items on save.
AllAll of the above actions.

The default value is all actions.

For Handler Settings, see the Handler Docs.