---
title: percentEncodedQueryItems
framework: foundation
role: symbol
role_heading: Instance Property
path: foundation/urlcomponents/percentencodedqueryitems
---

# percentEncodedQueryItems

The query subcomponent, as an array of percent-encoded query items.

## Declaration

```swift
var percentEncodedQueryItems: [URLQueryItem]? { get set }
```

## Discussion

Discussion The setter combines an array containing any number of URLQueryItem key-value pairs into a query string and sets the URLComponents query property. This property assumes the query item names and values are already correctly percent-encoded. It also assumes that the query item names don’t contain the query item delimiter characters & and =. Attempting to set an incorrectly percent-encoded query item or a query item name with the query item delimiter characters & and = raises fatalError(_:file:line:).

## See Also

### Accessing components in URL-encoded format

- [percentEncodedFragment](foundation/urlcomponents/percentencodedfragment.md)
- [percentEncodedHost](foundation/urlcomponents/percentencodedhost.md)
- [percentEncodedPassword](foundation/urlcomponents/percentencodedpassword.md)
- [percentEncodedPath](foundation/urlcomponents/percentencodedpath.md)
- [percentEncodedQuery](foundation/urlcomponents/percentencodedquery.md)
- [URLQueryItem](foundation/urlqueryitem.md)
- [percentEncodedUser](foundation/urlcomponents/percentencodeduser.md)