> For the complete documentation index, see [llms.txt](https://horizongames.gitbook.io/kronos-matchmaking/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://horizongames.gitbook.io/kronos-matchmaking/usage/matchmaking/sending-match-invites.md).

# Sending Match Invites

In order to access online features, the player must be logged in with the **Online Subsystem**. Please visit the [**Authentication**](/kronos-matchmaking/usage/authentication/authenticating-users.md) page for more information.

## Invite Players To The Match <a href="#classes" id="classes"></a>

There are two ways to invite players into a match.

### External Invite UI

This invite method uses the online platform's own invite UI (e.g. **Steam Overlay**) to send party invites. Simply use the `ShowGameInviteUI` to make the external invite UI appear. This is the easiest, most convenient way of handling invites because this way you do not have to set up your own widgets and query friends list. When the user accepts the invite, they will join the game automatically.

{% tabs %}
{% tab title="Blueprint" %}

<figure><img src="/files/oYysECFfGgsj1JSzxtbY" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="C++" %}

```cpp
#include "KronosStatics.h"
```

```cpp
// Show the external invite UI for game sessions (e.g. Steam Overlay).
// Note that not all Online Subsystems support this.
UKronosStatics::ShowGameInviteUI();
```

{% endtab %}
{% endtabs %}

### In-Game Party Invite

You can also use the `SendGameInviteToFriend` function in `KronosStatics`. This function requires the unique id of the friend you want to invite. You can get a list of online friends via the `ReadUserFriendsList` node.

{% hint style="warning" %}
**NOTE:** The Steam Online Subsystem does not have the necessary callbacks registered for when an invite is received which means that an in-game "invite received" popup cannot be implemented currently. The invite must be accepted through the Steam Overlay.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://horizongames.gitbook.io/kronos-matchmaking/usage/matchmaking/sending-match-invites.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
