---
title: "rematch(completionHandler:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkmatch/rematch(completionhandler:)"
---

# rematch(completionHandler:)

Creates a new match with the players from an existing match.

## Declaration

```swift
func rematch(completionHandler: (@Sendable (GKMatch?, (any Error)?) -> Void)? = nil)
```

```swift
func rematch() async throws -> GKMatch
```

## Parameters

- `completionHandler`: The block that GameKit calls when it completes the request. The block receives the following parameters:

## Discussion

Discussion This method uses automatching to recreate a previous match. If you use this method to create a match, each instance of your game on each device should call this same method.

## See Also

### Finishing the match

- [disconnect()](gamekit/gkmatch/disconnect().md)