UmbSocial.uSync
17.0.0-beta0454
dotnet add package UmbSocial.uSync --version 17.0.0-beta0454
NuGet\Install-Package UmbSocial.uSync -Version 17.0.0-beta0454
<PackageReference Include="UmbSocial.uSync" Version="17.0.0-beta0454" />
<PackageVersion Include="UmbSocial.uSync" Version="17.0.0-beta0454" />
<PackageReference Include="UmbSocial.uSync" />
paket add UmbSocial.uSync --version 17.0.0-beta0454
#r "nuget: UmbSocial.uSync, 17.0.0-beta0454"
#:package UmbSocial.uSync@17.0.0-beta0454
#addin nuget:?package=UmbSocial.uSync&version=17.0.0-beta0454&prerelease
#tool nuget:?package=UmbSocial.uSync&version=17.0.0-beta0454&prerelease
UmbSocial.uSync
uSync support for UmbSocial: move UmbSocial's setup between sites as uSync files, alongside your document types and content.
dotnet add package UmbSocial.uSync
It needs UmbSocial and uSync 17.6.2 or later (before 18).
What it syncs
UmbSocial's items appear on two cards on the uSync dashboard, each with its own Report, Import and Export.
| Item | Folder | uSync card |
|---|---|---|
| Channels | uSync/v17/UmbSocial/Channels |
UmbSocial Setup |
| UmbSocial's settings (posting schedule and page fields per document type) | uSync/v17/UmbSocial/Settings |
UmbSocial Setup |
| Campaigns | uSync/v17/UmbSocial/Campaigns |
UmbSocial Library |
When you import card by card, import UmbSocial Setup before UmbSocial Library: campaigns can point at channels. Import All does this already: it runs channels, then settings, then campaigns, after uSync's own handlers. Importing only the UmbSocial Setup card on a fresh site, before uSync's own Settings card, skips page fields for document types that aren't there yet: import uSync's Settings first, or import the UmbSocial Setup card again afterwards. On the first boot of a new site, run Import All, or import UmbSocial Setup and then UmbSocial Library. A channel that isn't on the target arrives without a connection and switched off: Settings › UmbSocial › Connections shows it as "Needs connecting", and the free edition's channel limit is checked when it is connected. The settings file is a snapshot that replaces the schedule and the page fields. Automate connections, the short-link base URL, the licence, posts, AI settings and "Post automatically" rules never sync.
The two cards are the defaults. To move a handler to another card, set its Group in appsettings.json (uSync's guide shows the shape for Dictionary items); the key is the handler alias. Aliases: umbSocialChannels and umbSocialSettings (UmbSocial Setup), umbSocialCampaigns (UmbSocial Library). For example, Campaigns on the UmbSocial Setup card:
{
"uSync": {
"Sets": {
"Default": {
"Handlers": {
"umbSocialCampaigns": {
"Group": "UmbSocial Setup"
}
}
}
}
}
}
Each item is one file, named after it, and keeps its key on every site, so posts and page mappings that point at it still do. A campaign that already exists on the target under another key, with the same name, is matched by name and keeps its own key (uSync reports it with a transfer.matched_by_name message).
Files are written when an item is saved, as uSync does for Umbraco's own items, and an item that is removed (or merged into another campaign) leaves a delete action. Nothing site-specific goes into the files.
Documentation
See docs.umb.social.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- UmbSocial.Core (>= 17.0.0-beta0454)
- uSync.BackOffice (>= 17.6.2 && < 18.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on UmbSocial.uSync:
| Package | Downloads |
|---|---|
|
UmbSocial.Pro.uSync
uSync support for UmbSocial Pro: move Pro's tags, hashtag groups, post templates and settings (per-channel schedules, UTM tagging, short links and approvals) between sites as uSync files, keeping their keys. Runs under your UmbSocial Pro or Agency licence. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 17.0.0-beta0454 | 0 | 11/17/2026 |
| 17.0.0-beta0450 | 0 | 11/17/2026 |
| 17.0.0-beta0444 | 0 | 11/17/2026 |
| 17.0.0-beta0442 | 0 | 11/17/2026 |
| 17.0.0-beta0441 | 52 | 11/16/2026 |