Teachable for WordPress

This article goes over how to install and use our new integration with WordPress.

Overview

The Teachable WordPress plugin allows you to seamlessly integrate your Teachable courses and bundles directly into your WordPress website. This provides a unified experience for you to host your content and sell products directly to students through your WordPress interface.

Install the app

To utilize this app, please ensure you have an active WordPress site/blog. This app is available to all plans on Teachable. To install the WordPress app on Teachable you can follow these steps.

1. Navigate to the Settings > Apps page of your school admin. Click the WordPress icon to be redirected to the details page.
2. On the WordPress app details page, click the Install button located at the top right-hand corner of the page.
3. After clicking Install, a new modal will pop up, displaying a WordPress Key.

4. Copy this key to your clipboard, you’ll enter this on your WordPress site to complete installation.
5. Navigate to the official Teachable WordPress plugin by either:
   1. Navigate to Add New Plugin within your WordPress admin dashboard.
      1. Click Install and Activate
   2. Go directly to our official plugin listing.
      1. Click Download
      2. Navigate to Add New Plugin within your WordPress admin dashboard

3. Click Upload and select the file you just downloaded

6. Once installed,  paste your WordPress key into the applicable location within the Teachable plugin settings. 

7. Save once you have pasted your WordPress key. 
   1. You should see your school name displayed below if the correct key was added. If you do not, your key will now display below this post install for quick reference. Please copy and try step 5 again.

How to use Teachable on WordPress

Turning your WordPress site into an online storefront for your Teachable products is as simple as a few clicks. Simply add our new WordPress plugin and choose the product you’d like to feature.

The Teachable WordPress plugin seamlessly adds your product information to your WordPress blog or website without the need to duplicate information and connects directly with Teachable’s secure checkout platform. All you need is a product to sell and you’re ready to go.

After install:

1. Navigate to add/edit any page or post within WordPress.
2. The Teachable block can now be added just like any other block. 

3. Once you add the Teachable Buy Button block, you can choose your product and pricing plans. For your product to be selectable, it must be published and have at least one pricing plan.

4. Customizing your block is easy! Everything is flexible with the only requirement being the link to purchase based on the chosen pricing plan. You can select different parts of the block and click on the styles on the right hand side. From there, you can customize with different colors and sizing.

5. There is no limit to the number of blocks added. In fact, we recommend adding in as many relevant pages/posts as possible to increase your sales!
6. Once you’ve selected your product, pricing plan(s), and customized styling, make sure to click Update in the top right hand corner to save your changes. 
7. You can preview your page by clicking on the View button on the right hand corner of the page. 

Sync Data

If you made changes to your product in Teachable, and don’t automatically see the changes reflected in the block, you can manually update this by syncing your data. 

1. In your WordPress admin dashboard, navigate to Settings > Teachable. 

2. Click on the Sync data tab. Then click on the Sync Now button. 

3. After you’ve synced your data, you can navigate back to your block. You should be able to see the reflected changes you made from Teachable. You can also view your page and see the updated changes on your block.
4. All changes to your Teachable product will automatically sync with WordPress daily. You can set the time you want your products to sync by picking the time in the Sync data tab.
5. After you’ve made your changes, make sure to click Save Changes. 

Uninstall the app

To deactivate the Teachable plugin from WordPress:

1. Navigate to the Plugins section in your WordPress admin dashboard. 
2. Under the Teachable plugin, click Deactivate. 

3. Once you deactivate the plugin, you will no longer be syncing data from Teachable to WordPress. The blocks you’ve added to your page/post will no longer be visible to users. However, you will see the block in your editor page with an error message. 

4. You can delete these blocks or leave them for when you are ready to activate the plugin again. 

To uninstall WordPress from Teachable:

1. Navigate to the Settings > Apps page of your school admin. Click the WordPress icon to be  redirected to the details page. 
2. On the WordPress details page, click the Uninstall button in the top right corner of the page. A popup modal will appear.
3. On the popup modal, click Uninstall to confirm. Once uninstalled Teachable will no longer be able to sync data to WordPress. 

Shortcodes

The teachable_buy_button shortcode is designed to embed Teachable course or bundle purchase options into your WordPress site. It can function independently or with child shortcodes to customize the display. 

If you are using a page editor other than Gutenberg, shortcodes are the best way to utilize our plugin.

Primary Shortcode

Usage:
The primary shortcode can be added anywhere on your WordPress site. It includes all child elements by default.

Syntax:

[teachable_buy_button id="COURSE_ID" /]

Mandatory Field:

• id: The ID of the course or bundle you want to embed. Obtain this ID from the course or bundle information page (e.g., /admin-app/courses/123/information where 123 is the course ID).

Optional Fields:

• plan_ids: A single pricing plan ID or a comma-separated list of pricing plan IDs. Default is the first published pricing plan of the course or bundle.
• button_text: Customizes the call-to-action text (default is "Buy now").
• url_query: Adds URL parameters to the checkout URL for tracking purposes.
• classes: Adds HTML classes for global styling.
• styles: Adds custom inline styling.

Example:

[teachable_buy_button id="123" /]

With optional fields:

[teachable_buy_button id="123" plan_ids="10,20,30" button_text="Get access" /]

 

Child Shortcodes

To display specific child elements or to reorder them, wrap them within the teachable_buy_button shortcode.

Syntax:

[teachable_buy_button id="COURSE_ID"]

    [teachable_child_shortcode /]

    [teachable_child_shortcode /]

[/teachable_buy_button]

Example:

[teachable_buy_button id="123"]

    [teachable_product_image /]

    [teachable_product_description /]

[/teachable_buy_button]

 

Available Child Shortcodes

Frequently asked questions

What version is the Teachable plugin compatible with on WordPress?

We fully support WordPress Versions 6 and up. With testing compatibility up to the current release of 6.5.2. 

Why are my product blocks not up to date on WordPress?

Under your settings page in WordPress, look for the “Sync data” tab. You can set the time you would like for data to sync daily. If you want to sync your data immediately, click on the “Sync Now” button. This should update your Teachable product blocks with the most up to date information from Teachable. 

What happens if I deactivate the Teachable plugin on WordPress?

If you deactivate the Teachable plugin, your product blocks will still remain on your editor page. Please note that these blocks will no longer be synced with up to date data. If you want to remove the blocks, you will need to manually delete them from the page. 

What happens if I uninstall the WordPress plugin on Teachable?

Uninstalling the WordPress plugin on Teachable will delete your integration key. This key is responsible for syncing data to the WordPress product blocks. We do not recommend uninstalling the plugin unless you no longer want to use the Teachable plugin on WordPress.

Why is there an error on my product block?

If you notice an error on your block, it’s possible you may have deleted the product or pricing plan from your Teachable school. It’s also possible you may have deleted your WordPress key in the settings section of the plugin. 

Why does the “buy button” redirect to a broken page?

The reason you are being redirected to a broken page is because your pricing plan may no longer be linked to a product. Please make sure you have the correct product and pricing plan linked on your block. 

How can I edit the course description on my block?

You must go to the block editor within your Teachable course. There is an optional course description hidden in the information page of the course. There, you can edit the course description.

Why is my enrollments number higher than expected?

The enrollments number comprises of total enrollments of all time which may be higher than expected as it includes active and deleted users.

When I have multiple product blocks on a page, why do they all update when I edit one?

If you are editing or changing a product, and you notice other product blocks also update, it's likely that you have added a Teachable product block within another Teachable parent block. Adding a Teachable product block within the parent Teachable product block will make the two connected. Make sure that when you are adding additional Teachable product blocks, they are separate from each other.