>_ MATCHKEEP

Matchkeep guide.

Short instructions for your next task. Full reference below.

What would you like to do?

Join and report a game
  1. Find an event or open your host’s invite. Sign in and submit your player details.
  2. Check your signup status. A request or waitlist entry needs host approval before you can play.
  3. Open your pairing and choose Report result. For player-arranged events, choose Report battle and select who you played. Submit the outcome and any required scores.
  4. Host-reviewed reports enter standings after approval. Use a correction request if a recorded result is wrong.
Open My Events
Create a standalone event
  1. Create event: enter its name and game, then add a venue and start date if known.
  2. Choose the event type and format, then how players sign up. Additional settings holds optional rules.
  3. Create draft, review the player page, then Publish event. Share its signup link from Players.
  4. With at least two approved players, Start competition. In Host, Generate pairings, review the draft and Publish pairings.
Create event
Create an organization
  1. Create organization with the public name players recognize. Add a description and venue if useful.
  2. Use Additional settings for public contact, website, cover and time zone.
  3. Create the organization, then use its settings cog to manage events and organizers. Its Discord icon opens server and event-channel settings.
Create organization
Publish an organization event
  1. Choose + Org Event on an organization card in Organizations, or open its settings cog and use + Org Event beside Events.
  2. The organization’s venue and time zone are inherited. Choose the event name, game, format and signup access.
  3. Create draft, review, then Publish event. A public event listed on the organization appears on its public page and calendar.
Open organizations

Reference

Formats and pairingsCompare formats, round counts and how opponents are chosen.

Choose a format for a new event

Round robin

Players meet once per full cycle. Hosts can choose a shorter schedule and the schedule avoids repeat opponents when possible.

Points league

Uses a round-robin schedule, with standings points for wins, draws, and losses. Battle points can break ties.

Swiss

Each round pairs players with similar records. Repeat opponents are avoided where possible and hosts review pairings before publishing.

Single elimination

A loss removes a player from the bracket. Winners advance; a bye may move a player forward without a match.

Double elimination

Players leave the bracket after two losses. Winners and lower brackets lead to the final, which may need a reset match.

Ladder

Players compete for ranked positions. A win can move the winner above the opponent.

Custom / manual

Hosts choose the structure and create pairings themselves while keeping Matchkeep's roster, result, and standings tools.

Pairing approaches

Automatic

Matchkeep generates opponents using the chosen format and event history.

Host assigned

The host assigns opponents or randomizes eligible players, then reviews and publishes the draft.

Players report their own battles

For supported formats, the host opens a round. Players select who they played and submit the result in one form.

Player-arranged pairings are offered only for formats that support them. You can change the approach for a later round after the current round is finished.

Running an eventPublish, manage players, start competition, review pairings and results.
  1. 01

    Create the event

    From your dashboard, select Create event. Enter an event name and game, choose League or Tournament, and optionally add a description. Pick public visibility to appear in event search, or private visibility to keep the event unlisted and share it by link.

  2. 02

    Set the schedule and format

    Choose a supported format and pairing approach, then set dates, time zone, planned rounds, and round length. For round robin, choose a full cycle or the planned shorter schedule. Starting player order can follow the roster or be randomized.

  3. 03

    Set signup and scoring rules

    Set a player limit, optional signup approval and waitlist, points awarded for wins/draws/losses, optional battle-point tie-breaks, and result settings. Review controls whether results affect standings automatically or after host approval. Publication controls when players can see a result.

  4. 04

    Create once and review

    Select Create draft after Registration to save your setup and prepared players. Review the real player page, then select Publish event. You can return to previous steps to edit the same unpublished event. Review pending registrations, approve players if needed, and manage the roster from Manage players from the event card’s three-dot menu in My Events. The event needs at least two approved players before its first round can start.

  5. 05

    Start competition, then publish pairings

    Publish event publishes without starting play or pairing players. Later, Start competition closes signups and enables round management. In Host, choose Generate pairings to create a draft. Use Shuffle draft pairings to try another arrangement, then Publish pairings when ready. Later rounds are generated separately and also remain drafts until published. Hosts can swap opponents in unplayed matches, advance before all reports arrive, return to a previous round while keeping match records, and edit reported results with an audit trail.

Open an event from My Events

Entry fees and payments

Set an optional USD entry fee in Additional settings during creation or Event settings. Connect Stripe from Account → Event payments; organization events use the organization owner’s connected account. Approved players pay from the event page. Registration and payment are tracked separately. The creator can issue full refunds in Event settings → Entry fees and payments; manage partial refunds, payouts and disputes in Stripe. Fees lock after the first checkout starts. Test mode collects no real money.

Event access and signups

Choose public (discoverable) or private (unlisted) visibility, a player limit, host approval, and an optional waitlist. Open or close signups, share the signup link, or add players manually; hosts can also approve, waitlist, or drop roster entries.

People and permissions

The owner can give an existing Matchkeep user co-host access to manage the event or viewer access to read member pages. Co-hosts can help with event settings, rounds, and results.

Schedule and pairings

Set dates, time zone, round length, opening player order, and the pairing approach. For player-arranged events, open the round so players can report who they played and the result.

Scoring and result review

Set win, draw, and loss standings points; choose optional battle-point tie-breaks and visible standings columns. Decide whether reports apply automatically or wait for host review, and whether players see results immediately or after the round.

Roster and reports

Add text or number fields for event-specific roster details and result reports. Each player can hide or show their own name on public event pages from their roster entry.

Player view and event records

Choose which sections appear in the event page and preview that view. Hosts can edit the bulletin, review change history, customize event rules and download an event CSV.

Corrections and adjustments

Review player corrections, edit eligible results with a reason, or make standings adjustments with a recorded history. Knockout results use the correction flow to protect bracket advancement.

OrganizationsCreate a public calendar, inherit venue defaults and manage your team.
  1. 01

    Create your organization

    Choose Create organization. Enter the public store, organization or organizer name, then optionally add public contact name and email, website, and physical venue details. Your public contact details and location are visible to anyone. The public page address is based on the organization’s URL slug. Use Add organization to add another organization.

  2. 02

    List events on your organization

    When creating an event, associate it with an organization and optionally select List this event on the organizer’s public Matchkeep page. The organization’s venue and time zone fill in automatically and can be edited for that event. A listed event must also have Public visibility; private events stay off the organizer page. Hosts can change the association and listing later in Players → Additional settings → Signup policy.

  3. 03

    Choose how signups work

    Each event can confirm player signups automatically or require host approval. Set a player limit and optional waitlist. The public page shows registration availability, schedule, venue and format. Player names are not listed there.

  4. 04

    Manage and embed your calendar

    Open Organizations to manage your organizations. The cog opens Organization Settings; Additional settings contains Organization details, Organizers, and Sharing and connections for embedding the calendar. Public page opens the organization page; the share icon copies its link. The Discord icon on the organization card opens Discord connection settings.

Organizations and event listings are public. Only events explicitly listed on an organization and set to Public visibility appear there; private events and player names are not listed.

Playing and reportingFind your signup status, report a result and request a correction.

Find an event and sign up

Use Find events to browse public events accepting players, or use your host’s direct signup link for an unlisted event. Sign in with Google or email and password, enter the requested player details, and check the event page for your signup status. If approval is required, the host must approve you before you can be paired.

Check the event page

Open the event page to see available event information, pairings, results, standings, schedule, and host bulletin. Use the round selector to choose a round, then open its match details to review results. Hosts choose which sections to display. Times are shown for your local time zone alongside the event time zone.

Report a match

Open your pairing and submit the outcome and each player’s battle points. In player-arranged events, choose Report battle and select who you played in the same form. If the event uses host review, the report stays out of official standings until approved. If you disagree with a result that is already recorded, submit a correction with an explanation for the host to review.

Choose your player visibility

Player names are public by default. On your roster entry, use Hide from public to hide your name in public-facing event information; choose Show publicly to restore it. Discord pairings and standings also honor this setting.

Your dashboard brings your events and upcoming scheduled matches together. Visit Account to manage sign-in options and your Discord account connection.

Discord connectionsConnect your account, organizer server and event channel.
  1. 01

    Install Matchkeep in the server

    From the event’s Event settings page, opened from its three-dot card menu in My Events, open Discord sharing and select Add Matchkeep to Discord. A server administrator approves the install. The bot needs permission to view and send messages in the event channel. To publish Scheduled Events, grant it Create Events too; if Matchkeep was installed before that permission was added, authorize the updated install link again.

  2. 02

    Connect your organization

    Open Organizations → Discord icon, create a link code, then run /matchkeep link-profile with that code in the server. The one-time code expires after 10 minutes. Organization events can then only be linked to channels in that server. Owners and managers can use Post upcoming events in that same modal to share up to 10 public upcoming events, their signup links and the full organization calendar in a chosen text channel.

  3. 03

    Link each event to its channel

    Create a channel link code in Event settings → Discord sharing. In the channel you want to connect, run /matchkeep link and submit the code. It expires after 10 minutes, works once, and links one event to one channel.

  4. 04

    Optionally show Discord Scheduled Events

    In the organization card’s Discord modal, turn on Show upcoming Discord Scheduled Events. Upcoming scheduled events then appear on the public organization calendar and link back to Discord. This is a read-only calendar listing; it does not create Matchkeep events or player signups.

  5. 05

    Link your Matchkeep account before reporting

    In Matchkeep, open Account → Additional settings → Personal Discord account and create a link code. Send the bot a direct message with /matchkeep link-account and that code. Each player or host who reports from Discord must link the Matchkeep account they use for the event; the link is one-time per Discord account.

  6. 06

    Publish a Matchkeep event to Discord

    After connecting its organization to a server or linking an event channel, a host can open the event’s Event settings → Discord sharing panel and choose Create Discord event. Later, choose Sync Discord event after changing the Matchkeep schedule or details. This creates or updates a Discord Scheduled Event with a link back to Matchkeep; Matchkeep remains the source for signups and event management.

Commands in a linked event channel

  • /matchkeep helpShow commands and connection instructions. Available in a server or a direct message to Matchkeep.
  • /matchkeep pairingsShow the latest published round’s pairings.
  • /matchkeep standingsShow current standings from accepted results and host adjustments.
  • /matchkeep inviteGet the event signup link while registration is open.
  • /matchkeep opponentChoose an available opponent when player-selected pairings are enabled. Requires a linked account.
  • /matchkeep reportReport your own match result; hosts can report for either player. Requires a linked account.

Setup commands

  • /matchkeep link-accountLink your account using a one-time code in a direct message to Matchkeep.
  • /matchkeep linkHosts: link an event using its one-time code in the chosen server channel.
  • /matchkeep link-profileOrganization owners/managers: link an organization using its code in the server.

Hosts can choose Share signup status, Share current pairings, or Share host bulletin from Event settings. These are manual posts; Matchkeep does not post automatically after every event change. Create and manage the event in Matchkeep—Discord is for linked event updates and player commands.