2. How to link your FACEIT account
EloLink uses the official FACEIT OAuth flow with PKCE - exactly the same flow FACEIT recommends for third-party integrations. We never see or store your FACEIT password. The process takes about 20 seconds.
Two ways to start linking
- The verify button - your server admin posted an embed with the Link FACEIT button (usually in a
#link-faceitchannel). One click is the easiest path. - The /link command in DM - open a DM with the EloLink bot and run
/link. It returns a private button only you can see. Works without joining any server first.
What happens when you click Link FACEIT
- Discord redirects you to
faceitelolink.comwith a one-time state token (valid for 10 minutes, single-use). - EloLink asks for the
role_connections.writeDiscord scope so it can later push your FACEIT level and ELO to Discordâs Linked Roles feature. - Youâre forwarded to
accounts.faceit.com. You log in with your FACEIT credentials (or just confirm if youâre already logged in). - FACEIT returns an authorization code. EloLink exchanges it for an access token via PKCE - no client secret leaves the server.
- EloLink reads your public profile (player ID, nickname, level, ELO, country, avatar) and saves the link.
- The bot pushes your level/ELO to Discord Linked Roles, then syncs the FACEIT level role on every server you share with EloLink.
You end up on a âLinked successfullyâ page within seconds. The role appears in Discord moments later.
What data is stored
Only what is required to assign roles and show your card:
- Discord user ID - primary key.
- FACEIT player ID, nickname, current level, ELO, country - public profile data from FACEIT.
- Discord OAuth token (linked roles) - to push your metadata back to Discord automatically when level changes.
- Match cache - last 10 CS2 matches, refreshed once per hour, used by the
/statsbutton.
No emails, no payment data, no FACEIT password, no tracking pixels. Full breakdown on the Privacy page.
What if you re-link a new FACEIT account?
Run /unlink first. This deletes the old link and removes all FACEIT roles on every server. Then run /link again with the new FACEIT account. Note: the same FACEIT player ID cannot be linked to two different Discord accounts simultaneously - thatâs an anti-abuse rule.
How fast do roles update?
- On link - immediate. The role is assigned during the OAuth callback.
- On level change - within one hour. EloLink runs a scheduled refresh of every linked player and updates roles on all guilds.
- Manual refresh - use
/updateto force-refresh your own data. - Joining a new server - instant. If the new server has EloLink, the bot detects your link and applies the role on join.
Unlinking
You own your data. Run /unlink any time - in DM or any server. The bot removes the link from its database and pulls all your FACEIT roles on every server. To re-link later, run /link again.