[unstable option] `imports_granularity`

Tracking issue for unstable option: imports_granularity.

Option documentation.

See Processes.md, "Stabilising an Option":

• Is the default value correct?
• The design and implementation of the option are sound and clean.
• The option is well tested, both in unit tests and, optimally, in real usage.
• There is no open bug about the option that prevents its use.
  • #5269
  • #6028
  • #6027
  • https://github.com/rust-lang/rustfmt/issues/6666
  • https://github.com/rust-lang/rustfmt/issues/6717
  • https://github.com/rust-lang/rustfmt/issues/6191
  • #5030
  • #4681
  • #5253
  • https://github.com/rust-lang/rustfmt/issues/6164
  • #5311
  • #5296
  • #4406
  • #4536
  • #3984
  • #3999
  • #6195
  • #6241
  • #6243

How can I help?

We all want this feature merged, and it seems easy enough, but (as with many problems in mature software projects) it's not so simple as writing a few lines of code. Please abstain from leaving "how can I get this stabilized" comments.

See @Manishearth's excellent comment below https://github.com/rust-lang/rustfmt/issues/4991#issuecomment-3369792412, up-to-date as of August 2026:

Basically:

• There are open issues that need work. Some need design discussion.
• There are open PRs for some of the issues [e.g., #6028 needs to be iterated on further], however the rustfmt team is heavily backlogged on review, and reviews for unstable features are low priority. Community reviews of such PRs are appreciated, but ideally you can get involved on zulip and help the team with other things too.

In general until the rustfmt team is healthy enough to sustain regular maintainance work it is unlikely that we shall see progress on unstable features.

Start with the imports_granularity option documentation and Processes.md, especially “Stabilising an Option.” Review the unchecked blocking issues listed in the tracker, including #6028, #6027, #6666, #6717, #6164, #5296, #6195, and #6241. Done means the outstanding blockers are addressed so the stabilization criteria can be completed.