Install the plugin
- In WordPress, go to Plugins → Add New Plugin → Upload Plugin and upload the LoyalMLS Bridge package from Loyal Techno Group.
- Click Activate.
- Open LoyalMLS Bridge → Settings. The Connection tab opens first.
Connect to LoyalMLS Gateway
The MLS API section holds the two values Loyal Techno Group gives you after your MLS review.
- API Base URL: the root address of the LoyalMLS API. Enter only the root; the plugin adds the endpoint paths itself.
- API Key: the private key the plugin sends with every listing request. Treat it like a password.
Then click Test Connection. It uses the values currently in the form, even before you save, and registers your site with Gateway.
- Connection successful means Gateway accepted your site.
- Connection failed shows the reason, such as the HTTP status code the service returned or a network error.
When the test succeeds, click Save Changes at the bottom of the screen. The header pill changes to Gateway configured.
If the test fails
- Check that the API Base URL is the root address you were given, including
https://, with nothing added after it. - Paste the API Key again; a missing character or a space at the end is a common cause.
- Make sure your server can make outgoing HTTPS requests. Some hosts block them by default.
- Still failing? Contact Loyal Techno Group support with the message shown in the Connection status panel. Never include the key itself.
REST API access
The plugin also offers listing data to other applications at /wp-json/loyalmls/v1/listings. The REST API Access section decides who can read it:
- Private (default) requires the
x-loyalmls-keyheader, with your Site Token as its value. - Public allows open access, for public listing searches.
The Site Token shown below the options is also how Gateway recognizes your site. Keep it private, and leave the API on Private unless you have a reason to open it.
Limit listings by country
In the Countries section, start typing a country name and press Enter to add it. Your site then shows only listings inside the borders of the countries you pick. Leave it empty to show all countries. The filter uses each listing’s map coordinates.
Listing cache
The Listing Cache section shows how many requests, queries, listings and images the plugin has cached. Clear Cache empties it, so the next page view fetches fresh data from Gateway.
Agents and broker
On the Agents & Broker tab:
- + Add Agent adds an agent of your own with a name, email, phone and photo. Add their Agent MLS IDs and Agent MLS Keys (one per line) so the plugin can recognize their listings, and tick Set as default agent for the agent shown when no other matches.
- Broker / Office holds your brokerage name, email, phone, logo, MLS Keys and Office MLS IDs.
These details are used by the agent and broker blocks on listing pages, and as a fallback recipient for inquiry forms.
Visitor accounts
The Users tab controls how visitors sign up and where their favorites and saved searches are kept.
Where visitors are stored
- LoyalMLS users (default): visitors live in the plugin’s own table. They don’t appear under WordPress Users and don’t get a WordPress login. They sign in by email, with a password or a code sent by email.
- WordPress users: visitors become WordPress users with the Subscriber role. Pick this if a membership, WooCommerce or community plugin already manages your users. If you switch an existing site, the User Sync section shows what needs copying; click Sync Users Now.
Social sign-in
Under Social Sign-In you can turn on Sign in with Google (needs a Google Client ID) and Continue with Apple (needs an Apple Services ID). Each card shows the origin or return URL to register with Google or Apple. The Apple button stays hidden until the site runs on HTTPS and the server’s PHP has the OpenSSL extension.
Account link and profile page
- Account Link adds a Sign In item to the menu locations you tick; it shows the visitor’s name once they’re signed in. If your theme has no menu locations, place the
[loyal_account]shortcode instead, for example in a header widget. - Profile Page is the page holding the
[loyal_profile]shortcode, where signed-in visitors see their account, saved searches and favorites. Create a page with that shortcode first, then pick it here.
Next step
Continue with Built-in layouts and presentation.
Stuck on a step? Existing customers can reach Loyal Techno Group support. Planning a new site? Start with an MLS review.
