AWP Support Desk is a self-hosted support ticket system that runs entirely on your WordPress site. This guide takes you from install to first answered ticket: activating the plugin, running the three-step setup wizard, publishing the customer portal and opening the first conversation. It takes about ten minutes.
What you need #
- WordPress 6.6 or newer and PHP 8.1 or newer.
- An administrator account on the site.
- Nothing else. The plugin makes no external calls, needs no third-party account and works with block themes and classic themes.
Install and activate #
- In your WordPress admin, open Plugins → Add New and upload the plugin, or copy the
awp-support-deskfolder into/wp-content/plugins/. - Open the Plugins screen and activate AWP Support Desk.
- Activation creates the ticket tables in your own database, adds the four support roles and prepares the setup wizard. Your data stays on your server.
- Open Support Desk in the admin menu. The agent inbox opens, and Support Desk → Setup holds the wizard.
Run the setup wizard #
The wizard has three steps. You can pause at any point and come back later from Support Desk → Setup; your progress is saved and the inbox never blocks on it. Only administrators can run the wizard.
- Open Support Desk → Setup.
- Customer portal. Select the published page that will hold the portal, or use Create a portal page for me, which creates and publishes a page with the shortcode already inside.
- People and notifications. Review the support roles on the site and set the Notification mailbox, the address that receives new tickets and customer replies.
- First test ticket. Open a ticket to check the inbox and the notifications, then finish the wizard.
Create the portal page manually #
If you prefer to set up the portal page yourself:
- Create a normal WordPress page, for example Support.
- Add the
shortcode or the AWP Support Portal block to the page content.Log in to open a support ticket and review your conversation history.
- Publish the page.
- Go to Support Desk → Settings, select the page under Customer portal page and save. Links in notification emails point to this page.
If your theme is a block theme, the portal inherits its palette, fonts, button styles and corner radius automatically.
Open your first real ticket #
- In Users → Add New, create an account for a customer and assign the Support customer role.
- Ask the customer to open the portal page and log in with their WordPress account.
- The customer submits the new-ticket form. The staff mailbox receives the notification.
- Open Support Desk, open the ticket and reply from the ticket detail screen.
- The customer receives the reply by email and in the portal thread.
Automate from the command line #
For migrations and integrations, three WP-CLI commands cover the common operations. Each command enforces the same permissions as its screen, so run them with --user=<admin>:
wp awp ticket list --status=open --assignee=3 --format=json
wp awp ticket create --customer=12 --subject="Printer offline" --body="It stopped printing on Monday." --porcelain
wp awp ticket assign 7 --agent=3
list also outputs table, csv, ids and count; create accepts --priority; assign accepts --unassign to clear the assignee. Developers who prefer HTTP can use the REST API under /wp-json/awp/v1/, authenticating with WordPress application passwords.
What deleting the plugin keeps #
Deleting the plugin keeps your data by default: tickets, messages, attachments, settings and the support roles remain in the database. To remove everything when the plugin is deleted, set the awp_delete_data_on_uninstall option to true first. On a multisite network this cleanup runs for every site, and users who only held a support role move to the Subscriber role so that no account is left without one.
One honest limit to plan around: the Free plugin does not convert inbound email into tickets, has no knowledge base and its reports are basic. Those belong to the paid Pro add-on.
Next steps #
Your desk is live. Point agents to the agent inbox guide and customers to the customer portal guide. Before launch, read the email notifications guide so the right mailbox receives every ticket. The product page summarizes the full feature set, and the plugin is available on the WordPress.org listing.