UmbSocial.Pro.uSync
17.0.0-beta0454
dotnet add package UmbSocial.Pro.uSync --version 17.0.0-beta0454
NuGet\Install-Package UmbSocial.Pro.uSync -Version 17.0.0-beta0454
<PackageReference Include="UmbSocial.Pro.uSync" Version="17.0.0-beta0454" />
<PackageVersion Include="UmbSocial.Pro.uSync" Version="17.0.0-beta0454" />
<PackageReference Include="UmbSocial.Pro.uSync" />
paket add UmbSocial.Pro.uSync --version 17.0.0-beta0454
#r "nuget: UmbSocial.Pro.uSync, 17.0.0-beta0454"
#:package UmbSocial.Pro.uSync@17.0.0-beta0454
#addin nuget:?package=UmbSocial.Pro.uSync&version=17.0.0-beta0454&prerelease
#tool nuget:?package=UmbSocial.Pro.uSync&version=17.0.0-beta0454&prerelease
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 withlicence.pro_requiredand 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 | 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.Pro (>= 17.0.0-beta0454)
- UmbSocial.uSync (>= 17.0.0-beta0454)
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 |