Comps.gg Documentation

Appearance

Mobile Companion App ​

Connect the mobile Companion app to your admin account so you can monitor your site on the go, and manage which phones and tablets have access. This page covers scanning the QR code to pair a device, connecting manually if the code won't scan, and revoking access for a lost or old phone.

Where to find it: Admin → Settings → Advanced (/admin/settings?tab=advanced), in the Mobile Companion App card.

Connect your phone for the first time ​

You'll need the Companion app installed on your phone before you start.

  1. Go to Admin → Settings and open the Advanced section.
  2. In the Mobile Companion App card, click Connect Mobile App. A panel slides in and a QR code is generated automatically — there is nothing to click first.
  3. Open the Companion app on your phone and scan the QR code shown on screen.
  4. Your phone is now linked to your admin account. The Connected Devices list doesn't refresh while the panel is open, so to see your new device listed, close the panel and click Connect Mobile App again.

Each QR code is valid for 5 minutes. Below the code you'll see an Expires in countdown with a progress bar; when it reaches 0:00 the panel automatically generates a fresh code, so the code on screen is never expired. If you want a new code sooner, click Refresh QR Code.

Treat the QR code like a password: anyone who scans it while it's on screen can connect their device to your admin account, so don't display it in view of others or share a photo of it.

Connect a second device ​

You can link more than one device to the same admin account — for example a work phone, a personal phone and a tablet. Just repeat the QR scan on each device: open the panel, scan the code with the Companion app on the new device, done. Every connected device is listed separately under Connected Devices and can be revoked independently.

Connect manually if the QR code won't scan ​

If your phone's camera can't read the code (damaged camera, screen glare, remote setup), you can enter the connection details by hand:

  1. In the Connect Mobile App panel, click Manual setup details at the bottom to expand it.
  2. It shows two values: API URL and Site Name.
  3. Enter those values into the Companion app's manual setup screen.

Check which devices are connected ​

When you open the Connect Mobile App panel, the Connected Devices section shows if at least one device is connected (if you've never connected a device, you won't see the section at all). The list is loaded when the panel opens and doesn't refresh while it's open, so a device connected moments ago appears the next time you open the panel. For each device it shows:

  • Device name — taken from the phone itself; you can't rename it here, so if you need to tell devices apart, name the phone in its own settings.
  • Platform — iOS or Android, where the device reports it (this can be blank for a device that didn't).
  • Last active — a relative time such as "just now", "5m ago", "2h ago" or "3d ago", telling you when that device last used the app.

It's worth glancing at this list every so often: if you see a device you don't recognise, or one that hasn't been active for a long time, revoke it (see below).

Revoke access for a lost or old phone ​

If a phone is lost, stolen, replaced, or belongs to someone who should no longer have access:

  1. Open the Connect Mobile App panel and find the device under Connected Devices.
  2. Click Revoke next to it.
  3. A Revoke Device Access dialog asks you to confirm; click Revoke (or Cancel to back out).

You'll see a "Device access revoked" confirmation and the device disappears from the list. That device loses access immediately — to reconnect it, someone would have to scan a fresh QR code from your admin panel, so revoking is safe to do the moment a phone goes missing.

Troubleshooting ​

The QR code won't scan ​

  • Check the countdown hasn't just rolled over — the panel regenerates the code automatically at 0:00, and a code changing mid-scan can confuse the camera. Click Refresh QR Code and scan the new one promptly.
  • Check the Companion app has permission to use your phone's camera.
  • Improve the lighting or increase your screen brightness.
  • If it still won't scan, use Manual setup details to connect by typing in the API URL and Site Name instead.

The panel shows an error instead of a QR code ​

If QR generation fails you'll see an error message with a Try Again button. Click it to retry; if it keeps failing, close the panel, reload the admin page and try again.

A device I connected isn't in the Connected Devices list ​

The list only refreshes when the panel opens, so first close the Connect Mobile App panel and open it again — a device that paired while the panel was on screen won't show until you do. If it's still missing after reopening, the pairing probably didn't complete on the phone: scan a fresh QR code with the Companion app and wait for the app to confirm the connection before closing it.

I revoked a device by mistake ​

No harm done — nothing is deleted permanently. Reconnect the device by scanning a new QR code, exactly as you did the first time.

Revoking failed ​

If you see "Failed to revoke device access", the revoke didn't go through and the device still has access. Try again; if it repeatedly fails, reload the page and retry.

  • Settings — everything else on the Settings page, including the other Advanced options.
  • System Logs — reviewing admin activity on your site.