What are the best practices for maintaining a Knowledge Base?

Knowledge Base best practicesKnowledge Base best practices include writing one clear answer per article, using customer language, assigning accurate categories, setting review dates and checking feedback regularly. Keep high-traffic articles current and create new content when customers repeatedly search for unanswered topics.

Can I import and export Knowledge Base articles?

Knowledge Base article import and exportKnowledge Base article import and export tools are available in Knowledge Base > Tools. Export first before bulk changes. When importing, keep existing Documentation IDs unchanged so matching articles are updated safely, and publish imported content only after review.

How do I use Knowledge Base insights to improve content?

Use Knowledge Base insightsTo use Knowledge Base insights, open Knowledge Base > Insights and review popular articles, no-result searches and helpfulness feedback. Use the findings to update unclear guides, add missing content and create synonym groups that match customer language.

Why is my Knowledge Base API request failing?

Fix Knowledge Base API errorsTo fix Knowledge Base API errors, check the HTTP status code first. Verify HTTPS, Application Password authentication, API permissions, valid JSON and numeric category IDs. For an update, fetch the article by Documentation ID and send its current version as expected_version.

How do I connect an integration to the Knowledge Base API?

Connect to the Knowledge Base APITo connect to the Knowledge Base API, assign API permissions to a dedicated WordPress user in Knowledge Base > Settings > API integrations, then use the Application Password for that user over HTTPS. Give only the permissions required, such as read access and draft writing.

Is Regal Knowledge Base compatible with my WordPress theme?

Regal Knowledge Base theme compatibilityRegal Knowledge Base theme compatibility is designed around native WordPress content and scoped plugin styling, so it works with standard modern WordPress themes. Use the Theme settings and public preview to check colours, typography, spacing and responsive behaviour with your specific theme.

Why are my Knowledge Base pages not showing?

Knowledge Base pages not showingIf Knowledge Base pages not showing is the issue, confirm that Regal Knowledge Base is active, the article is published, its category is assigned and its access setting allows the current visitor. Then save Settings > Permalinks and clear site, CDN and browser caches.

How do I add downloadable files to an article?

Add Knowledge Base downloadsTo add Knowledge Base downloads, upload the file to the WordPress Media Library, open the relevant article and enter its attachment ID in the Attachments and downloads panel. Update the article and test the tracked download link on the public page.

Can I restrict an article to logged-in users or selected roles?

Restrict Knowledge Base article accessYou can restrict Knowledge Base article access from the Article access panel while editing an article. Choose Public, Logged-in users or Selected roles, then test the article while signed out and with a non-administrator user who has the intended role.

Why does Knowledge Base search return no results?

Knowledge Base search no resultsFor Knowledge Base search no results, confirm that a relevant article is published and uses the words visitors are searching for. Update the article title or introduction, add a suitable synonym group, or create a new article if the topic is not covered.

How do I improve Knowledge Base search results?

Improve Knowledge Base searchTo improve Knowledge Base search, use clear article titles, include customer language in opening paragraphs and headings, and review no-result searches in Knowledge Base > Insights. Add focused synonym groups for equivalent terms, such as login, sign in and log in.

Why is my FAQ not appearing on the website?

Knowledge Base FAQ not showingIf a Knowledge Base FAQ not showing problem occurs, confirm that the FAQ is published, that the page contains the FAQ block or shortcode, and that the shortcode limit or group filter includes the FAQ. Clear any page or browser cache after publishing.

How do I add FAQs to Regal Knowledge Base?

Add Knowledge Base FAQsTo add Knowledge Base FAQs, open Knowledge Base > FAQs, select Add FAQ, use the customer question as the title, write a concise answer and assign a category. Publish the FAQ, then display it with the FAQ block or the [rit_kb_faqs] shortcode.

What is a Documentation ID and when should I use one?

Knowledge Base Documentation IDA Knowledge Base Documentation ID is a permanent unique identifier for an article, usually written as product/topic/article. Use it when an external integration or product project needs to create or update the article safely. Do not use a title, slug or URL as the integration identity.

How do I create and publish a Knowledge Base article?

Publish Knowledge Base articlesTo publish Knowledge Base articles, open Knowledge Base > Articles, select Add article, write a clear title and answer, assign a category, add an excerpt, then review the draft. Publish only after checking the public page, links and access setting.

Can I change Knowledge Base colours without changing my WordPress theme?

Knowledge Base theme settingsKnowledge Base theme settings let you adjust colours and typography for the homepage, category pages and article pages. These changes apply only to Regal Knowledge Base and do not modify the active WordPress theme.

How do I configure the Knowledge Base layout?

Configure Knowledge Base layoutTo configure Knowledge Base layout, open Knowledge Base > Settings and use the Presentation tab. Choose the landing-page layout, set articles per section, select the category article display style and choose how many FAQ cards appear in each row.

How do I create categories in Regal Knowledge Base?

Create Knowledge Base categoriesTo create Knowledge Base categories, open Knowledge Base > Categories in WordPress admin, enter a clear name and slug, choose a parent if needed, then save. Use task-focused names such as Getting Started, Configuration and Troubleshooting rather than internal department names.

What do I need before setting up Regal Knowledge Base?

Regal Knowledge Base setupFor Regal Knowledge Base setup, activate the plugin, use a WordPress account with permission to manage Knowledge Base content, and prepare the main customer questions you want to answer. Start with a small category structure and add accurate articles before expanding the help centre.

Which WooCommerce emails can include made-to-order messages?

You can enable messaging for new order, processing, on-hold, completed and invoice emails.

Can I add made-to-order information to WooCommerce emails?

Yes. Enable item and order email messages, then choose the WooCommerce emails that should include them.

Can I show messages in the basket and checkout?

Yes. Enable Cart and Checkout in Backorder Override or in the relevant Product Rule group.

Can I customise the made-to-order message for each product range?

Yes. Create separate Product Rule groups and configure each group with its own customer-facing messages.

How can I test my Made to Order configuration?

Test a matching product page, basket, checkout and a suitable order email, preferably in a private browser window.

What is the best wording for a made-to-order message?

Use short, clear wording that says the item is made to order and gives a realistic production estimate.

Does Regal Made to Order work with HPOS?

Yes. Regal Made to Order declares compatibility with WooCommerce High-Performance Order Storage.

Does Regal Made to Order work with WooCommerce backorders?

Yes. Backorder Override changes the customer-facing wording when WooCommerce identifies an item as on backorder.

How do I choose sale categories to sync into?

How do I choose sale categories to sync into?Open the relevant Sale Category Sync group and use Sync Into These Categories to select one or more WooCommerce product categories. Use dedicated categories such as Sale or Offers so automated merchandising stays easy to review.

Does Sale Category Sync remove other product categories?

Does Sale Category Sync remove other product categories?No. Sale Category Sync removes only categories configured as managed destination categories for the relevant group. Categories assigned manually, by imports, or by other plugins remain assigned to the product.

How do I set up Sale Category Sync?

How do I set up Sale Category Sync?To set up Sale Category Sync, go to WooCommerce > Sale Category Sync, open Group 1, select the product categories that should receive eligible sale products, choose a sync frequency, and save your settings. Use Run Sync Now to reconcile existing products immediately.

What does On product save only mean?

What does On product save only mean?What does On product save only mean is that the group has no recurring background schedule. The plugin still checks relevant products when they are saved or updated, and you can still use Run Sync Now to perform a full catalogue reconciliation.

What sync frequency should I choose?

What sync frequency should I choose?What sync frequency should I choose depends on how quickly your sale listings need to change. Use Every 15 Minutes for frequent promotions, Hourly or Twice Daily for most stores, and Daily for slower-moving catalogues. Product-save checks and Run Sync Now remain available in manual mode.

Can I exclude products by category or tag?

Can I exclude products by category or tag?Yes. Can I exclude products by category or tag is supported through each group’s Exclude Products By Category and Exclude Products By Tag controls. A product matching any selected exclusion is skipped for that group, even when it is on sale.

How do I exclude a product from Sale Category Sync?

How do I exclude a product from Sale Category Sync?To exclude a product from Sale Category Sync, open the group settings and select it under Exclude Specific Products. Save the group, then run a manual sync if you need any existing managed sale category removed immediately.

What happens when I delete a Sale Category Sync group?

What happens when I delete a Sale Category Sync group?When you delete a Sale Category Sync group, the saved configuration for that group is removed. It does not remove product categories from your catalogue. Review the group’s rules before deletion because the action cannot be undone.

Can I use more than one Sale Category Sync group?

Can I use more than one Sale Category Sync group?Yes. Can I use more than one Sale Category Sync group lets you create separate destination categories, exclusions and schedules for different campaigns. Group 1 remains available with Free access, while additional groups depend on the current trial or licence access.

Does Sale Category Sync work with variable products?

Does Sale Category Sync work with variable products?Yes. Does Sale Category Sync work with variable products and responds to relevant parent-product and variation save or update events. Check the variations’ sale pricing and dates, then review the parent product’s category assignments or run a manual sync.

Does Sale Category Sync work with scheduled sale dates?

Does Sale Category Sync work with scheduled sale dates?Yes. Does Sale Category Sync work with scheduled sale dates by relying on WooCommerce’s current sale state. A product becomes eligible when its scheduled sale starts and becomes ineligible when the sale ends, subject to the configured sync timing and exclusions.

Why are sale products not being added to my category?

Why are sale products not being added to my category?If sale products are not being added to my category, check that the product is published, currently on sale, and not excluded by product, category or tag rules. Also confirm the destination category is selected in the correct group, then run Run Sync Now and review the activity log.

How do I run a manual Sale Category Sync?

How do I run a manual Sale Category Sync?To run a manual Sale Category Sync, open WooCommerce > Sale Category Sync, go to the Dashboard, and select Run Sync Now. The plugin checks the catalogue against the current group settings and records meaningful category changes in the activity log.

Is it safe to run Sale Category Sync more than once?

Is it safe to run Sale Category Sync more than once?Yes. Is it safe to run Sale Category Sync more than once because the plugin compares intended managed category assignments with the current assignments. When a product is already correct, no additional category change is needed.

What should I check after importing products?

What should I check after importing products?After importing products, check that sale prices, sale dates, categories and tags imported correctly. Then run Run Sync Now to apply current Sale Category Sync rules across the imported products and review the activity log for changes.

Do I need WooCommerce active for Sale Category Sync?

Do I need WooCommerce active for Sale Category Sync?Yes. Do I need WooCommerce active for Sale Category Sync because the plugin uses WooCommerce product and sale data to decide eligibility. If WooCommerce is inactive, Sale Category Sync pauses sync actions and displays an admin notice.

Why is Sale Category Sync not running automatically?

Why is Sale Category Sync not running automatically?If Sale Category Sync is not running automatically, check the group’s Sync Frequency and confirm it is not set to On product save only. Scheduled tasks rely on WordPress cron, so low-traffic sites may require a server-side cron arrangement.

Where can I see Sale Category Sync changes?

Where can I see Sale Category Sync changes?You can see Sale Category Sync changes in the Dashboard Activity section. It records meaningful category additions and removals, helping you identify whether a change came from a manual run, a scheduled run, a product save or a product update.

What happens when my Sale Category Sync licence expires?

What happens when my Sale Category Sync licence expires?When a Sale Category Sync licence expires, newer updates may still be shown but licensed downloads are blocked until renewal. Review the System tab for the current status and server message. Group 1 remains available with Free access.

How does the Sale Category Sync licence work?

How does the Sale Category Sync licence work?The Sale Category Sync licence controls access to licensed features and plugin updates. New installations begin with an active 7-day trial. Check the System tab to review licence status, registered domain, expiry details and update access.

Can I show a made-to-order message while a product is in stock?

Yes. Create a Product Rule group that matches products, categories or tags. Product Rules apply even when stock is available.

What does Regal Made to Order do?

It replaces standard WooCommerce backorder wording with made-to-order messaging on selected customer touchpoints.

How do I set up Regal Made to Order?

Activate the plugin, open Made to Order in WordPress admin, configure Backorder Override messages and save your settings.

Do Product Rules override Backorder Override settings?

Yes. A matching enabled Product Rule group takes precedence over the general Backorder Override settings.

Configure Microsoft 365 email in Regal Send

Updated September 20, 2026

Use this guide to configure Microsoft 365 email in Regal Send and send WordPress messages through Microsoft Graph. Regal Send uses an administrator-authorised Microsoft account, requests only delegated Mail.Send and offline access, and stores the resulting credentials in encrypted form. You need permission to create an app registration in Microsoft Entra and an HTTPS WordPress URL before starting.

Before you configure Microsoft 365 email in Regal Send#

Confirm that the WordPress Address and Site Address use HTTPS.
Confirm that the normal path-based WordPress REST API works. Query-style REST URLs are not supported for this callback.
Choose the Microsoft account that will authorise sending.
Make sure the sender address used by WordPress is permitted for that account. Regal Send does not promise shared-mailbox or send-as support in this release.

The Trial and Premium local test sites use private HTTP addresses, so their Connect Microsoft button is intentionally unavailable. Configure and complete the live authorisation on an HTTPS WordPress environment.

Create the Microsoft Entra app registration#

Open the Microsoft Entra admin centre and go to App registrations.
Create a new registration and enter a recognisable name such as Regal Send for your website.
Select the supported account type you intend to use. This must match the authority selected later in Regal Send.
Complete the registration and copy the Application (client) ID from the app overview.

Regal Send supports work, school and personal accounts, work and school accounts only, personal accounts only, or one specific tenant. For a tenant-specific connection, copy the Directory (tenant) ID or use a verified tenant domain such as contoso.onmicrosoft.com.

Add the exact Redirect URI#

In WordPress, open Regal Send > Settings.
Select Microsoft 365 / Outlook.
Copy the read-only Redirect URI shown by Regal Send.
In the Entra app registration, open Authentication and add a Web platform.
Paste the exact Redirect URI and save it without changing the path or adding query parameters.

The callback ends in /wp-json/regal-send/v1/oauth/microsoft/callback. Microsoft must return to the same scheme, host, port and path displayed by Regal Send. If your site URL changes, update the Entra registration before reconnecting.

Add the delegated Mail.Send permission#

Open API permissions in the Entra app registration.
Select Add a permission, Microsoft Graph, then Delegated permissions.
Add Mail.Send.
Grant administrator consent only if your organisation requires it.

Do not add application Mail.Send, mailbox-read scopes or directory-read scopes for Regal Send. The plugin sends as the signed-in account through /me/sendMail and does not read the mailbox. See Microsoft’s Mail.Send permission reference for current permission details.

Create and save the client secret#

Open Certificates & secrets in the Entra app registration.
Create a new client secret with an expiry appropriate for your organisation.
Copy the secret Value immediately. Do not copy the Secret ID.
Return to Regal Send and enter the Application (client) ID, account authority and client secret value.
Select Save settings.

A saved secret is never returned to the browser. Regal Send shows a saved status beside an empty replacement field. Entering a new value replaces it; selecting the separate removal option removes it when settings are saved.

Connect the Microsoft account#

After saving the app details, select Connect Microsoft.
Sign in with the account that should authorise sending.
Review and grant the requested access.
Allow Microsoft to return to WordPress.
Confirm that Regal Send shows Connected.

The authorisation flow uses a one-time state value and PKCE. Regal Send stores encrypted access and refresh tokens, refreshes access when needed and removes local tokens when you disconnect. Microsoft Graph returning HTTP 202 means the transport accepted the request; it does not prove delivery to the recipient inbox.

Understand Microsoft connection states#

Not configured: add valid app details, correct the callback environment, then save.
Awaiting authorisation: complete Microsoft sign-in and consent, or reconnect to start again.
Connected: a refresh token is saved and no current authentication error is recorded.
Authentication problem: consent, credentials or refresh access is no longer usable. Reconnect the account.

Opening the settings page does not make a remote Microsoft request. The status changes only after a save, connection, callback, refresh, send or disconnect action.

Troubleshoot common connection problems#

Connect Microsoft is unavailable#

Check that the WordPress site uses HTTPS, that the callback is path-based, and that a valid client ID and client secret value are saved. The button remains unavailable on an HTTP site by design.

Microsoft rejects the client credentials#

Confirm the Application ID, replace the saved client secret with its Value, and check that the secret has not expired. A secret ID is not a usable secret value.

Return to API permissions, confirm delegated Mail.Send is present, satisfy any tenant administrator-consent policy, then reconnect. Regal Send rejects a token that does not include Mail.Send.

The connection later shows Authentication problem#

The refresh token may have expired or been revoked. Select Reconnect Microsoft and complete sign-in again. If the app authority or tenant changed, save the matching settings before reconnecting.

Microsoft accepts the message but it does not arrive#

An accepted result records transport acceptance only. Check the recipient address, junk folder, Microsoft message trace, tenant policies and the sender’s permission to use the configured From address. The Microsoft Graph sendMail documentation explains the accepted response.

Disconnect or replace the integration#

Select Disconnect to delete Regal Send’s local Microsoft access and refresh tokens while keeping the app ID, authority and saved client secret. Use Reconnect when consent or refresh access must be renewed. To stop the app at Microsoft as well, remove its consent or registration through your organisation’s Microsoft account controls.