﻿id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
34337	Documentation for custom related managers is contradictory	Adam Alton	nobody	"In the [section of the ""Managers"" documenation about base managers](https://docs.djangoproject.com/en/4.1/topics/db/managers/#django.db.models.Model._base_manager), it says:

> By default, Django uses an instance of the Model._base_manager manager class when accessing related objects

and then two paragraphs further down it says:

> Base managers aren’t used when querying on related models

What? So Django uses a base manager for related objects, but base managers aren't used for related objects?! I checked with a colleague and they couldn't make sense of it either.

It's unclear how to specify a custom manager which would be used for related object lookups. The section above about default managers doesn't give any clarifcation either.

I seem to remember that there used to be an attribute on the `Manager` class called `use_for_related_objects`, but looking in the Django source code I can't see any reference to that anymore.

I would open a pull request to update the docs, but I'm genuinely not sure what the behaviour is!"	Bug	closed	Documentation	4.1	Normal	duplicate		Carlton Gibson	Unreviewed	0	0	0	0	0	0
