Skip to content

removing and adding stuff #137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
daisy-jump merged 1 commit into from
Jan 8, 2026
Merged

removing and adding stuff #137

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 23 additions & 16 deletions usync/02.complete/03.guides/01.syncPublisher/02.publishConfig/01.config.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,12 +48,15 @@ While most settings are now stored in the DB, there are a few settings you can c
"SystemExclusions" : "",
"FileReplacements" : "",
"IncludeHost" : true,
"ForstHostOption" : false,
"ForceHostOption" : false,
"UserAgentString" : "",
"RequestHeaders" : {
"header one": "custom value",
"header two": "custom value two"
},
"AllowDeletingOfOrphanedItemsForAllTypes" : false,
"AllowDeletingOfOrphanedItemsForTypes" : false,
"AllowDeletingOfOrphanedItemsFromRoot" : false,
}
}
}
Expand Down Expand Up @@ -93,9 +96,6 @@ How many items are in a 'page' of data sent between servers.
<!--| 5 |-->
How many media items are in a 'page' of data sent between servers, as media is compressed and sent in pages between servers changing this value will change the size of those compressed files.

### EnableRollback
A rollback folder will be created for each sync, ensuring a backup if it all goes wrong.

### AdditionalFolders
<!-- | ~/Views, ~/wwwroot/css, ~/wwwroot/scripts |-->
List of folders to include.
Expand All @@ -110,15 +110,6 @@ Things to exclude from system.
### FileReplacements
Things that might be replaced inside a file.

### RenameUsingAssembly
Do we rename any instances of your site name in the viewimports file. This setting is on by default.

### MaxRequestBodySize
Maximum request size. The default is 500mb, if you set it to zero there is no limit.

### RequestTimeout
Timeout for http requests in seconds.

### IncludeHost
<!--| true/false |-->
If the hostname is included as part of the signature when signing requests between sites. Turning this value off may make it possible to replay requests on another server.
Expand All @@ -130,9 +121,6 @@ If true uSync will require a hostname as part of the sync.
### UserAgentString
Set the user agent string.

### SeedServerUrl
This setting is the equivalent of clicking the 'sync' button on a site, but as a pull. All server settings will be pulled from the other site.

### RequestHeaders
Add your own custom header key pairs that will get added to every request.

Expand All @@ -148,6 +136,15 @@ Add your own custom header key pairs that will get added to every request.
Use of this setting could badly break your site. We **do not** advise turning it on unless you are 100% sure you know what you're doing.
:::

```json
"Publisher": {
"Settings": {
"AllowDeletingOfOrphanedItemsForAllTypes":
["document-type", "media-type"]
}
}
```

Enabling this setting allows you to remove 'missing' datatypes and doctypes. However, this could have a knock-on effect of **removing *all* associated content and media from your site.** We strongly advise you do not enable it.

This setting is set to false by default.
Expand All @@ -164,6 +161,7 @@ This setting is set to false by default.
"AllowDeletingOfOrphanedItemsForTypes":
["document-type", "media-type"]
}
}
```
Content and media types always have the 'delete missing' feature available. Enabling this setting turns the 'delete missing' feature on for additional [EntityTypes](https://github.com/umbraco/Umbraco-CMS/blob/contrib/src/Umbraco.Core/Constants-UdiEntityType.cs) for the Umbraco objects. When pushing these extra objects, uSync will delete orphaned items.

Expand All @@ -175,6 +173,15 @@ As with a lot of settings that permit automatic deleting, enabling this can badl
Incorrect use of this setting could delete whole sites from your installation. We **do not** advise turning it on unless you are 100% sure you know what you're doing.
:::

```json
"Publisher": {
"Settings": {
"AllowDeletingOfOrphanedItemsFromRoot":
["document-type", "media-type"]
}
}
```

Enabling this setting allows uSync to remove orphaned items from the root of your site. This can lead to the deletion of your **entire site**, and we *highly* reccomend you do not enable it.

This setting is set to false by default.
Expand Down