# Sort the Paragraphs (H5P.SortParagraphs)

Paragraphs shown shuffled, which the learner puts in order: steps of a process, events of a story.

- Write `paragraphs` in the right order, at least three; the content shuffles them.
- Scoring: `behaviour.scoringMode` `"positions"` counts paragraphs in the right place, `"transitions"` each one that follows the right one.

## Example

```json
{
  "type": "H5P.SortParagraphs",
  "params": {
    "taskDescription": "Put the journey of a raindrop in order.",
    "paragraphs": [
      "Rain falls on the mountains.",
      "Streams gather the water.",
      "A river carries it through the valley.",
      "The river reaches the sea."
    ]
  }
}
```

<!-- Generated by `h5p-author schema --markdown` from the pinned pack. Do not edit by hand. -->

## Fields of H5P.SortParagraphs 0.11

The example is `type` and `params` alone, and `params` holds the fields below. A source also names its own `title`, `language`, `license` and `authors`, all four required: the build refuses a source that leaves out any of them. The author's name and the licence are the user's: ask for what they have not given. For a name they skip, write the one you know them by, or "Unknown"; for a licence they skip, `U`.

- `media` group — Media
  - `type` sub-content: H5P.Image | H5P.Video | H5P.Audio — Type: Optional media to display above the question.
  - `disableImageZooming` boolean = false; only when type is "H5P.Image 1.1" — Disable image zooming
- `taskDescription` html: strong em u a ul ol h2 h3 hr pre code, required — Task description: What your students should know.
- `paragraphs` list 3+ of html: strong em u ul ol h2 h3 hr pre code, required — Paragraphs
- `overallFeedback` list 1+ of — Overall Feedback: Click the "Add range" button to add as many ranges as you need. Example: 0-20% Bad score, 21-91% Average Score, 91-100% Great Score!
  - `from` whole number 0–100 = 0 — Score Range
  - `to` whole number 0–100 = 100
  - `feedback` text — Feedback for defined score range
- `behaviour` group — Behavioural settings
  - `scoringMode` one of "positions" | "transitions" = "positions" — Scoring mode: Decide whether to give points for each correctly placed paragraph or for each paragraph that is placed after the paragraph it is supposed to be placed after ("correct sequence")
  - `applyPenalties` boolean = true; only when scoringMode is "positions" — Apply penalties
  - `duplicatesInterchangeable` boolean = true — Duplicate parapraphs interchangeable
  - `addButtonsForMovement` boolean = true — Add buttons for movement
  - `enableRetry` boolean = true — Enable "Retry" button
  - `enableSolutionsButton` boolean = true — Enable "Show Solution" button

29 interface texts are left out: they come from the libraries' translations. `h5p-author schema H5P.SortParagraphs --all` lists them, for a source to set one.

<!-- End of the generated section. -->