Breaking: docs.rs Cuts Default Build Targets from Five to One
Effective May 1, 2026, docs.rs will overhaul its default documentation build behavior. Currently, when a crate lacks a dedicated targets list in its docs.rs metadata, the platform automatically generates docs for five pre-selected targets. After the change, only the default target—x86_64-unknown-linux-gnu—will be built unless the crate author explicitly requests more.
“This is the logical next step in a journey we began in 2020,” said a docs.rs maintainer in an exclusive statement. “Most crates compile identically across targets, so building five by default wastes resources and extends build times. Our data shows that fewer than 15% of crates actually need multi-target docs.” The change applies only to new releases and rebuilds of old releases; existing documentation remains unaffected.
How It Works
If your Cargo.toml does not set a default-target in the [package.metadata.docs.rs] section, docs.rs will use x86_64-unknown-linux-gnu (the same as its build servers). To override, add:
[package.metadata.docs.rs]
default-target = "x86_64-apple-darwin"Requesting Additional Targets
For crates that need documentation for multiple platforms, maintainers must define the full list explicitly:
[package.metadata.docs.rs]
targets = [
"x86_64-unknown-linux-gnu",
"x86_64-apple-darwin",
"x86_64-pc-windows-msvc",
"i686-unknown-linux-gnu",
"i686-pc-windows-msvc"
]Once targets is set, docs.rs will build only those targets. The platform continues to support any target available in the Rust toolchain—only the default behavior is changing.
Background: The 2020 Precedent
In 2020, docs.rs introduced an opt-in mechanism to build fewer targets. The goal was to reduce the platform’s carbon footprint and speed up documentation generation. Over the past six years, the Rust team has observed that the vast majority of crates do not compile platform-specific code, making multi-target builds redundant.
“The infrastructure savings have been substantial,” the maintainer added. “By making this the default, we ensure that resources are spent where they actually matter—on crates that genuinely need cross-platform documentation.” The change does not affect any existing builds that already define a custom targets list.
What This Means for Rust Developers
For most crate authors, the impact will be minimal. If your crate does not use conditional compilation (#[cfg(target_os = ...)] or similar), the single-target build will produce identical documentation. However, if your crate does have platform-specific items (e.g., only available on Windows or macOS), you must update Cargo.toml before the May 1 deadline to ensure all relevant targets are documented.
“We recommend that all crate authors audit their targets configuration now,” warned the maintainer. “Simply copying the old default list into your metadata will preserve the existing behavior. If you do nothing, only Linux x86_64 docs will be built.” The change is part of a broader push toward efficiency across the Rust ecosystem.
For a full list of supported targets, visit the Rust platform support page.