Skip to content

Umbraco Marketplace

The Umbraco Marketplace is where Umbraco users discover packages. The listing is controlled by two files in the repo root.

Controls the listing metadata. Key fields to maintain:

Field Purpose Notes
Title Display name on marketplace Currently “UmBootstrap”
VersionSpecificPackageIds Maps Umbraco versions to package IDs Add a new entry for each major Umbraco version
AuthorDetails Author info and contributors SyncContributorsFromRepository auto-pulls from GitHub
Screenshots Listing images URLs to images (use raw GitHub URLs)
DocumentationUrl Link to docs site Points to the Starlight docs
IssueTrackerUrl Link to issue tracker Points to GitHub Issues

Rendered as the package description on the marketplace. The marketplace checks for this file in the repo root — if not found, it falls back to the NuGet package README.

The marketplace README has specific constraints:

  • It must include a warning that the marketplace install buttons don’t support dotnet new template packages — users must follow the CLI or Visual Studio instructions instead
  • Keep it in sync with README.md (the GitHub version), adding marketplace-specific warnings where needed
  • Images must use absolute URLs (raw GitHub URLs from the develop branch)

See READMEs for the full picture of how the three READMEs are managed.

The marketplace checks for updates automatically:

Check Interval
New packages Every 24 hours (0400 UTC)
Package info refresh Every 2 hours
Download counts Every 1 hour

No manual step is needed after publishing to NuGet.

Use the marketplace validation tool to:

  • Check your umbraco-marketplace.json is valid before publishing
  • Force a sync if you don’t want to wait for the automatic interval