From 0cae400f8abb178795d8fdfe0e415c42376389a6 Mon Sep 17 00:00:00 2001
From: Sally McGrath <sally@codeyourfuture.io>
Date: Wed, 9 Apr 2025 10:33:24 +0100
Subject: [PATCH] document label items

cause I'm using it
---
 .../common-theme/shortcodes/label-items.md    | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 common-docs/content/common-theme/shortcodes/label-items.md

diff --git a/common-docs/content/common-theme/shortcodes/label-items.md b/common-docs/content/common-theme/shortcodes/label-items.md
new file mode 100644
index 000000000..427374f26
--- /dev/null
+++ b/common-docs/content/common-theme/shortcodes/label-items.md
@@ -0,0 +1,23 @@
++++
+title="Label Items"
+description="Create a label items task with feedback"
+emoji="🗃️"
+menu=["shortcodes"]
++++
+
+This is a simple "check understanding" block that allows you to create a "label items" tasks with feedback, similar to the multiple choice block, but with a drag and drop interaction. Sorting and categorising tasks are a pedagogically sound strategy to boost retention and understanding.
+
+### Invoke
+
+```go
+{{</*label-items heading="Drag the labels on to the items"
+>}}
+[LABEL=Label-1]Item here [LABEL=Label-2]Item here anything you like can be
+multiple lines [LABEL=Label-1] Another item here
+{{< /label-items */>}}
+```
+
+{{<label-items heading="Drag the labels on to the items">}}
+[LABEL=Label-1]Item here [LABEL=Label-2]Item here anything you like can be
+multiple lines [LABEL=Label-1] Another item here
+{{< /label-items >}}