FAQ

This page provides answers to the most common questions about Upbound Official Providers.

Questions

Yes. The Official Provider pull policy only applies to Official Providers published after March 25, 2025.

Yes. The guidance shared in the documentation recommends anonymous or Individual tier users to use the convenience tags for Official Providers. For example:

crossplane xpkg install provider xpkg.upbound.io/upbound/provider-aws-s3:v1 

However, you may choose to still reference the latest release by full major.minor.patch tag scheme:

crossplane xpkg install provider xpkg.upbound.io/upbound/provider-aws-s3:v1.19.0 

For customers with a subscription to Upbound, you’re encouraged to use a pinning-and-update strategy based on the full tag scheme that makes sense for you.

Upbound advises anonymous and Individual tier users to use the vMajor tag scheme. It’s durable to the change that occurs monthly when a new version of Official Providers gets released.

Some Upbound Official Providers are downstream builds of provider source which exists upstream in crossplane-contrib. Provider-aws is an example.

While the providers share a common source, Upbound supplements Official Providers by building from a private pipeline that supplements Official Provider images with additional value-add. The community providers are free-use images built and published by the Crossplane community. Official Providers are built and published by Upbound, and have a commercial license.

Yes. Upbound’s policy doesn’t prohibit the use of an artifact registry to mirror Official Provider releases.

Yes, however, it’s only the latest release that can be pulled anonymously. When a new release N is published, access is cut off from the N-1 for anonymous and Individual tier users.

Use the community-built, free access releases of providers published to crossplane-contrib. If you’re not interested in a subscription, you should use the new releases of the same provider source published under the crossplane-contrib org, available on both the Upbound Marketplace (xpkg.upbound.io) and xpkg.crossplane.io.

The policy is currently geared towards Official Providers, but there are other package types currently published by Upbound: Configurations, Functions, and more to come.

We don’t have plans to roll out policy changes for other package types right now. We’re committed to not breaking users who’re taking dependencies on things like function-patch-and-transform. Official packages must be published by Upbound under the upbound org on the Marketplace.

Any package–whether a function, provider, etc.–whose source exists in upstream crossplane-contrib must comply with Crossplane governance policies and have public, free builds available for use by the community. That includes repos where Upbound is the maintainer.