UmbSocial.Pro.uSync 17.0.0-beta0454

This is a prerelease version of UmbSocial.Pro.uSync.
dotnet add package UmbSocial.Pro.uSync --version 17.0.0-beta0454
                    
NuGet\Install-Package UmbSocial.Pro.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.Pro.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.Pro.uSync" Version="17.0.0-beta0454" />
                    
Directory.Packages.props
<PackageReference Include="UmbSocial.Pro.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.Pro.uSync --version 17.0.0-beta0454
                    
#r "nuget: UmbSocial.Pro.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.Pro.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.Pro.uSync&version=17.0.0-beta0454&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=UmbSocial.Pro.uSync&version=17.0.0-beta0454&prerelease
                    
Install as a Cake Tool

UmbSocial Pro uSync

uSync support for UmbSocial Pro: move Pro's setup between sites as uSync files, alongside your document types and content.

dotnet add package UmbSocial.Pro.uSync

It brings in UmbSocial.uSync (the free package, for campaigns, channels and UmbSocial's own settings). It needs UmbSocial Pro and uSync 17.6.2 or later (before 18), and runs under your UmbSocial Pro or Agency licence: without one, an import does nothing and reports that Pro is required.

What it syncs

Pro's items appear on the same two cards of the uSync dashboard as the free ones ("UmbSocial Setup" and "UmbSocial Library"), with the same Report, Import and Export.

Item Folder uSync card
Post tags uSync/v17/UmbSocialPro/Tags UmbSocial Library
Hashtag groups uSync/v17/UmbSocialPro/Hashtags UmbSocial Library
Post templates uSync/v17/UmbSocialPro/Templates UmbSocial Library
Pro's settings: per-channel schedules, UTM tagging, short links (on or off, and the path), approvals uSync/v17/UmbSocialPro/Settings UmbSocial Setup

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: umbSocialProSettings (UmbSocial Setup), umbSocialProTags, umbSocialProHashtags and umbSocialProTemplates (UmbSocial Library). For example, templates on uSync's own Content card:

{
  "uSync": {
    "Sets": {
      "Default": {
        "Handlers": {
          "umbSocialProTemplates": {
            "Group": "Content"
          }
        }
      }
    }
  }
}

Each tag, hashtag group and template is one file named after it, and keeps its key on every site. An item 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). A template that names a campaign, channel or document type the target doesn't have is imported without it, with a message naming what was left out.

Files are written when an item is saved, and a deleted item leaves a delete action. Nothing site-specific goes into the files: no short-link base URL, no Automate connection, no tag or hashtag use counts and no user.

Four things to know:

  • An imported template has no owner, so only people who can manage UmbSocial's settings can change it.
  • Per-channel schedules list every channel of the source, one without slots of its own with none. On import, each listed channel the target has gets the file's slots (so none clears its own); a channel only the target has keeps its slots.
  • An import during first boot (uSync's ImportOnFirstBoot) or at startup (ImportAtStartup) can run before the Pro licence is checked, so Pro's items are refused with licence.pro_required and the rest of UmbSocial's import carries on. Once the site is up, run Import All, or Import on both the UmbSocial Setup and UmbSocial Library cards of the uSync dashboard (Settings first).
  • Import All runs UmbSocial's handlers after uSync's own, the Settings card's items before the Content card's. When you import card by card, import UmbSocial Setup before UmbSocial Library. Importing UmbSocial's cards on a fresh site before uSync's own Settings card drops templates' document types (and UmbSocial's page fields) that aren't there yet: import uSync's Settings first, or the UmbSocial Setup card again afterwards.

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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
17.0.0-beta0454 36 11/17/2026
17.0.0-beta0450 32 11/17/2026
17.0.0-beta0444 36 11/17/2026
17.0.0-beta0442 42 11/17/2026
17.0.0-beta0441 53 11/16/2026