Skip to main content
The Image Label block lets you place custom labels on top of images with optional connector lines. It’s perfect for creating annotated diagrams, identifying parts of images, or adding explanatory text to visual content. This is a display block for teaching and demonstration. Learners can view the labeled image but aren’t assessed on it.
For assessable labeling activities where learners type labels themselves, use the Image Label Question block instead.

​
When to use Image Label blocks

Image Label blocks work well for:
  • Creating annotated diagrams for science or anatomy lessons
  • Identifying parts of objects, maps, or illustrations
  • Adding explanatory labels to historical images or artwork
  • Teaching vocabulary with visual associations
  • Providing reference materials with clear annotations
  • Creating visual glossaries or field guides

​
Settings

​
Image settings

​
Image
image
The base image to add labels to. Choose clear, high-quality images where labels will be easily readable.
​
Image fit
select
default:"contain"
How the image is sized within its container:
  • Contain: Shows the entire image, may have empty space around edges
  • Cover: Fills the container completely, may crop parts of the image

​
Label appearance

​
Label style
select
default:"filled"
The visual style of the labels:
  • Filled: Solid colored background with text
  • Outline: Border only with transparent background
​
Label color
color
default:"#2563EB"
The color used for label backgrounds (filled style) or borders (outline style).
​
Show lines
switch
default:"true"
When enabled, shows connector lines from labels to their anchor points on the image.

​
Labels

Add individual labels to place on the image:
​
ID
text
Unique identifier for this label (up to 120 characters). Useful for organization.
​
Text
text
The label text to display (up to 200 characters).
​
X
slider
default:"50"
Horizontal position of the label as a percentage (0–100) from left to right.
​
Y
slider
default:"50"
Vertical position of the label as a percentage (0–100) from top to bottom.
​
Width
slider
default:"24"
Width of the label as a percentage of the image width (8–100).
​
Anchor X
slider
default:"50"
Horizontal position of the anchor point that the connector line points to (0–100).
​
Anchor Y
slider
default:"50"
Vertical position of the anchor point that the connector line points to (0–100).

​
Tips for teachers and parents

Best practices:
  • Use high-contrast images where labels will be clearly visible
  • Choose label colors that stand out against the image background
  • Position labels to avoid overlapping important image content
  • Use consistent label styling throughout your resources
  • Keep label text concise but descriptive
  • Test readability on different screen sizes
Creating effective labeled images: For science diagrams:
  • Use precise terminology appropriate for the age group
  • Point anchor lines to specific parts being labeled
  • Group related labels using consistent positioning or colors
  • Include both common and scientific names when appropriate
For geography and maps:
  • Label major features clearly with good spacing
  • Use anchor points to mark exact locations
  • Consider scale when placing labels on detailed maps
  • Include legend information as separate labels if needed
For anatomy and biology:
  • Use precise anatomical terminology
  • Point to specific structures with anchor lines
  • Organize labels to follow logical groupings or systems
  • Include both structure names and brief function descriptions
For vocabulary and language learning:
  • Pair images with clear, simple labels
  • Use images that clearly represent the vocabulary words
  • Consider adding pronunciation guides as separate text
  • Group related vocabulary items with consistent styling
Layout and positioning strategies:
  • Place labels around the edges when possible to avoid blocking the image
  • Use anchor lines to connect labels to distant image parts
  • Group related labels together for easier reading
  • Ensure adequate spacing between labels to prevent crowding
  • Consider reading direction (left to right) when positioning labels
Accessibility considerations:
  • Use sufficient color contrast between labels and backgrounds
  • Provide alternative text descriptions for complex labeled diagrams
  • Consider font size and readability on mobile devices
  • Test with screen readers if serving diverse audiences