Luxa Users — User Guide

Last updated on August 3, 2026 · 6 min read

This guide covers everyday use of Luxa Users, Luxa Users Pro, and the official add-ons (Social Login, Custom Fields Builder). For installing and licensing these plugins, see the Installation & License Setup Guide. For common questions, see the FAQ.

1. Luxa Users (Free)

Luxa Users replaces WordPress’s default login, registration, and profile screens with clean, shortcode-based pages you place anywhere on your site.

1.1 The shortcodes

ShortcodeWhat it renders
[lxu_login]Login form, with a “Forgot password?” link built in
[lxu_register]Registration form
[lxu_forgot_password]A standalone forgot-password form, if you want it on its own page instead of inside the login form
[lxu_profile]The logged-in user’s account page (edit profile, change password, avatar)

Drop any of these into a normal WordPress page using the block editor’s Shortcode block, or a classic-editor paragraph.

1.2 Creating your pages the easy way

You don’t need to create pages and paste shortcodes by hand. Go to Luxa Users → Settings → General, and next to each of the Login/Register/Profile Page dropdowns you’ll find a Create Page button. Click it and Luxa Users will:

  1. Create a new published page with the right shortcode already inserted.
  2. Automatically select that page as the one to use — no extra Save step needed.

You can still point these dropdowns at an existing page instead, if you’d rather build your own page around the shortcode (e.g. inside a two-column layout).

1.3 Settings overview

Luxa Users → Settings has several tabs:

  • General — which page is Login/Register/Profile, redirect URLs after login/logout, whether to require email verification, whether to allow logging in with an email address instead of a username, and the “Redirect wp-login.php to the Login Page above” toggle (see 1.4 below).
  • Appearance — pick a built-in theme and a primary color for the forms, or disable Luxa Users’ own CSS entirely if you’d rather style everything yourself.
  • Security — login attempt limits (brute-force lockout), and related hardening options.
  • Notifications — which emails Luxa Users sends (welcome email, verification email, etc.) and lets you edit their subject/body.
  • Debug — an internal log of plugin activity, useful when troubleshooting with support.
  • License (only visible once Luxa Users Pro is active) — see section 2.4.

1.4 Redirecting wp-login.php

By default, WordPress’s own /wp-login.php still works alongside your Luxa Users pages. If you’d rather visitors never see it at all, turn on “Redirect wp-login.php to the Login Page above” in Settings → General (requires a Login Page to be set). Once enabled:

  • Visiting /wp-login.php sends visitors to your Login page instead.
  • /wp-login.php?action=register sends them to your Register page.
  • “Forgot your password?” links sent by WordPress core also land on your Login page, with the forgot-password panel already open.
  • Logging out, and the actual “reset password” link from a password-reset email, are not redirected — those still need to go through WordPress core to work correctly.

2. Luxa Users Pro

Luxa Users Pro is a companion plugin — install it alongside the free Luxa Users plugin to unlock a nicer admin interface and extra features.

2.1 The admin experience

Once your license is active, the entire Luxa Users admin area switches from the plain default WordPress look to a polished sidebar-based layout, with your chosen accent color and light/dark options from Appearance settings.

2.2 Modules

Luxa Users → Modules lists optional features bundled with Pro that you can turn on or off — for example, Mobile Number Login, which lets users log in with a phone number instead of (or alongside) a username. Unlike add-ons (below), modules don’t need a separate license — they’re part of Pro and just need switching on.

2.3 Add-ons

Luxa Users → Addons is where you browse, unlock, install, and manage official add-ons (Social Login, Custom Fields Builder, and any future ones) without leaving your dashboard:

  • Unlock — if you’ve purchased an add-on, click Unlock, paste the license key you received, and Luxa Users verifies it live.
  • Install Now — appears once an add-on is unlocked; installs it like any WordPress plugin.
  • Activate / Deactivate — once installed.
  • Delete — removes an add-on’s files from your server (you must deactivate it first). This doesn’t affect your license — reinstalling later picks the license back up automatically.
  • License (button on an active add-on’s card) — a quick popup to check that add-on’s license status, or move it to a different site, without leaving this screen.

2.4 Managing your license

Go to Luxa Users → Settings → License. If you have Pro and one or more add-ons installed, this tab has its own sub-tabs — one for Pro itself, and one per installed add-on — so all your license keys live in one place. Each sub-tab lets you:

  • Enter/activate a license key.
  • See when it expires and how many sites it’s currently activated on.
  • Deactivate it on this domain, freeing up a slot to use it on another site.

3. Social Login Add-on

Lets visitors sign in or register using Google, Facebook, or GitHub instead of a password.

3.1 Setting up a provider

Go to Luxa Users → Social Login. For each provider you want to offer:

  1. Toggle it on.
  2. Create an OAuth app/client on the provider’s own developer console (Google Cloud Console, Facebook Developers, or GitHub Developer Settings) and get a Client ID and Client Secret.
  3. Paste those into the matching fields here.
  4. Save.

Once at least one provider is configured, “Sign in with Google” / “Sign in with Facebook” / “Sign in with GitHub” buttons appear automatically on your

LuxaPress.com

Welcome back — sign in to pick up where you left off.

Sign In

Forgot password?

Or sign in with a one-time code

or continue with
Google Facebook GitHub

Don't have an account? Create one

and

Create Account

Optional — lets you sign in with your phone number instead of your username.

or continue with
Google Facebook GitHub

Already have an account? Sign in

pages — no extra shortcode needed.

3.2 What happens to the account

The first time someone signs in with a provider, Luxa Users creates a normal WordPress user account for them (using the email address the provider gives). If they later sign in with the same provider again, it logs into that same account. If someone with a matching email already registered normally, the accounts are linked rather than duplicated.

4. Custom Fields Builder Add-on

Add extra fields — text, dropdowns, file uploads, repeaters, and more — to your Register and Profile forms, without writing code.

4.1 Building fields

Go to Luxa Users → Field Builder. Click a field type from the palette on the left to add it, then configure:

  • Label and placeholder text.
  • Whether it’s required.
  • Where it appears — Register form, Profile form, or both.
  • Type-specific options (choices for a dropdown, min/max for a number, accepted file types for uploads, sub-fields for a repeater, and so on).

Drag fields to reorder them; click a field to edit it, or use its delete icon to remove it.

4.2 Supported field types

Text, Textarea, Number, Email, URL, Phone, Date, Dropdown (Select), Radio Buttons, Checkbox (multiple), Toggle (yes/no), Color Picker, File Upload, and Repeater (a group of sub-fields the user can add multiple rows of).

4.3 Where the data goes

Every custom field value is saved as WordPress user meta on that user’s account, so it’s available anywhere you’d normally read user meta — in your theme, in other plugins, or via a filter/action if you’re customizing further.

Need something not covered here? Check the FAQ, or reach out via luxapress.com/support.

← Luxa Booking Pro
→

Related Docs

Powered by LuxaDocs