ClubRightHelp centre Open ClubRight

Setting up and troubleshooting the Welcome Screen

What the Welcome Screen is, how to install it, fix common problems, and reinstall it if needed.

The Welcome Screen is the desktop application that connects ClubRight to your front desk and access hardware. Whether you use a simple desktop scanner or a multi-door turnstile system, the Welcome Screen needs to be installed and running for that hardware to work. This article covers what it is, how to set it up, how to fix common problems, and how to reinstall it if you need to.

💡 Important: The Welcome Screen runs on Windows 10 or 11 only. It cannot be installed on Apple (macOS) devices. You also need to be logged in with an owner-level account to download it. Once it's installed, any staff login (Trainer and up) can sign in to it.


What the Welcome Screen does

The Welcome Screen is a small application that links physical hardware to your ClubRight account. It is required for:

  • Member check-in hardware (a QR or barcode scanner)

  • Access control (doors, turnstiles, and gates)

  • Till hardware (a cash drawer and receipt printer)

It needs to be running at all times for any of this hardware to work.


Choosing your check-in method

Before you install the Welcome Screen, decide how members will check in. Go to Settings > How your club runs > Club Access and choose an option under How do members check in?

  • QR Code (Rotating, secure): a secure code in the member app that refreshes regularly.

  • QR Code (Fixed, printable): a fixed code that can be printed.

  • Barcode (Traditional scanner): for members using a key tag or membership card with a printed barcode.

  • Digital Card: a membership card in the member app.

  • None: check-in disabled.

Remember to click Save Changes.

💡 Note: The check-in method is a club-wide setting, not a per-member choice. Different access control systems work with specific check-in types, so if you use access control, choose the option that matches your hardware. If you are unsure which one your system needs, check with your access control provider before changing it.


Downloading and installing the Welcome Screen

To install the Welcome Screen on the Windows device at your front desk:

  1. Log in to ClubRight on that device with an owner-level account.

  2. Go to Settings > How your club runs > Apps & Widgets.

  3. Find Welcome Screen & POS under Tools for your front desk and click Download. This opens the Welcome Screen in the Microsoft Store.

  4. Install it from the Microsoft Store, then open it and sign in.

💡 Seeing an error during installation? Temporarily turn off any antivirus or anti-malware software, as it can flag the installer as a false positive. Also make sure your Windows account has administrator rights to install new applications. If the Welcome Screen will not load after installing, make sure .NET 6.0 and Edge WebView2 are installed on the PC, as both are required to run it.

Once installed, keep the Welcome Screen open and running. When it prompts you to update, always accept so you stay on the latest version.


What to set up next

What you do next depends on the hardware you are connecting:


Checking your Welcome Screen status

The quickest check is the Welcome screen card at the top of the left-hand column on your Home page. It shows whether your Welcome Screen is Online and when it was last seen. While it is online, the card also shows the Open Gate button. The card is on Owner logins' Home page only.

To check each screen, open app.clubright.co.uk/Club/Terminals while you're signed in to ClubRight. This opens the Welcome Screen status page, which lists each screen with when it was last seen, its terminal ID and its software version. The link works on Owner and Manager logins. Owners can also open it from Settings: under Your Club, click Welcome Screen status.

Manager logins don't have the card or the Settings menu, but can use the link above. Staff and Trainer logins can't open the Welcome Screen status page. They can see whether the Welcome Screen is online on their Staff Dashboard, which shows a line such as "Welcome screen online. Last seen" followed by the date and time.

Checking the status is a useful first step if a member reports that check-in is not working, or that they are checked in but the door will not open.


Which version of the Welcome Screen do I have?

On the PC, press F1 to take the Welcome Screen out of full screen. The title bar reads ClubRight Welcome Screen followed by the version number:

  • 3.0: the Microsoft Store version. This is the one you get from Download today.

  • 2.1: the older version, installed from the ClubRight website.

Some troubleshooting steps below are for the older version only.


How do I sign in to the Welcome Screen with a different login?

There's no sign-out button. To use a different login, reset the Welcome Screen:

  1. On the Welcome Screen, press F12 to open Terminal Settings.

  2. Click Reset Terminal and confirm. On the older version the button is Reset.

  3. The Welcome Screen closes. Open it again.

  4. Sign in with the new login and click Sign In (Login on the older version).

⚠️ Note: Reset clears every setting on that PC: the receipt printer and till, the gate command and COM port, the scanner and the Paxton settings. Press F12 and note them down before you reset, then set them up again afterwards.

Any staff login, Trainer and up, can run the Welcome Screen. Member logins can't. The Welcome Screen joins the club of whichever login you sign in with.


Can I open the gate from ClubRight?

Yes. While your Welcome Screen is online, you can open your gate, door or turnstile remotely with the Open Gate button. Use it when you need to let someone in or unlock the door without them scanning in at your access control.

Who can use the Open Gate button?

Owners, Managers and Staff can. Trainers can't.

  • Owners: see Open Gate on the Welcome screen card on their Home page, and can also add the Welcome Screen widget to a dashboard.

  • Managers and Staff: their Home page is a shorter version without the card. They use Open Gate from the Welcome Screen widget on their dashboard. The built-in Staff Dashboard and Front Desk dashboards already include it, on the bottom row, so scroll down if you can't see it. They can also add it to any of their dashboards themselves.

  • Trainers: can't see the widget or use Open Gate.

There's no setting to stop a particular Manager or Staff login using Open Gate.

Where to find the Open Gate button

On an Owner login, the Welcome screen card is at the top of the left-hand column on the Home page. It shows whether your Welcome Screen is Online and when it was last seen. While it is online, the card also shows the Open Gate button.

On any login except a Trainer, you can add it to a dashboard:

  1. Go to Home and open a dashboard under My Dashboards.

  2. Click Edit dashboard.

  3. In the Admin group, click or drag the Welcome Screen widget onto the dashboard.

  4. Click Done editing.

⚠️ Note: If the Welcome Screen widget is greyed out in the editor, it's already on that dashboard. If it isn't in the list at all, your club's Welcome Screen hasn't been seen in the last month.

Opening the gate

  1. Click Open Gate on the Welcome screen card or widget.

  2. ClubRight shows "Open request sent. If the door doesn't open within a few seconds, check the welcome screen computer is running." The Welcome Screen PC at your club then opens the gate.

The Open Gate button works the same way whichever access control system you use, including Nortech and Paxton, because ClubRight sends the message to your Welcome Screen PC rather than to the hardware directly.

If you cannot see the card or the button

  • The card says "The Open Gate control appears here when your welcome screen is online." Your Welcome Screen is offline. It counts as online only if it has been seen in the last couple of minutes. Check the Welcome Screen status page at app.clubright.co.uk/Club/Terminals, then follow the troubleshooting steps below.

  • There is no Welcome screen card at all. The card and the dashboard widget only appear if your club's Welcome Screen has connected at some point in the last month. Make sure the Welcome Screen is installed, open and online on the PC at your club. Once it connects, the card appears.

  • You're on a Manager or Staff login. The card isn't on your Home page. Use the widget on your Staff Dashboard instead, as described above.

Does Open Gate check the person in?

No. Open Gate only opens the door. It isn't linked to a member, so nobody is checked in and no visit is recorded.

You can't override a plan's access hours for one visit, either. If a member's plan doesn't allow them in at that time, the Check in button on their profile refuses them too ("Your membership plan doesn't allow you in at this time."). So if you let a junior in with Open Gate when they come with a parent, the visit won't show in your figures.


Can I see the Welcome Screen from another computer?

No. The Welcome Screen only shows on the PC it's installed on at your club. From any computer signed in to ClubRight you can check whether it's Online, when it was last seen, and use Open Gate. See "Where to find the Open Gate button" above, or the Welcome Screen status page at app.clubright.co.uk/Club/Terminals.


Can I hide the member's name on the Welcome Screen?

No. The Welcome Screen always displays the member's name and photo, and they can't be hidden for privacy. There's no setting in ClubRight to turn them off, and the Welcome Screen PC's own settings (press F12) only cover the receipt printer, the Nortech gate, Paxton Net2 and the barcode scanner.

If this matters to your club, let us know through the chat button.

What a member sees when they scan in

When a scan is successful, the Welcome Screen shows:

  • "Good Morning", "Good Afternoon" or "Good Evening" and their first name.

  • Your club's welcome message, or "Enjoy your [class] session!" if they're booked in to a class.

  • Their visit number.

  • Their active memberships, with the visits or days they have left.

  • Any Welcome Screen messages sent to them.

  • Their photo. If they haven't got one, their Gravatar picture shows if they have one. Otherwise the photo space is blank.

If they're let in on a membership that has ended, an amber Membership expired panel shows too.

When a member checks out, it shows "Goodbye" and their first name.

What shows when a scan is refused

It shows "Sorry" and the member's first name in red, with the reason and their photo. To find out what each reason means, see Why was a member refused entry on the welcome screen?

If the card or barcode isn't recognised, it shows "Card not registered" or "Barcode expired". No name is shown.

What shows if the Welcome Screen PC loses its internet connection?

A successful scan shows "Welcome back" and the member's first and last name. A refused scan shows "Access Denied, please speak to a member of staff".

What sounds does the Welcome Screen make?

When a member scans in, the scanner beeps as it reads the code. The Welcome Screen then plays one sound when the member is let in, and a different sound when they're refused, for example because their membership has expired, they're overdue or their card isn't registered. This works the same on the Welcome Screen app and on Browser Check-In.

If you only hear the scanner's beep:

  1. Go to Settings > How your club runs > Club Access and make sure Mute welcome screen is switched off.

  2. Check the PC's volume is turned up, and that it has speakers or headphones connected.

  3. Check the Welcome Screen is open and you're logged in to ClubRight.


Troubleshooting

The Welcome Screen is a stable application and does not usually cause problems on its own. Most issues come from local factors: a change in hardware, a new internet provider, new software on the PC, a Windows update, or corrupted files.

If something stops working, first check whether anything changed recently and roll it back if you can. If not, work through the steps below for your symptom.

Welcome Screen is offline, blank, or shows an "Object not set" error

You may see that your Welcome Screen does not show as Online on the Welcome screen card on your Home page or on the Welcome Screen status page (app.clubright.co.uk/Club/Terminals), a blank white screen, or an error beginning "Object not set".

  1. If the Welcome Screen is not running, double-click it to start it.

  2. If it is running, close it. (If it is already closed, skip this step.)

  3. Press the Windows key, type %LocalAppData% and press Enter.

  4. If you have the older version (2.1), delete the Apps folder. Skip this step on the Microsoft Store version (3.0).

  5. Open Windows File Explorer and go to This PC > C: drive > Users, then open the folder for the user you are logged in as.

  6. Delete the file called clubrightofflinecache.

  7. Delete the file called clubright.

  8. Re-open the Welcome Screen.

Welcome Screen cannot connect, or a gate or door will not open

You may see an "unable to connect" pop-up, or the Welcome Screen shows as Online but the gate or door still will not open. For example, members' PIN, QR code or card logs a check-in, but they are not let in.

  1. Check your internet connection is working.

  2. Check you do not already have another instance of the Welcome Screen running.

  3. Close and re-open the Welcome Screen.

  4. Restart the PC.

  5. If it still will not connect, follow the offline steps above.

  6. If it keeps happening, contact your access control installer, who can connect remotely and find the cause. If you don't have one, see Access Control suppliers.

Scanner not working

Members cannot scan in, or they scan but nothing shows on the dashboard.

  1. Unplug and reconnect the scanner.

  2. Close and re-open the Welcome Screen.

  3. Restart the PC.

  4. If it still will not work, follow the offline steps above.

  5. If the problem continues, reinstall the scanner using the QR code and barcode scanner setup guide.

Till or printer not working

The cash drawer will not open for a sale, or the receipt printer will not print.

  1. Check the printer has paper.

  2. Check the drawer is not physically blocked.

  3. Unplug and reconnect the till drawer and receipt printer.

  4. Close and re-open the Welcome Screen.

  5. Restart the PC.

  6. If it still will not work, follow the offline steps above.

  7. If the problem continues, reinstall the hardware using the till drawer and receipt printer setup guide.

💡 What ClubRight can and cannot help with: The Welcome Screen is ClubRight software, so we can help with that. We cannot resolve issues with your own devices, internet connection, cabling, physical gates or turnstiles, or third-party access control hardware and software. For those, contact your access control provider. If you do not have one, see Choosing an access control supplier.


Removing and reinstalling the Welcome Screen

⚠️ Uninstalling is a last resort. Work through the troubleshooting steps above first. Reinstalling resets the Welcome Screen: you will need to log in again and set up your scanner and access control again.

Before you uninstall: if you use access control, press F12 to view your access control settings and make a note of them, so you can re-enter them afterwards. Also turn off any antivirus or anti-malware, and make sure your Windows account can install applications.

Step 1: Uninstall the application

  1. Click the Windows start button.

  2. Type add or remove programs and open the best match.

  3. Find the ClubRight Welcome Screen in the list and click Uninstall.

Step 2: Delete the leftover files

  1. Open Windows File Explorer and go to This PC > C: drive > Users, then open the folder for the user you are logged in as.

  2. Delete the clubright file and the clubright settings file.

⚠️ Note: The clubright settings file holds the Welcome Screen's settings: the door or gate, the scanner, the receipt printer and Paxton. Deleting it clears them, so press F12 and note them down before you uninstall, then set them up again afterwards.

Step 3: Reinstall

  1. Make sure you are logged in with an owner-level account.

  2. Go to Settings > How your club runs > Apps & Widgets.

  3. Find Welcome Screen & POS and click Download. This opens the Microsoft Store. Install it from there.

  4. Log in and set up your scanner and access control again. Your access control provider can help with this.

💡 Seeing a "vendor" or "cannot start application" error when reinstalling? This only applies to the older version (2.1). Close the Welcome Screen, press the Windows key, type %LocalAppData% and press Enter, delete the entire Apps folder, then run the Welcome Screen again.

If you get stuck at any point, contact the Customer Success team using the chat button in your application.


Related help articles