<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/comparing-app-versions",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Comparing app versions"
}
-->

# Comparing app versions

Return a Boolean value that indicates whether two match requests are from compatible app versions.

## Discussion

Use the `areCompatibleAppVersions()` function in the expression of a matchmaking rule to determine if the version of the games that request matches are compatible. This function uses information you enter in App Store Connect — such as the bundle ID, platform, and version properties to determine compatibility. For more information, see [Add multiplayer compatibility](https://developer.apple.com/help/app-store-connect/configure-game-center/add-multiplayer-compatibility).

### Declaration

```other
boolean areCompatibleAppVersions(object $request1, object $request2)
```

### Parameters

-`request1`: A match request to compare with `request2`.
-`request2`: A match request to compare with `request1`.

### Return value

`true`, if the game instances that request a match are compatible; otherwise, `false`.

---

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)