What You’ll Learn
How to access the Lesson Editor
The different content blocks you can use (text, images, video, audio, PDF viewer, code snippets, media embeds, etc.)
How to add educational tools (quizzes, open ended responses)
How to integrate marketing tools (upsells, referrals)
How to add custom code and apps
How to generate AI-powered quizzes and lesson summaries
How to rearrange, download, or delete lesson blocks
1. Open the Lesson Editor
Log in to your Teachable admin.
In the sidebar, select the course you want to edit.
Click the Curriculum tab, then either select an existing lesson or create a new one.
Within the Lesson Editor, click Add Content to see available content block options.
For help with adding/removing lessons or sections, see the Sections and Lessons article.
For uploading many files at once, use the bulk upload feature.
Tip: You can keep lessons unpublished while working on them. Unpublished lessons are not visible to students.
2. Add Different Types of Content
Next, add a variety of content to your lessons to enrich the learning experience of your students. Learn more about the different content types below.
After adding a block, click Preview to see how it looks, then Publish to make it available to students.
For a list of supported file types available on Teachable, learn more about file types and recommended image sizes.
Text & Images
Use the Text & Image block to add formatted text and images.
The editor is a "What You See Is What You Get" or WYSIWYG text editor — what you type and format is how it appears to students.
Available formatting tools include: headers, alignment (left/center/right), bold, italic, underline, hyperlink, blockquote, code, lists (bulleted/numbered), color (RGB/HEX/HSL), horizontal rule, clear formatting, images.
To add text and images:
Click the Text & Image block. A pop-up appears.
Enter your text into the editor; formatting tools will appear.
3. To embed an image, click the image icon → drag or select your image from your device.
4. Resize by dragging corners or click Edit over the image to set width.
5. When done, click Save. The content appears in the lesson’s content list.
To edit later, click the Edit icon on the block, make changes, then click Save. If the lesson is published, changes are immediately visible to students.
Tip: For a soft line break (e.g., between paragraphs or items), use Shift + Return (on Mac) or Shift + Enter (on PC).
Generate content with AI:
You can also use the AI assistant tool inside the Text and Images block to help generate content within the lesson block by writing in a prompt.
Advanced settings also allow you to set the length of text, as well as set whether you would like the style of the text to come across casual, neutral, or formal.
Note: Teachable ensures your content is never used to train external AI models — your work remains your own and private.
Video
Use the Video block to upload or embed YouTube or Vimeo videos. You can also:
Enable students to download the video
Embed a video:
Choose the Video block. A pop up appears.
Toggle to Embed.
Paste a YouTube or Vimeo link.
Click Add Video.
Upload a video file:
Select the Video block. A popup appears.
Drag and drop video files, or select from your device or cloud storage service.
Click Upload.
Important: Larger video files may take several minutes to upload and optimize.
After upload:
Click the gear icon (settings) on the video block to change thumbnail or add subtitles (see GIF above)
To allow download, toggle the “Show download link” setting.
If you’ve updated the thumbnail, refresh your browser to see changes.
NOTE: Depending on the size of the video file, it may take several minutes for the video to upload and optimize within the lesson editor. If you have updated the thumbnail, refresh the page within your browser to see the changes.
PDF Viewer
Use the PDF Viewer block to embed PDFs directly in the lesson so students can read them without downloading.
You can optionally allow students to download the PDF.
To add a PDF:
Click PDF Viewer in the Lesson Editor. A popup appears.
Drag or select the PDF from your device or cloud storage service.
Click Upload.
To enable downloads, click the gear for PDF Settings and toggle “Show download link” for each PDF.
Audio
Use the Audio block to upload audio files that students can stream.
You can also make audio downloadable.
To add audio:
Click the Audio block. A popup appears.
Drag in or select your audio file from your device or cloud.
Click Upload.
To allow students to download, toggle the “Show download link” setting.
Banner Image
Use the Banner Image block to add full-screen, high-resolution images.
You can allow students to download the image.
To add a banner image:
Click the Banner Image block. A popup appears.
Drag or select your high-resolution image from your device or cloud storage service.
Click Upload.
To enable download, toggle “Show download link” after upload.
Note: If you want images with text or formatted content, use the Text & Image block instead.
Resources (Files for Download)
Use the Resource block to add files your students can download (e.g., Word docs, Excel, PowerPoint).
These files are not viewable directly in the lesson — students must download them to view.
To add a resource file:
Click the Resource block. A popup appears.
Drag or select your file (from your device or the cloud).
Click Upload.
Important: Make sure your students have the appropriate applications to open the resource. For example, a Word file needs Microsoft Word (or compatible software) to open.
Code Example
Use the Code Example block to show code in read-only form (students can view, but not run).
Supported languages include: CSS, Dart, Go, Haskell, HTML, Java, JavaScript, JSON, Liquid, MySQL, Objective-C, PHP, Python, Ruby, Scala, Text, TypeScript, YAML.
To add a code example:
Click the Code Example block. A popup appears.
Select your language from the dropdown.
Enter your code in the block.
Click Save.
To add more examples (e.g., in other languages), repeat steps 1–4.
To edit a code example, click Edit, make the change, then click Save.
Embed Media
Supported third-party embeds include: Vimeo, YouTube, Loom, Google Docs, and Typeform.
NOTE: Course compliance is not available for embedded video content.
To embed content:
Click the Easy Embed block. A popup appears.
Paste the URL of the content you want to embed.
Click Embed.
Tip: Make sure the URL you're embedding is public. For Google Docs, for example, use “Publish to web” so students can see it.
3. Add Educational Tools (Quizzes, Open Responses)
Quizzes
You can evaluate student progress by adding quizzes inside lessons.
There are two types of quizzes:
Non-graded quizzes: Scores are not tracked in Reports, and course-compliance settings don’t apply.
Graded quizzes: Scores are reported in the Reports section, and compliance settings apply.
Note: Only one quiz block can be added per lesson.
To create a quiz:
Click the Quiz block. A popup appears.
Add your first multiple-choice question and possible answers.
Mark which answers are correct (you can select multiple if needed).
To add more questions, click New question, then repeat.
Once finished, click Save quiz.
If you need to change or delete a question or answer, click Edit (or the trash can icon). Deletion is permanent. Don’t forget to Save when you’re done.
Quizzes are Non-graded by default. To turn on grading, open the Quiz settings (gear icon) and toggle on the grading option.
4. Create AI-Generated Quizzes
This feature is part of Teachable’s AI Hub.
Before generating, be sure you have first added all relevant lesson content.
Note: Teachable does not use your content to train external AI models — your work remains yours.
To generate an AI quiz:
Click Add Content → Select a Quiz block → Click "Generate questions"
In the popup, click Generate. Teachable will create quiz questions based on the lesson content.
Edit or add questions if needed.
When ready, click Save quiz.
At any time after saving, you can also edit your quiz content.
5. Add Marketing Tools
You can use lesson content to promote other products and grow your school by using the following lesson block types:
Upsells: Include links or offers for other products directly in your lesson pages.
Referrals: Add your referral program directly into lessons.
Each of the above lesson blocks has a dedicated article, we encourage you to click through the links above to learn more.
6. Use Advanced Tools such as Custom Code or Third Party Apps
If you want more customization than the default blocks allow, you can add your own code or connect an external app.
For example, you can use the Custom Code block to embed live video streams or webinars directly into a lesson that not supported via our Embed Media block. You can also use the Custom Code block to embed forms and other materials to your lessons.
Tip: To add a code example, or code that is not active on the page, please use the Code Example block.
Custom Code
Click the Custom Code block. A popup appears.
Paste or write your code in the block.
Click Save.
Note: Custom code is supported on the Basic plan and higher.
Course compliance features do not apply to embedded content via code.
Teachable Support does not guarantee the functionality, maintenance, or compatibility (current or future) of your custom code, including mobile/web display.
Add Zoom App
You can add a Zoom integration directly from a lesson content block. To make these blocks available, follow the integration instructions available in the following articles:
Learn more about our App Hub in general here.
7. Generate an AI-Powered Lesson Summary
The Lesson Summary feature is part of Teachable’s AI Hub.
To use it:
Create your full lesson content.
Select the Lesson Summary block. You can drag it to the top of the lesson.
Click Edit to tweak the summary as needed.
Note: Teachable ensures that your content is never used to train AI models—your work remains yours, always.
8. Rearranging, Downloading, or Deleting Content Blocks
Rearrange Blocks
To change the order of content in a lesson, use the drag-and-drop handle (six dots) on the left side of each block.
Download Block Content
Click the three-dot (more options) icon on a downloadable block.
Select Download to save content.
Note: Download is only available for blocks that support downloadable content.
Delete a Block
Click the three-dot (more options) icon → Delete.
Confirm deletion.
You can also delete entire lessons or sections. For that, refer to the Deleting Lessons and Sections article.
Important: Deleting a block is permanent and cannot be undone.
9. Frequently Asked Questions (FAQ)
Why is the hyperlink in the text block not working?
When adding a hyperlink to a text box, be sure to include "http://" or "https://" in front of the URL. This will ensure the link redirects to the appropriate page.
What is the maximum file size for uploads?
The maximum file size for uploaded files is 20GB.
Q: How do I add content from Google Drive, Dropbox, OneDrive, etc?
A: Within the file uploader, you can choose to add files directly from your device, or you can connect to the following third-party applications to add files to your lesson:
To connect:
Click on the third-party application from the sidebar list.
Login using your credentials for that specific site.
After login, click Allow to grant permission for the file uploader to access the content in your cloud storage account.
Options from that account will display within the file uploader once connected.
File naming: Avoid special characters in file names (like %, &, *, $, ', etc.). Use letters, numbers, dashes, and underscores to prevent upload issues.