# recipientProperties The criteria for recipients of the match request that Game Center uses to find other players when using matchmaking rules. ``` var recipientProperties: [GKPlayer : [String : Any]]? { get set } ``` ## Discussion Matchmaking rules may use these properties to improve matchmaking results and reduce wait times. You set rules in App Store Connect to find players that best match one or more of the recipient’s properties in a reasonable amount of time by loosening the criteria over time. This property contains key-value pairs where the keys are the recipient player objects and the values are the recipient’s properties. The recipient’s properties are key-value pairs with game-specific meanings where keys may be any string, except `gc`, which GameKit reserves. The values need to be types that the  class can convert to JSON data. ```swift // Create a match request. let request = GKMatchRequest() var invitedPlayer: GKPlayer // Set the matchmaking rules queue name. request.queueName = "com.example.mygame.SkillBasedQueue" // To balance matches by skill levels, add skill to the properties. request.properties = [ "skill": 11] // Set the recipients of this match request. request.recipients = [ invitedPlayer ] // Then set the skill levels of the recipients if known. request.recipientProperties = [ invitedPlayer: [ "skill": 10 ]] ``` If the player objects aren’t in the [`recipients`](/documentation/GameKit/GKMatchRequest/recipients) property, an error occurs. If this property is `nil`, matchmaking rules use the local player’s properties to find the best match instead. For hosted games, if you set this property, use the [`findMatchedPlayers(_:withCompletionHandler:)`](/documentation/GameKit/GKMatchmaker/findMatchedPlayers(_:withCompletionHandler:)) method to submit the match request so Game Center returns other player properties in the matchmaking results. If the [`queueName`](/documentation/GameKit/GKMatchRequest/queueName) property is `nil`, Game Center doesn’t use matchmaking rules and ignores the [`recipientProperties`](/documentation/GameKit/GKMatchRequest/recipientProperties) property. For more information, see [Matchmaking rules](/documentation/GameKit/matchmaking-rules). --- Copyright © 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)