<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/FetchRequest/projectedValue",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI12FetchRequestV14projectedValueAA7BindingVyAC13ConfigurationVyx_GGvp"
  },
  "title" : "projectedValue"
}
-->

# projectedValue

A binding to the request’s mutable configuration properties.

```
@MainActor @preconcurrency var projectedValue: Binding<FetchRequest<Result>.Configuration> { get }
```

## Discussion

SwiftUI returns the value associated with this property when you use
[`FetchRequest`](/documentation/SwiftUI/FetchRequest) as a property wrapper on a [`FetchedResults`](/documentation/SwiftUI/FetchedResults) instance,
and then access the results with a dollar sign (`$`) prefix. The value
that SwiftUI returns is a [`Binding`](/documentation/SwiftUI/Binding) to the request’s
[`FetchRequest.Configuration`](/documentation/SwiftUI/FetchRequest/Configuration) structure, which dynamically
configures the request.

For example, consider the following fetch request for a type that the
<doc://com.apple.documentation/documentation/SwiftUI/loading-and-displaying-a-large-data-feed>
sample code project defines to store earthquake data, sorted based on
the `time` property:

```
@FetchRequest(sortDescriptors: [SortDescriptor(\.time, order: .reverse)])
private var quakes: FetchedResults<Quake>
```

You can use the projected value to enable a [`Table`](/documentation/SwiftUI/Table) instance to make
updates:

```
Table(quakes, sortOrder: $quakes.sortDescriptors) {
    TableColumn("Place", value: \.place)
    TableColumn("Time", value: \.time) { quake in
        Text(quake.time, style: .time)
    }
}
```

Because you initialize the table using a binding to the descriptors,
the table can modify the sort in response to actions that the user
takes, like clicking a column header.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)