diff --git a/openjdk/variant-slim.md b/openjdk/variant-slim.md
new file mode 100644
index 000000000..3d7cab977
--- /dev/null
+++ b/openjdk/variant-slim.md
@@ -0,0 +1,3 @@
+## `%%IMAGE%%:slim`
+
+This image installs the `-headless` package of OpenJDK and so is missing many of the UI-related Java libraries and some common packages contained in the default tag. It only contains the minimal packages needed to run Java. Unless you are working in an environment where *only* the `%%IMAGE%%` image will be deployed and you have space constraints, we highly recommend using the default image of this repository.