diff --git a/docs/queries/select.mdx b/docs/queries/select.mdx index b38def142..36d7bc560 100644 --- a/docs/queries/select.mdx +++ b/docs/queries/select.mdx @@ -137,6 +137,11 @@ export const Pages: CollectionConfig<'pages'> = { } ``` + + Important: + When using `defaultPopulate` on a collection with [Uploads](/docs/fields/upload) enabled and you want to select the `url` field, it is important to specify `filename: true` as well, otherwise Payload will not be able to construct the correct file URL, instead returning `url: null`. + + ## populate Setting `defaultPopulate` will enforce that each time Payload performs a "population" of a related document, only the fields specified will be queried and returned. However, you can override `defaultPopulate` with the `populate` property in the Local and REST API: