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.