> ## Documentation Index
> Fetch the complete documentation index at: https://help.edzo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Label

> Learn how to use Image Label blocks to add interactive labels to images and diagrams.

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.

<Info>
  For assessable labeling activities where learners type labels themselves, use the [Image Label Question](/creating/resources/question-blocks/image-label-question) block instead.
</Info>

## 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

<ParamField path="Image" type="image">
  The base image to add labels to. Choose clear, high-quality images where labels will be easily readable.
</ParamField>

<ParamField path="Image fit" default="contain" type="select">
  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
</ParamField>

### Label appearance

<ParamField path="Label style" default="filled" type="select">
  The visual style of the labels:

  * **Filled**: Solid colored background with text
  * **Outline**: Border only with transparent background
</ParamField>

<ParamField path="Label color" default="#2563EB" type="color">
  The color used for label backgrounds (filled style) or borders (outline style).
</ParamField>

<ParamField path="Show lines" default="true" type="switch">
  When enabled, shows connector lines from labels to their anchor points on the image.
</ParamField>

### Labels

Add individual labels to place on the image:

<ParamField path="ID" type="text">
  Unique identifier for this label (up to 120 characters). Useful for organization.
</ParamField>

<ParamField path="Text" type="text">
  The label text to display (up to 200 characters).
</ParamField>

<ParamField path="X" default="50" type="slider">
  Horizontal position of the label as a percentage (0–100) from left to right.
</ParamField>

<ParamField path="Y" default="50" type="slider">
  Vertical position of the label as a percentage (0–100) from top to bottom.
</ParamField>

<ParamField path="Width" default="24" type="slider">
  Width of the label as a percentage of the image width (8–100).
</ParamField>

<ParamField path="Anchor X" default="50" type="slider">
  Horizontal position of the anchor point that the connector line points to (0–100).
</ParamField>

<ParamField path="Anchor Y" default="50" type="slider">
  Vertical position of the anchor point that the connector line points to (0–100).
</ParamField>

## 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

## Related blocks

* [Image Label Question](/creating/resources/question-blocks/image-label-question). Assessable version where learners type labels themselves
* [Image](/creating/resources/media-blocks/image). Basic image display without labeling features
* [Diagram Question](/creating/resources/question-blocks/diagram-question). For more complex diagram-based assessments