Adding Content Blocks
Add text, images, videos, and buttons to your pages
Overview
Content blocks (also called widgets) are the building blocks of your pages. Each block serves a specific purpose:
| Block Type | What It Does |
|---|---|
| Text | Display text content |
| Image | Show pictures and graphics |
| Video | Embed video content |
| Button | Navigation and actions |
Adding Blocks
Navigate to the Page
Go to the page where you want to add content.
Click Add Block
Click Add Block in the toolbar (or + button).
Select Block Type
Choose the block type you need from the menu.
Configure in Inspector
Click the block to configure its settings in the Inspector panel.
Tip
Text Blocks
Text blocks display written content like paragraphs, headings, and lists.
Text Block Settings
| Setting | Description |
|---|---|
| Content | The actual text |
| Heading Level | H1, H2, H3, or Paragraph |
| Alignment | Left, Centre, Right |
| Formatting | Bold, italic, lists |
Formatting Options
| Format | Use For |
|---|---|
| Bold | Emphasis, key terms |
| Italic | Titles, definitions |
| Bullet List | Unordered items |
| Numbered List | Steps, sequences |
Writing Good Text
| Do | Don't |
|---|---|
| Keep sentences short | Write long paragraphs |
| Use clear language | Use jargon without explanation |
| Break up with headings | Create walls of text |
| Highlight key points | Bury important info |
Image Blocks
Image blocks display pictures, diagrams, and graphics.
Adding an Image
- Click Add Block → Image
- Block appears with placeholder
- In Inspector, click Upload Image
- Select image file
- Image appears in block
Image Block Settings
| Setting | Description |
|---|---|
| Image Source | The image file |
| Alt Text | Description for accessibility |
| Size | Display size options |
| Alignment | Position on page |
Supported Formats
- JPG / JPEG
- PNG (supports transparency)
- GIF (supports animation)
Recommended Sizes
- Full width: 1200px wide
- Half width: 600px wide
- Thumbnail: 300px wide
- Keep under 1MB for best performance
Tip
Video Blocks
Video blocks embed video content from external sources (YouTube, Vimeo, or a direct URL). For AI-assisted scene-based course videos that compile to MP4 inside Course Builder, use the separate Course Video Studio guide instead.
Supported Video Sources
| Source | URL Format |
|---|---|
| YouTube | youtube.com/watch?v=xxxxx |
| Vimeo | vimeo.com/xxxxxxxx |
| Direct URL | https://example.com/video.mp4 |
Video Block Settings
| Setting | Description |
|---|---|
| Video URL | Link to the video |
| Autoplay | Start automatically (not recommended) |
| Controls | Show play/pause controls |
Video Length Guidelines
| Video Length | Best For |
|---|---|
| 30-60 seconds | Quick demonstrations |
| 2-3 minutes | Explanations, overviews |
| 5-10 minutes | Detailed tutorials |
| 10+ minutes | Consider breaking up |
Tip
Button Blocks
Button blocks provide navigation and actions.
Button Block Settings
| Setting | Description |
|---|---|
| Label | Button text |
| Action | What happens on click |
| Style | Visual appearance |
Button Actions
| Action | What It Does |
|---|---|
| Next | Go to next page |
| Previous | Go to previous page |
| Go to Page | Jump to specific page |
| Exit | Leave the course |
Button Labels
| Action | Good Labels |
|---|---|
| Next | "Continue", "Next", "Continue to [Topic]" |
| Previous | "Back", "Previous", "Go Back" |
| Start | "Start Course", "Begin", "Let's Go" |
| Exit | "Exit Course", "Finish", "Close" |
More content toolkit categories
The Content toolkit is organised into categories such as Text & Headings, Layout, Images, Video & Audio, Cards, Charts, Scenarios, Comparisons, Games, Lists & Tables, Tips & Info, Navigation, Course Elements, and Resources. Exact widgets appear by label in the palette.
| Feature | Guide |
|---|---|
| Ink Scenario (under Scenarios) | Ink Scenario — branching Teams-style conversation block |
| Course video / Video Studio | Course Video Studio |
Tip
Reordering and Deleting Blocks
Changing Block Order
- Select the block to move
- Use up/down arrows in toolbar
- Or drag and drop
- Order changes on page
Typical Page Order
- Heading (text block)
- Introduction (text block)
- Visual (image or video)
- Key points (text block)
- Navigation (button)
Deleting Blocks
- Select the block
- Click Delete (trash icon)
- Or press Delete/Backspace key
Warning
Best Practices
Content Quality
| Do | Don't |
|---|---|
| Proofread text | Leave typos |
| Optimise images | Use huge files |
| Test videos | Assume they work |
| Check accessibility | Ignore alt text |
Page Composition
| Do | Don't |
|---|---|
| Mix content types | All text or all images |
| Keep pages focused | Cram everything in |
| Use white space | Fill every pixel |
| Guide the eye | Create visual chaos |
Troubleshooting
Text not saving
Check for unsaved changes indicator, try manual save, refresh and try again.
Image won't upload
Check file format, reduce file size, try different browser.
Video not loading
Verify URL is correct, check video is public, try different video source.
Button not working
Verify action is configured, check target page exists, test in preview mode.
Next Steps
Content blocks added? Continue to:
- Ink Scenario - Branching Teams-style scenarios
- Course Video Studio - Create compiled course videos with scenes and narration
- Building Quizzes - Create quiz questions
- Editing Your Course - Make changes
- Previewing Your Course - Test everything