UmbSocial.uSync 17.0.0-beta0454

This is a prerelease version of UmbSocial.uSync.
dotnet add package UmbSocial.uSync --version 17.0.0-beta0454
                    
NuGet\Install-Package UmbSocial.uSync -Version 17.0.0-beta0454
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="UmbSocial.uSync" Version="17.0.0-beta0454" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="UmbSocial.uSync" Version="17.0.0-beta0454" />
                    
Directory.Packages.props
<PackageReference Include="UmbSocial.uSync" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add UmbSocial.uSync --version 17.0.0-beta0454
                    
#r "nuget: UmbSocial.uSync, 17.0.0-beta0454"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package UmbSocial.uSync@17.0.0-beta0454
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=UmbSocial.uSync&version=17.0.0-beta0454&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=UmbSocial.uSync&version=17.0.0-beta0454&prerelease
                    
Install as a Cake Tool

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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