LearnPress Instructor Commission - WordPress Plugin

How to Configure LearnPress Instructor Commission for a Multi-Instructor Site

LearnPress Instructor Commission is not just another menu item in the admin area. It is the layer that controls how money is split between the course platform and course authors. In this guide, we will walk through how the Commission add-on for LearnPress works, what to check before installation, where the settings live, how to configure the commission percentage, how an instructor submits a payout request, and how the administrator verifies the result.

This guide is written for site owners, WordPress administrators, online school managers, and developers building a platform with multiple instructors. It does not cover purchasing, license entry, or activation workarounds. We are looking at the situation where the plugin is already available for installation, and the goal is to enable commission calculations without creating chaos in orders, payouts, or user permissions.

The core logic is simple: LearnPress sells a course, the add-on links that sale to an instructor and a commission percentage, the instructor sees the available amount and can request a payout, and the administrator reviews and processes the request. In practice, the complexity is in the details: different percentages for different courses, a minimum payout threshold, PayPal details, request statuses, test orders, and compatibility with other add-ons.

What This Plugin Actually Adds to LearnPress

Core LearnPress gives you the foundation for courses, lessons, students, orders, and the learning process itself. LearnPress Instructor Commission handles a more specific job: splitting revenue between the site owner and instructors. That matters on a platform where courses are created not only by administrators, but also by outside authors, trainers, partner schools, or multiple in-house experts.

In the official documentation, the product appears as the Commission Add-on for LearnPress. In this article, we use the task name, LearnPress Instructor Commission, but we are referring to the same add-on that adds commission settings and a withdrawal mechanism for instructors. That distinction is useful because both names may appear in search results, documentation, and on the ThimPress product page.

What Data Goes Into the Calculation

To configure it clearly, it helps to separate the system into three layers. The first layer is the LearnPress course and its author. The second layer is the order or purchase that generates revenue. The third layer is the commission rule that defines what share of that revenue belongs to the instructor. If you blur those layers together, it becomes easy to debug the wrong thing, for example changing the percentage in settings when the real issue is the order status or the fact that the instructor is not assigned to the course.

The add-on documentation shows a LearnPress > Settings > Commission section where you enable commissions, set the percentage, and configure PayPal withdrawals. It also describes a course management area where the administrator can enable or disable commission for a specific course and control the percentage. That means the plugin is not limited to one global number. Your site gets a central setting plus the ability to manage individual courses more precisely.

Where the User Sees the Result

The result is visible not only to the administrator. The instructor sees a Withdrawals tab in the profile, can enter a PayPal email, specify a request amount, or choose Request all to withdraw the full available balance. The administrator then processes the request in LearnPress > Withdrawals, opens the specific request, uses the Pay on action, and updates the status. In the instructor history, there should be a clear status change after processing, such as completed or rejected if the request is denied.

That workflow is what makes the product useful for course marketplaces. If the site sells courses for a single owner only and instructors do not receive a share of sales, the add-on may be unnecessary. But if the site follows a marketplace model, you otherwise end up tracking everything manually in spreadsheets, which quickly leads to disputed payouts and difficult reconciliation.

What the Add-on Does Not Replace

Commissions are a financial layer on top of the LMS, but they are not a replacement for accounting, instructor contracts, tax records, refund policy, or payment system verification. This article focuses on the WordPress and LearnPress side: how to enable it, how to test it, and how to keep the link between the course, the order, and the payout intact. You still need a separate operational policy for payouts, especially if instructors work from different countries or use different payment details.

Quick takeaway: LearnPress Instructor Commission is useful when a course has an instructor, a sale generates revenue, and the administrator needs a verifiable history of earnings and payout requests.

Who This Commission Model Is Best For

This plugin works best on a site that is not just a storefront for one author, but a system with multiple participants. That might be a corporate training academy, an educational portal with guest experts, a niche catalog of mini-courses, a trainer marketplace, or an online school where authors receive a share of sales from their content.

Before installing it, answer one question honestly: who will actually work with the site? If the instructor only writes lessons and the money stays inside one organization, standard roles and permissions may be enough. If the instructor needs to see how much they earned and submit a payout request, you need a separate mechanism. LearnPress Instructor Commission is built for that second case.

When the Plugin Makes Sense

• The site has multiple course authors. Otherwise, calculating the instructor share becomes little more than a formality.
• Courses are sold through LearnPress and tied to orders. Commission appears when there is a sale, not just a published course.
• The administrator wants to manage payouts inside WordPress. The request, status, history, and ability to verify actions all matter.
• Different courses may follow different rules. In that case, per-course settings are more useful than one percentage for the whole site.
• Instructors need transparency. A payout tab in the profile cuts down on manual questions to the administrator.

When It Is Better Not to Overcomplicate the Site

If the site sells one course, all content belongs to one owner, and there are no instructors, a separate commission layer adds more administration than value. In that case, standard order and payment reporting is enough. The add-on may also be premature if you still have not stabilized course sales, profile pages, email flows, roles, and refunds. First make sure the purchase flow works predictably, and only then add financial splitting.

Another case is complex corporate accounting, where instructor payouts run through an external system, contracts, and closing documents. LearnPress Instructor Commission can help you see accrued earnings and requests, but it does not become a full accounting system. In that setup, the plugin works best as an operational ledger inside the LMS, while final settlement follows the company’s internal rules.

What to Check Before Installation

Commissions depend on an already working LearnPress setup. That makes preparation more important than the ZIP upload itself. If the base LMS is unstable, the add-on will inherit those problems: the instructor will not see the right profile, the order will not reach the expected status, the commission will not calculate at the right moment, and the administrator will start looking for the problem in the payout section.

LearnPress and Course Readiness

Check that LearnPress is installed, activated, and configured correctly: course pages open, a course can be purchased or enrolled in according to your scenario, and the student gets access after a successful order. On a site with multiple authors, it is also important to verify that courses are actually linked to the correct instructors. If the WordPress course author does not match the real instructor, the commission may still calculate technically, but the result will be misleading for the administrator.

The required check before touching financial settings is to create or select a test course, assign an instructor to it, and complete a purchase or test payment in a safe environment. Without that, you cannot tell the difference between a commission issue and a general LearnPress problem.

Roles, Access, and Responsibility

WordPress permissions are built on roles and capabilities. Financial settings should not be handed to users who only create lessons. The administrator or site manager should clearly understand who can change the percentage, who can view requests, and who closes payouts. If several managers work on the site, agree on the process in advance: one person reviews requests, another executes the actual payment, and a third verifies the order if there is a dispute.

That may sound like a small administrative detail, but it protects you from a common failure case: the instructor sees an amount, the administrator changes the status, but the actual transfer has not happened yet or went to the wrong PayPal email. Later in the article, we will look at why a WordPress status should reflect a real action, not serve as a note that says "check later."

Payment Environment and PayPal Details

The add-on documentation describes a Withdrawal Paypal section with Enable, Client ID, Secret Key, and Sandbox Mode fields. Those values belong to the PayPal REST API, which uses an application ID and secret. Treat them as confidential site settings: do not share them in public chats, do not paste them into text-generation prompts, and do not give them to external course authors.

Use a test environment if it is available and configured. PayPal sandbox is useful because it lets you test the form, request, and processing flow without moving real money. But sandbox still requires the correct accounts and credentials. If you see a PayPal error during testing, first verify that the mode and keys match: test data must be used with test mode, and live data must be used with live mode.

Backup and Test Environment

Commissions affect orders, users, and payout history, so the launch is best done on a site copy or at least after a fresh backup. There is no need to delete data or disable half the site just to test. It is enough to prepare a separate test course, a test instructor, and a test student so you can verify the full flow without risking real sales.

Readiness check: if you cannot show a test course, a test instructor, a test order, and the instructor profile page, it is too early to install the commission add-on. Stabilize the base LMS first.

Installation and the First Admin Check

The official documentation describes the standard add-on installation path in the WordPress Dashboard: open Plugins, go to Add Plugin, choose Upload Plugin, upload the ZIP file, click Install Now, and then Activate Plugin. That is the normal WordPress plugin install flow, but for a premium LearnPress add-on the sequence matters: LearnPress should already be working before the commission add-on is activated.

After activation, do not immediately start changing percentages on the live site. First make sure the commission settings section appears in the admin area and that there are no critical warnings. If the site uses admin caching, script optimization, or aggressive security plugins, it is best during testing to disable only the features that interfere with WordPress management screens. Do it selectively, and turn the settings back on after the test.

Initial Post-Activation Checks

1. Open LearnPress > Settings > Commission and make sure the section loads without errors.
2. Check whether the Enable commission feature toggle is available.
3. Open the test course page and confirm that the course is linked to the correct instructor.
4. Log in as the test instructor, or use a safe way to inspect the profile, and find the Withdrawals tab.
5. Do not change production financial settings until you have completed a test order or test purchase.

If there is no Commission section at this stage, do not rush to reinstall WordPress. Check whether LearnPress itself is active, whether the base plugin version meets the add-on requirements listed on the ThimPress page, whether WordPress logs show errors, and whether the commercial add-on has been disabled because of a file conflict. The most useful next step is to make the settings appear first, and only then enable calculations.

How Not to Confuse an Installation Issue With a Calculation Issue

An installation issue shows up before any sale: the menu is missing, the settings page does not open, WordPress shows an activation error, or the instructor profile does not change. A calculation issue appears later: the order went through, the course was purchased, but no commission appears or the amount does not match expectations. Keep those cases separate, because they have different causes and require different troubleshooting.

For clean testing, it helps to keep a short test table: which user was the instructor, which student bought the course, what the course price was, what percentage was set, what status the order had, and whether the amount appeared in the instructor profile. Even if you later delete the test records, that table helps you explain the problem to a developer or support team without guesswork.

Configuring Commissions After Installation

The key add-on area lives at LearnPress > Settings > Commission. This is where you enable the feature, set the default percentage, manage per-course exceptions, and configure PayPal withdrawals. Work through this section from top to bottom: first enable it, then set the percentage, then configure course-level rules, and then review withdrawals. If you start with PayPal before setting a base percentage, the test becomes harder to read.

Enable the Feature and Set the Default Percentage

The Enable commission feature toggle controls whether commissions work at all. If it is off, the other values may still be saved, but you should not expect a commission to be calculated after a sale. For the first test, keep it simple: enable the feature, set an easy percentage, and save the settings. Do not start with a complex setup before you have confirmed the basic flow.

The Commission percent field defines the instructor share. On a typical site, it is easiest to start with one global percentage for all courses, because the math is easier to verify. For example, if the course sells at a simple test price, the administrator can calculate the expected commission in advance and compare it to the amount that appears after the order. This article does not use specific prices because they are not product-specific. What matters is the principle: use a test course with a simple amount so the result is easy to verify by hand.

How to Choose the First Percentage for Testing

Your first test percentage does not need to be the one you will keep on the live site. Its purpose is to confirm that the add-on sees the sale, the instructor, and the commission rule. Choose a value that avoids messy arithmetic, run a test order, verify the accrual, and only then move to your real business rules. If changing the percentage does not automatically recalculate older earnings in your setup, do not assume that is a bug without checking the documentation first. Many systems lock the financial event at the time of sale.

Minimum Withdrawal Amount

The documentation describes the Min ($) field as the minimum amount an instructor must reach before submitting a withdrawal request. That setting helps prevent the site from receiving too many tiny requests. If the threshold is too low, it creates extra operational work. If it is too high, it frustrates instructors who can see earnings but cannot request them.

For launch, choose a value that matches your payout model. If instructors are paid once a month, the minimum threshold can reflect that process. If courses are inexpensive and sales are frequent, the threshold helps batch requests together. If courses are expensive and sales are infrequent, an overly high threshold may feel unfair. After changing the threshold, log in as the test instructor and check how the Withdrawals tab behaves: whether the request button is available, whether the amount is clear, and whether the screen avoids confusing empty states.

Managing Commissions by Course

The Managing section becomes useful when not all courses follow the same rule. The documentation shows a list of courses, the ability to enable or disable commission, and the ability to control the percentage. That supports different business arrangements: one author gets the standard share, another works under a separate agreement, and a third course belongs to the site and should not generate an instructor commission at all.

Do not let per-course percentages turn into chaos. Inside the team, it helps to define in advance which courses follow the default rule, which ones are exceptions, and who approves those exceptions. If the percentage for a course changes after sales have already happened, record the moment of change in a separate note or internal log. Then, if a dispute comes up, it will be clear why one sale was calculated under the old rule and another under the new one.

How to Test a Course-Level Exception

1. Select one test course and assign it a percentage different from the global value.
2. Save the settings in Managing.
3. Complete a test purchase for that exact course.
4. Compare the expected commission with the amount the instructor sees.
5. Repeat the test on a course that uses the normal global percentage and confirm that the rules did not get mixed together.

This check is especially important if the site includes older courses, imported content, or courses with multiple instructors. The more complex the author structure is, the more important it becomes to test not just "any course," but each type of arrangement.

PayPal Withdrawal Settings

The Withdrawal Paypal section controls PayPal configuration. The official documentation lists Enable, Client ID, Secret Key, and Sandbox Mode. These values cannot be guessed. They must match the correct PayPal app and the environment where you are testing or running the site.

If Sandbox Mode is enabled, use test credentials and test accounts. If it is disabled, use live credentials. Mixing test and live environments is a common cause of confusing errors. Also, filling in those fields does not automatically mean a request will turn into a real transfer without administrator involvement. The official documentation specifically explains that the administrator opens the request, chooses Pay on, and clicks Update, so your internal workflow needs a clear definition of what counts as an actual payout.

Security rule: Secret Key is confidential data. Do not share it with course authors, in public chats, in content-generation tasks, or in screenshots for public articles.

How the Calculation Works: From Course Sale to Instructor Balance

To use LearnPress Instructor Commission with confidence, you need to understand not just the menu items but the event sequence behind them. During setup, you define the rule, but money only appears in the plugin logic after a sale. Then the add-on needs to determine which course the order belongs to, which instructor is assigned to that course, and which percentage to apply.

Input: Course, Instructor, and Order

The input data for the calculation is the published course, its instructor, and the order that confirms the sale. If one of those elements is missing or in the wrong state, the commission may never appear. For example, the course exists but has the wrong author; the order was created but never completed; the student was enrolled manually but no sale happened. To the user, all of those cases may look the same: "the commission was not credited." To the administrator, they are very different scenarios.

That is why, when verifying the result, you should not stop at asking whether the course was sold. Open the LearnPress order, check its status, verify the course-to-user connection, and then inspect the instructor profile. If the site uses WooCommerce Add-on for LearnPress, there is one more layer involved: the WooCommerce order status has to pass correctly into LearnPress, and LearnPress itself has to recognize the course purchase.

Rule: Global Percentage or Course-Level Setting

Once the input data is in place, the rule is applied. If the course does not have an individual exception, the system uses the global Commission percent. If Managing sets a custom percentage for that course or disables commission, that state takes priority. That is why it is important during testing to use two courses: one standard and one exception. This confirms that the plugin is not just assigning some amount, but choosing the correct rule.

In larger schools, this part is worth documenting internally. For example, the course "Photography Basics" may follow the standard split, the course "Guest Expert Masterclass" may use a separate split, and a free introductory course may be excluded from commissions entirely. A rule map like that prevents payout disputes after the first real sales come in.

Output: Available Amount and History

The output is the amount the instructor sees in the Withdrawals tab, and the payout request if the instructor submits one. The administrator then sees that request in LearnPress > Withdrawals. It is important not to confuse accrued commission, the amount available for withdrawal, and the amount already paid out. Depending on the request status, the same sale may move through several stages: earned, requested, processed, rejected, or waiting for administrator action.

Common Symptom When the Flow Breaks

If the sale exists but the instructor sees nothing, first check the course-to-instructor link and whether commission is enabled. If the amount is visible but the request cannot be submitted, check the minimum threshold, the PayPal email, and whether the tab is available. If the request exists but the status does not change, check the administrator actions in LearnPress > Withdrawals. That order saves time because it moves from input to output instead of jumping between every setting at once.

How the Instructor Requests a Payout

From the instructor’s point of view, the process should be easy to follow: open the profile, go to Withdrawals, enter a PayPal email, provide the password, choose an amount, and submit the request. The documentation also shows a Request all button that lets the instructor request the full available balance. For the administrator, that means testing not only the tab itself, but also the form, field guidance, post-submit state, and request history.

Form Fields and What They Mean

The PayPal email field should match the account where the instructor expects to receive payment. If the instructor enters the wrong email, the request may still be created technically, but the real payout could be sent to the wrong place or blocked during review. That is why it is worth stating in your site policy that the instructor is responsible for accurate payment details, while the administrator reviews disputed requests before closing the status.

The amount field is tied to the available balance and the minimum threshold. If the instructor enters an amount below the minimum or above the available amount, the form may reject the request. To reduce confusion, give instructors a short internal guide: where to check the available balance, when to use Request all, and why sending several small requests in a row is not a good idea.

How to Explain Statuses to Instructors

The documentation shows that after the administrator processes a request, the instructor sees a status change, including completed or rejected. In user-facing instructions, it is better to explain those states in plain language: request submitted, request processed, request rejected. Do not promise instant transfers if your internal workflow includes a manual review step. The instructor should understand that the profile status and the actual arrival of funds may be separated by an operational delay.

If the site is multilingual, check the translation of the Withdrawals tab and the form messages. Public support discussions show that translating premium add-ons may require help from the vendor. Without a confirmed text domain or translation template, do not invent PHP tweaks. The safe path is to use standard WordPress localization tools and verify the result on a site copy.

What the Administrator Should See After a Request

Once the request is submitted, the administrator goes to LearnPress > Withdrawals. There, the request should be opened and reviewed against the instructor, amount, payout details, and available commission. The administrator then uses Pay on and saves the change with Update. This should never be done mechanically. If the real payout has not been made yet, but the status is already marked as complete, the site history stops matching financial reality.

Practical order of operations: first reconcile the request, then complete the real payout according to your process, and only then update the status in WordPress. Doing it in reverse creates a false audit trail.

Practical Scenario: A Course Platform With Two Instructors

Let’s look at a working scenario that shows the add-on’s purpose clearly. The site has two types of courses: standard school courses and custom courses by invited experts. The school wants to keep a standard instructor share for regular author-led courses, but apply a separate percentage to one expert course. It also needs to verify that the instructor can see earnings and submit a withdrawal request.

Goal of the Scenario

The goal is to produce a verifiable chain: the course is sold, commission is credited to the correct instructor, the exception for the special course works, the instructor sees the Withdrawals tab, and the administrator can process the request. Once that test works, you can roll the settings out to real courses with much less risk.

Preparation

• LearnPress and the LearnPress Instructor Commission add-on are installed on the site.
• A test instructor exists and can access the profile.
• Two test courses have been created: one standard course and one course with an individual percentage.
• A safe test purchase or test order flow is available.
• The administrator already knows the expected percentage and the expected commission amount.

Setup Steps

1. Open LearnPress > Settings > Commission.
2. Enable Enable commission feature and set the global Commission percent.
3. In Managing, find the regular test course and leave it on the default rule.
4. For the expert test course, assign a separate percentage or a separate commission state.
5. Save the settings and clear only the cache that could interfere with the profile or course pages.
6. Run a test purchase of the regular course and verify the commission.
7. Run a test purchase of the expert course and compare the amount against the individual rule.
8. Log in as the instructor, open Withdrawals, and submit a request for the available amount or use Request all.
9. Return as the administrator to LearnPress > Withdrawals, open the request, reconcile the data, and update the status after the real payout action is completed.

Verifying the Result

A successful result looks like this: both test orders appear in LearnPress, the commission for the regular course matches the global percentage, the commission for the expert course matches the course-level setting, the instructor sees the available balance and history, and the administrator sees the request in the withdrawals list. If any one of those items fails, do not move on to live sales. Find the point where the chain broke.

A Detail People Often Miss

If the site uses WooCommerce Add-on for LearnPress, test not only the LearnPress course page but also the order path through WooCommerce. For commission purposes, what matters is not how polished the checkout looks, but whether the course purchase is ultimately reflected in LearnPress the way the commission add-on expects. In unclear cases, first test the sale without extra optimizations, coupons, custom statuses, or third-party automation, and then re-enable those pieces one at a time.

How to Verify the Result After Launch

After setup, do not stop at visually checking the Withdrawals tab. A real result check should go through the full financial chain. This matters even more if the site is already accepting real payments, because a commission issue may not become obvious until several sales and disputed requests have accumulated.

Administrator Verification Chain

1. Check the course. Make sure the course is published, linked to the correct instructor, and included in commission rules.
2. Check the order. Make sure the order has the expected status and belongs to the correct course.
3. Check the rule. Compare the global percentage with any course-level exception.
4. Check the instructor profile. Open the Withdrawals tab and make sure the amount is visible.
5. Check the request. Submit a test request and find it in LearnPress > Withdrawals.
6. Check the status. After processing, confirm that the instructor history has been updated.

If you cannot get through one of those steps, document the exact point where the process stopped. The statement "the plugin does not work" is useless for troubleshooting. The statement "the order is completed, but the amount does not appear in the instructor profile" already points you toward a concrete check of course assignment, percentage, and order status.

How to Reconcile the Amount Without Errors

For testing, use a course with a simple price and no coupons, taxes, complex discounts, or external automation. Then compare the expected share against what the instructor sees. If the site uses taxes, discounts, refunds, or a WooCommerce-based order chain, the final amount may depend on which base the system uses for the calculation. Do not draw conclusions from one complicated order. First prove that a simple sale works, and only then add complexity.

For production operations, it is helpful to keep an internal log of percentage changes. This can be as simple as a note in your task management system: date of change, course, old percentage, new percentage, and who approved it. We do not treat dates as a required interface element in this article, but inside the team that record makes payout discrepancies much easier to explain.

How to Roll Back a Disputed Setting

If a new percentage, withdrawal threshold, or PayPal setting produces an unexpected result, do not change everything at once. Revert only the last disputed setting, save it, clear the relevant cache, and rerun the test flow. If the issue disappears, the cause was the last change. If not, check dependencies: order status, course author, user permissions, PayPal mode, and other LearnPress add-ons.

A good rollout path: start with one test course and one instructor, then test a course-level exception, then test the WooCommerce scenario, and only then move to live courses. That makes errors easier to isolate without disrupting the whole platform.

Reporting, Statuses, and Disputed Payouts

Commission becomes a practical working tool only when the team interprets statuses and history the same way. In a small school, the administrator often knows all instructors personally, so it may seem like a separate process is unnecessary. But once you have multiple authors, different percentages, and irregular sales, simple trust is no longer enough. You need a clear reconciliation path: why the amount appeared, why it is available for withdrawal, and why a request was closed or rejected.

The official documentation shows two important history locations: the instructor’s Withdrawals tab and the administrator’s LearnPress > Withdrawals section. The first screen is for the course author, the second for the payout manager. If one side sees one state and the other expects something else, the conflict usually comes not from the percentage math, but from the team never agreeing on which status means "money has already been sent" and which means "the request is still under review."

How to Read a Request Status

The documentation shows post-action states including completed and rejected. In working instructions, do not translate those too loosely. Completed should mean the request has gone through your internal process and the administrator did not just click a button, but actually completed the payout action or recorded it according to the school’s rules. Rejected should mean the request cannot be processed in its current form: invalid PayPal email, insufficient amount, a disputed sale, a refund, or another confirmed reason.

If you use completed to mean "I looked at the request," the system quickly loses all value. The instructor will see a finished status without understanding why no money has arrived. Later, the administrator will no longer be able to distinguish real closed payouts from requests that only passed an initial review. That is why you should not change the status before the actual event happens, no matter how simple the request looks.

Refunds, Cancellations, and Manual Adjustments

A payment refund or order cancellation is one of the most difficult cases for commissions. The public add-on documentation does not provide a universal accounting model for every possible refund scenario, so you should not promise automatic adjustment across the board. The safe recommendation is this: if a sale was canceled or refunded, manually review the order, the student’s access, the instructor accrual, and the payout status on a site copy or in a controlled process. If the instructor has not been paid yet, it is better not to close the disputed request before reconciliation.

It is helpful for the team to adopt a rule that a commission request is checked not only against the profile amount, but also against the list of orders that produced that amount. If you have many sales, you do not need to list every purchase in the instructor-facing article. But the administrator should still have an internal way to explain why the amount is available or why part of it is temporarily being held back.

Simple Procedure for a Disputed Sale

1. Find the order that caused the dispute and check its current status.
2. Verify whether the student was granted course access and whether that access was later revoked.
3. Compare the commission percentage at the time of sale with the current course setting.
4. Do not close the instructor request until it is clear whether the disputed sale belongs in the payout amount.
5. Record the decision in the internal log so the next administrator does not have to repeat the entire review from scratch.

This process does not replace legal policy, but it helps you stay technically organized. It is especially important on sites where the instructor may promote the course directly while the student contacts the administrator for a refund.

How to Keep a Change Log Without Bureaucratic Overhead

Your internal log can be very simple. It only needs to capture four things: what setting was changed, who changed it, why it was changed, and from which course or course group the new rule applies. For commissions, this matters more than for many other settings because the percentage affects people’s expectations. If an instructor saw one share when the course launched and the course was later moved to another rule, there should be a clear reason.

You do not need a complicated audit module. For a small site, a task in your work system, a private document, or an admin note is enough. The key is not to keep those decisions only in one person’s memory. When someone asks, "why is the amount different for this course," the team should be able to pull up the log and answer with facts.

How to Launch Commissions on a Live Site With Minimal Risk

The safest rollout strategy is not to enable everything at once for every course. Even if the settings look simple, financial logic is always sensitive to small differences: one course has a different author, another uses a different payment path, a third is sold through WooCommerce, and a fourth was created before the add-on was installed. That is why a live rollout is best done in stages.

Stage 1: Closed Testing

Start with a site copy or staging environment. Create a test instructor, a test student, and two test courses. Leave one course on the global percentage and configure the other as an exception. Run the entire flow: setup, purchase, instructor profile, payout request, and processing in the admin area. At this stage, it does not matter whether the emails or translations are polished. What matters is proving that the mechanism works.

If the closed test fails, do not move the add-on to the live site. Fix the issue in the test environment, rerun the scenario, and only then proceed. That may feel slower, but in a financial workflow one missed error can cost more time than the entire preparation phase.

Stage 2: One Real Course and One Instructor

After a successful closed test, choose one course with a simple price and one instructor who is willing to participate in the check. Explain where the Withdrawals tab is, what the minimum withdrawal threshold is, when they can submit a request, and what the status means after processing. That pilot tests not only the technical side, but also the usability for the person who will use the system regularly.

During the pilot, do not change several conditions at once. If you enable the WooCommerce flow, switch themes, add co-instructors, and turn on aggressive caching all at the same time, any resulting error becomes hard to trace. Add dependencies gradually, checking the result after each one.

Stage 3: Apply the Rules to the Course Catalog

Once the first real course works, apply the rules to the rest of the catalog in groups. Start with courses that use the standard percentage. Then move on to the exceptions. For each exception, verify that it is actually needed and formally approved. There is no reason to create a separate percentage just because the interface allows it. The more exceptions you introduce, the harder it becomes to maintain a fair and understandable system.

At this stage, it helps to prepare a short guide for instructors: where to check the balance, when to submit a request, what to do if the PayPal email is wrong, who to contact about disputed sales, and why a request might be rejected. That kind of guide reduces support load and turns the add-on into part of the workflow instead of a hidden admin setting.

Stage 4: Routine Checks After Updates

After updating LearnPress, the Commission add-on, the WooCommerce Add-on, or the theme, repeat a shortened test. It is enough to verify one course with the global percentage, one course with an exception, the instructor tab, and request processing. If the site sells courses actively, it is best to do this before the workday starts or at a time when you can quickly observe the first real orders.

If an error appears after an update, do not roll everything back before you understand the cause. First identify which part of the chain broke: the settings will not open, the tab is missing, the order does not create commission, PayPal does not respond, or the status will not save. Then revert only the component that actually caused the problem, or contact the vendor documentation and support with a precise scenario.

Working Alongside Co-Instructors, WooCommerce, and Localization

LearnPress Instructor Commission rarely operates in isolation. On a real site, it often runs next to other LearnPress add-ons, payment modules, the theme, caching, and translation tools. The important thing is to separate officially confirmed capabilities from practical integrations that still need to be tested on your own site copy.

Co-Instructors for Courses With Multiple Authors

ThimPress also offers Co-Instructors Add-on for LearnPress. It is designed for cases where a course is created by more than one instructor. The Commission add-on page mentions a connection with co-instructors, and the Co-Instructors page describes how to assign multiple instructors to a course. That can be a useful pairing for expert-led programs where one course is run by an instructional designer, a practitioner, and a guest speaker.

With that model, do not promise instructors anything you have not tested technically. First create a test course with multiple instructors, configure commissions, complete a sale, and see exactly how the system reflects the revenue. If you need a complex contractual split between multiple authors, document those rules separately. The add-on helps manage the commission layer, but the final financial policy still belongs to the site operator.

WooCommerce Add-on for Store-Based Course Sales

If the site sells courses through WooCommerce Add-on for LearnPress, the chain becomes broader: WooCommerce product or order, LearnPress course, student, instructor, and commission. That is convenient when the store needs payment gateways, cart functionality, coupons, or other WooCommerce features. But for commission tracking, it also means one more checkpoint. It is not enough to see a successful WooCommerce order. You also need to confirm that LearnPress received the correct course event.

The safe sequence is this: first test commission in a simple LearnPress-only scenario, then enable the WooCommerce path, then place a test order without a coupon, and only after that test the conditions actually used on the site. If the commission does not appear after a WooCommerce order, do not change the percentage right away. First check the order status, the product-to-course relationship, and how the WooCommerce Add-on passes purchase completion into LearnPress.

Translating the Withdrawals Tab and System Strings

On a non-English site, it is important that instructors understand the withdrawal form. But the public documentation does not provide a safe universal PHP snippet for renaming every string in a premium add-on. That is why the best route is standard WordPress localization: PO/MO files, language packs, or a translation tool that does not edit plugin files directly. Keep translations outside the plugin core so they are not lost during updates.

If a specific string will not translate, first check whether it appears in the available translation strings, then consult the documentation or the vendor’s support team. Do not insert unverified filters or edit add-on files inside the plugin folder. Editing plugin files directly is a poor fallback, because an update can wipe your changes, and a PHP error can affect the financial area of the site.

Caching, Profiles, and the Front End

The withdrawals tab belongs to the user profile. Pages like that usually should not be cached the way a regular public page is cached. If the instructor sees an outdated balance or does not see the tab after settings change, check profile-page caching, object caching, JavaScript optimization, and security-plugin settings. For testing, temporarily exclude only the profile and LearnPress pages instead of disabling all optimization permanently.

After excluding the page from cache, rerun the test under the specific user account. If the issue disappears, create a permanent exclusion for dynamic LearnPress pages. If not, look at roles, order statuses, whether the commission feature is enabled, and the PayPal settings. That approach does not guarantee universal compatibility with every cache plugin, but it gives you a safe troubleshooting order.

Troubleshooting Commission and Payout Issues

Problems with LearnPress Instructor Commission often look similar: no commission, no tab, request will not submit, status will not change, PayPal throws an error. But the causes are different. Below is a practical symptom map that helps you move from the simplest checks to the more complex ones without disrupting a working site.

Commission Does Not Appear After a Sale

Symptom: the student bought the course, the order exists, but the instructor does not see any accrual. First check that Enable commission feature is turned on and saved. Then open the course and make sure it is linked to the correct instructor. After that, check the order status. If WooCommerce is involved, confirm that the order reached the state after which LearnPress grants course access.

How to fix it: run a new test purchase after enabling the feature and confirming the course assignment. Do not judge the result based on an old order created before configuration unless the documentation explicitly confirms that it will be recalculated. If a new simple sale works, the problem was in the launch sequence or in that specific order.

The Instructor Cannot See the Withdrawals Tab

Symptom: the administrator sees the settings, but the instructor does not see the Withdrawals tab in the profile. Possible causes include the commission feature being disabled, the wrong user account, cached profile pages, a theme overriding the LearnPress profile output, or a conflict with another plugin.

What to check: log in as a test instructor who actually has a course, clear the profile-page cache, temporarily disable script optimization on that page, and check the default LearnPress output. If the tab appears in a clean configuration, restore the extensions one by one and find the conflict.

The Instructor Cannot Submit a Request

Symptom: the amount is visible, but the form will not submit or no request is created. Check the Min ($) value, the PayPal email, the requested amount, and all required fields. If the instructor is trying to request less than the minimum threshold, that is not a technical failure. It is the expected behavior of the setting.

How to fix it: for testing, temporarily set a clear minimum threshold that is lower than the available amount and submit the request again. If the problem goes away, restore the real threshold and explain it to instructors. If not, check for JavaScript errors on the profile page and for conflicts with the theme or caching.

PayPal Rejects the Data or the Test Fails

Symptom: you get a PayPal error during testing, the request is not processed, or sandbox mode does not behave as expected. Check whether sandbox credentials are being mixed with live mode. The PayPal REST API uses Client ID and Secret Key, and they must match the correct app and environment.

How to fix it: enable test mode only with test credentials, verify the PayPal sandbox accounts, run a short test, and only then switch to live credentials. Do not publish the Secret Key in a support thread, and do not send it to course authors. If you need help from a developer, provide only safe screenshots with secrets hidden and a precise description of the error.

The Request Exists, but the Status Does Not Change

Symptom: the instructor submitted a request, the administrator sees it in LearnPress > Withdrawals, but the history does not update or the status remains unchanged. Check whether you opened the specific request, used the Pay on action, and clicked Update. Sometimes the administrator only looks at the list and never saves the change inside the request.

When to roll back: if the status was changed by mistake, do not create fake requests just to repair the history. Record the error in the internal log and clarify the correct process in the team documentation. If your version of the add-on supports reversing or reprocessing, use only the confirmed interface for that version.

The Amount Does Not Match Expectations

Symptom: the commission appears, but the number does not match the manual calculation. Check which percentage was applied: the global value or a course-level exception. Then look at the sale price, coupons, taxes, refunds, order status, and any additional WooCommerce layers if they are enabled.

Safe verification: create a new test course with no discounts or extra conditions. If the calculation is correct for the simple course, the issue is not in the base commission setup but in the additional order conditions. Reintroduce those conditions one at a time and note the point where the amount changes.

Settings Worth Documenting Internally

Even the cleanest plugin cannot solve organizational questions for your team. A commission model needs internal rules: who approves the percentage, who changes course-level exceptions, how often requests are processed, what to do with refunds, how to verify the PayPal email, and how to keep a history of disputed cases. If those rules are not written down, the administrator will end up making the decision from scratch every time.

A Rule Map for Courses

Create an internal list of courses by commission type: standard share, individual share, no commission, temporary exception. In WordPress, this may be reflected through Managing, but the team still needs to understand the reason behind each rule. That kind of map is especially helpful after updates, after a manager handoff, or when new instructors are added.

Payout and Reconciliation Process

Document how often the administrator checks LearnPress > Withdrawals, who confirms the amount, where the real payout is recorded, and how the instructor is notified when a request is rejected. This does not need to become a complicated policy document. A short working rule is enough: the request is reviewed against orders, payment details, and the available balance; the status is updated after the real payout; disputed requests are not closed without a comment.

Updates and Post-Update Testing

LearnPress and its add-ons receive updates, so after updating the LMS core or related add-ons, it is worth rerunning a shortened test: the settings page opens, the percentage is saved, the Withdrawals tab is visible, a test request can be created, and the administrator can change the status. You do not need to retest the entire school every time, but the financial chain deserves dedicated attention.

If the update affects LearnPress, the WooCommerce Add-on, Co-Instructors, or the PayPal-related part, do not deploy it directly to a live site with active payouts. Test it on a site copy first, then update production during a window when you can quickly monitor the first incoming orders.

Where to Watch a Setup Video

The official ThimPress page includes a tutorial link to a video about the Commission Add-on for LearnPress. It is best used as a visual companion to the setup sections, not as a replacement for your own verification. Video helps you understand where the screens are and what the general flow looks like: enabling the add-on, going to commission settings, checking the instructor view, and reviewing payout requests. After watching it, you should still run a test order on your own site, because your theme, payment setup, and other add-ons may be different.

The practical value of the video is that it answers questions like "how do I use LearnPress Instructor Commission" and "where are the LearnPress commission settings located." But if the interface in the video differs from what you see on your site, rely on the current official documentation and the actual screens in your WordPress admin area.

When LearnPress Instructor Commission Is the Right Choice

LearnPress Instructor Commission is worth using if your LearnPress site is already ready for an instructor-based model: courses are assigned to authors, orders move through a predictable flow, user profiles work, and the team understands who is responsible for payouts. In that situation, the add-on helps turn scattered manual tracking into a clearer workflow inside WordPress: percentage rule, accrual, request, processing, and history.

If you are only testing the idea of an online school, start with one test course and one simple scenario. Set a global percentage, run a single test purchase, check the instructor profile, create a request, and process it as the administrator. Then add course-level exceptions, the WooCommerce scenario, co-instructors, and real payout rules. That order reduces risk and makes it much easier to see where the product is actually helping.

Once the base flow is verified and the limitations are clear, you can download the latest version of LearnPress Instructor Commission and test it on a site copy or staging environment. Do not move the commission model into real payouts until you have proven with a test order that the course, instructor, percentage, request, and status all work as one system.