How to install Quidget on WordPress + WooCommerce.

Before you start

Quidget is a WordPress plugin that turns WooCommerce into a telehealth checkout. A patient adds a prescription product to their cart, completes the medical intake inline, gets matched to a state-licensed provider, completes a synchronous Good Faith Exam over video, and the signed exam record returns to the WooCommerce order before fulfillment. The install path below is what we walk every self-serve clinic through. According to Qualiphy, clinics with a working WordPress and WooCommerce stack typically finish under 30 minutes.

Confirm the four things below are in place. Most modern hosts already meet every requirement, but the few clinics that hit friction here usually hit it because PHP is pinned to an old major version or WooCommerce was never activated after install.

You also need a Qualiphy clinic account. If you do not have one yet, sign up at app.qualiphy.me/signup first. The API key you will paste in Step 3 lives in that account.

Step 1. Download the plugin

The Quidget plugin is distributed directly from Qualiphy, not from the public WordPress.org plugin repository. That is intentional: every Quidget release goes through a clinic-side QA pass first, and the download endpoint always serves the current build.

Open the download link below and save the ZIP somewhere you can find it. Do not unzip the file. WordPress installs from the ZIP directly in the next step.

The file is small (a few hundred KB) and downloads in seconds on any normal connection. If your browser warns about an unrecognized publisher, that is expected for self-hosted plugin distributions and safe to dismiss.

Step 2. Install and activate in the WP admin

In WordPress admin, open Plugins, then click Add New at the top of the page. On the Add Plugins screen, click Upload Plugin next to the page title. Choose the qualiphy.zip file you just downloaded, click Install Now, and wait for the success message. Click Activate Plugin.

A new Qualiphy menu item will appear in your WP admin sidebar after activation. That is the Quidget settings panel. If you do not see it, refresh the admin once and check that no security plugin blocked the activation.

Step 3. Connect your Qualiphy API key

Open Qualiphy in your WP admin sidebar. You will see a settings screen with a single required field on the first tab: API Key. Paste your production API key here.

Your API key lives in the Qualiphy clinic dashboard. Open app.qualiphy.me in another tab, log in, open Settings, and copy the API key value. Switch back to the WP admin and paste it. Click Save changes.

On save, the plugin makes a verification call against the Qualiphy API. A green check next to the key means the connection is live. A red error means the key was copied with whitespace or the key has been rotated. Re-copy and re-save if needed.

Step 4. Map your WooCommerce products to Qualiphy exams

This is where you tell Quidget which WooCommerce products require a Good Faith Exam and which Qualiphy exam should fire when a patient buys them. Open Qualiphy > Exam Catalog in the WP admin sidebar.

You will see a list of every Qualiphy exam your clinic has access to (Botox GFE, GLP-1 evaluation, TRT consult, IV therapy, peptide stack, and so on, depending on what your clinic offers). For each exam, pick the matching WooCommerce product or product category from the dropdown. Save the catalog.

A few practical notes from running this with self-serve clinics:

• Map by category when you can. If you sell ten flavors of "Tirzepatide 10 mg" as separate SKUs, mapping the category once is faster than mapping each variant.
• Skip products that do not require a GFE. Cosmetic-only items (vitamins, supplements, branded merch) do not need to be in the catalog. Leave them unmapped and they flow through your normal WooCommerce checkout untouched.
• Variations inherit the parent product's mapping. If a parent product is mapped to an exam, every variation triggers the same exam by default.

Step 5. Embed the consult launcher

Now you tell Quidget where on your site the consult button should appear. The plugin ships with a single shortcode and a matching Gutenberg block. Most clinics drop it in one of three places, and the right choice depends on how you want patients to encounter the exam.

Place options:

• On the product page. Best for clinics that want patients to start the exam before adding to cart. Reduces cart abandonment because patients who do not qualify never see the checkout.
• On the cart page. Best for clinics whose patients shop multiple products. The exam launches once for the whole cart.
• On the checkout page. Best for clinics that want the exam to happen after payment. Closest to a traditional "complete checkout, then book a consult" flow.

If you are using Gutenberg, search for the Quidget Consult block in the block inserter and place it instead of pasting the shortcode. The block accepts the same configuration options through the sidebar.

Step 6. Run a test order, end to end

Quidget is configured. The last step is to prove the loop closes. Place a real order against a test product, complete the exam in the provider window, and confirm the signed Good Faith Exam returns to the WooCommerce order screen.

The cleanest way:

1. Make sure your Quidget settings are using a test-state API key (Step 3). Confirm in Qualiphy > Settings.
2. Add a mapped product to your cart. Use a test address in a test state if your clinic has one configured (your account manager can flag this in the Qualiphy dashboard).
3. Complete checkout normally. The Quidget consult button should appear at the spot you embedded it in Step 5. Click it.
4. Complete the medical intake. The intake form is rendered inline. There is no redirect away from your site at this stage.
5. Join the synchronous video exam window. In test mode, a test provider answers within a minute or two. Run through the exam as a patient would.
6. Return to WP admin and open the WooCommerce order. The signed exam PDF and metadata should be attached to the order.

If all six bullets work, the install is done. Switch the API key from test to production and you are live.

If a test order completes end to end with the GFE attached, every real order will too. The install is just the plumbing for that one loop.

If something is off

The five most common install-time issues, in the order we actually see them across new clinics:

1. Consult button does not render. Almost always the shortcode is on a page Quidget does not consider eligible (a generic blog post, a thank-you page) or an Elementor or Divi template has replaced the WooCommerce checkout page. Move the shortcode to a product or checkout page; switch the page back to the WooCommerce default template; re-test.
2. "Invalid API key" on Settings save. Re-copy the key from the Qualiphy dashboard. The two most frequent causes are a leading space copied along with the key, and the key being rotated for security reasons since the last copy.
3. Exam launches but never returns to the order. Check that SSL is active on the site (Step 1). Quidget posts the signed exam back over HTTPS; an http-only site will silently fail.
4. Cache plugin serving stale catalog. If you use WP Rocket, W3 Total Cache, LiteSpeed, or Cloudflare APO, exclude /cart/, /checkout/, and any page with the [quidget_consult] shortcode from page caching.
5. Patient-facing email never arrives. Qualiphy sends the exam-invite email and SMS via its own infrastructure. If patients are not getting them, check the patient address spelling on the order. The Quidget plugin itself does not send the email.

If none of the five resolve it, email [email protected] with the WP admin URL and a screenshot. The Quidget team usually responds within one business day, often the same hour. A deeper walkthrough of every known plugin conflict will live in a forthcoming Troubleshooting guide in this Articles library.