Skip to content
Docs/Annotation Types

Slider

Continuous numerical input with a draggable slider.

Slider Annotation

The slider type provides a draggable slider for selecting numeric values within a range. Ideal for confidence ratings, intensity scores, or any continuous numerical input.

Basic Configuration

yaml
annotation_schemes:
  - name: "confidence"
    description: "How confident are you in this answer?"
    annotation_type: "slider"
    min: 0
    max: 100
    step: 1
    default: 50

Configuration Options

FieldTypeRequiredDescription
namestringYesUnique identifier for the annotation
descriptionstringYesInstructions shown to annotators
annotation_typestringYesMust be "slider"
minnumberYesMinimum slider value
maxnumberYesMaximum slider value
stepnumberNoIncrement value (default: 1)
defaultnumberNoInitial slider position
min_labelstringNoLabel for minimum end
max_labelstringNoLabel for maximum end
show_valuebooleanNoDisplay current value (default: true)

Examples

Confidence Rating

yaml
- name: "confidence"
  description: "How confident are you in your annotation?"
  annotation_type: "slider"
  min: 0
  max: 100
  step: 5
  default: 50
  min_label: "Not confident at all"
  max_label: "Completely confident"
  show_value: true

Intensity Scale

yaml
- name: "intensity"
  description: "Rate the emotional intensity of this text"
  annotation_type: "slider"
  min: 1
  max: 10
  step: 1
  default: 5
  min_label: "Very mild"
  max_label: "Very intense"

Percentage Input

yaml
- name: "agreement"
  description: "What percentage of people would agree with this statement?"
  annotation_type: "slider"
  min: 0
  max: 100
  step: 1
  default: 50
  show_value: true

Output Format

The slider annotation outputs a single numeric value:

json
{
  "id": "item_1",
  "annotations": {
    "confidence": 75
  }
}

When to Use Slider vs Number Input

  • Use Slider when you want annotators to make quick, intuitive selections on a continuous scale
  • Use Number Input when you need precise values or when the range is very large

Best Practices

  1. Set sensible defaults - Place the default at a meaningful position (often the midpoint)
  2. Use endpoint labels - Help annotators understand what the scale represents
  3. Choose appropriate step sizes - Smaller steps for fine-grained distinctions, larger for coarse ratings
  4. Keep ranges intuitive - 0-100 or 1-10 are familiar to most annotators