arangodb · Simran-B · Sep 12, 2025 · Sep 11, 2025 · Sep 11, 2025 · Sep 11, 2025
diff --git a/README.md b/README.md
@@ -353,13 +353,13 @@ paragraphs will not be part of the blockquote.
 Admonitions inside of other shortcodes need to use the special syntax, too:
 
 ```markdown
-{{< expand title="Outer shortcode" >}}
+{{< details summary="Outer shortcode" >}}
 
 {{</* tip */>}}
 Inner shortcode
 {{</* /tip */>}}
 
-{{< /expand >}}
+{{< /details >}}
 ```
 
 #### Tags
@@ -472,9 +472,9 @@ Content or reminder that should not be rendered.
 The following shortcodes also exist but are rarely used:
 
 - ```markdown
-  {{< expand title="A short description" >}}
+  {{< details summary="A short description" >}}
   Content that is collapsed by default but can be expanded.
-  {{< /expand >}}
+  {{< /details >}}
   ```
 
 - `{{< youtube id="dQw4w9WgXcQ" >}}` can be used to embed a single YouTube video,

diff --git a/site/content/3.10/arangograph/security-and-access-control/_index.md b/site/content/3.10/arangograph/security-and-access-control/_index.md
@@ -122,7 +122,7 @@ export OASIS_TOKEN='<TOKEN>'
 ./oasisctl list roles --organization-id <ID> --format json | jq -r '.[] | select(.predefined == true) | "**\(.description)** (`\(.id)`):\n\(.permissions | split(", ") | map("- `\(.)`\n") | join(""))"'
 {{% /comment %}}
 
-{{< expand title="List of predefined roles and their permissions" >}}
+{{< details summary="List of predefined roles and their permissions" >}}
 
 {{</* tip */>}}
 The roles below are described following this pattern:
@@ -475,7 +475,7 @@ The roles below are described following this pattern:
 - `iam.user.get-personal-data`
 - `iam.user.update`
 
-{{< /expand >}}
+{{< /details >}}
 
 ### How to create a custom role
 

diff --git a/site/content/3.10/develop/http-api/administration.md b/site/content/3.10/develop/http-api/administration.md
@@ -966,7 +966,7 @@ Example not generated because it would require a valid license to demonstrate th
 curl --header 'accept: application/json' --dump - --data '"eyJncmFudCI6...(Base64-encoded license string)..."' -X PUT http://localhost:8529/_admin/license
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 201 Created
 content-type: application/json
@@ -988,7 +988,7 @@ x-content-type-options: nosniff
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
 
 ## Shutdown
 

diff --git a/site/content/3.11/arangograph/security-and-access-control/_index.md b/site/content/3.11/arangograph/security-and-access-control/_index.md
@@ -122,7 +122,7 @@ export OASIS_TOKEN='<TOKEN>'
 ./oasisctl list roles --organization-id <ID> --format json | jq -r '.[] | select(.predefined == true) | "**\(.description)** (`\(.id)`):\n\(.permissions | split(", ") | map("- `\(.)`\n") | join(""))"'
 {{% /comment %}}
 
-{{< expand title="List of predefined roles and their permissions" >}}
+{{< details summary="List of predefined roles and their permissions" >}}
 
 {{</* tip */>}}
 The roles below are described following this pattern:
@@ -475,7 +475,7 @@ The roles below are described following this pattern:
 - `iam.user.get-personal-data`
 - `iam.user.update`
 
-{{< /expand >}}
+{{< /details >}}
 
 ### How to create a custom role
 

diff --git a/site/content/3.11/develop/http-api/administration.md b/site/content/3.11/develop/http-api/administration.md
@@ -1075,7 +1075,7 @@ Example not generated because it would require a valid license to demonstrate th
 curl --header 'accept: application/json' --dump - --data '"eyJncmFudCI6...(Base64-encoded license string)..."' -X PUT http://localhost:8529/_admin/license
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 201 Created
 content-type: application/json
@@ -1097,7 +1097,7 @@ x-content-type-options: nosniff
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
 
 ## Shutdown
 

diff --git a/site/content/3.12/arangograph/security-and-access-control/_index.md b/site/content/3.12/arangograph/security-and-access-control/_index.md
@@ -122,7 +122,7 @@ export OASIS_TOKEN='<TOKEN>'
 ./oasisctl list roles --organization-id <ID> --format json | jq -r '.[] | select(.predefined == true) | "**\(.description)** (`\(.id)`):\n\(.permissions | split(", ") | map("- `\(.)`\n") | join(""))"'
 {{% /comment %}}
 
-{{< expand title="List of predefined roles and their permissions" >}}
+{{< details summary="List of predefined roles and their permissions" >}}
 
 {{</* tip */>}}
 The roles below are described following this pattern:
@@ -475,7 +475,7 @@ The roles below are described following this pattern:
 - `iam.user.get-personal-data`
 - `iam.user.update`
 
-{{< /expand >}}
+{{< /details >}}
 
 ### How to create a custom role
 

diff --git a/site/content/3.12/develop/http-api/administration.md b/site/content/3.12/develop/http-api/administration.md
@@ -1231,7 +1231,7 @@ Example not generated because it would require a valid license to demonstrate th
 curl --header 'accept: application/json' --dump - --data '"eyJncmFudCI6...(Base64-encoded license string)..."' -X PUT http://localhost:8529/_admin/license
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 201 Created
 content-type: application/json
@@ -1253,7 +1253,7 @@ x-content-type-options: nosniff
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
 
 ## Shutdown
 

diff --git a/site/content/3.12/develop/http-api/batch-requests.md b/site/content/3.12/develop/http-api/batch-requests.md
@@ -359,7 +359,7 @@ DELETE /_api/collection/products HTTP/1.1
 EOF
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 200 OK
 content-type: multipart/form-data
@@ -512,7 +512,7 @@ Content-Length: 39
 
 --SomeBoundaryValue--
 ```
-{{< /expand >}}
+{{< /details >}}
 
 Sending a batch request, setting the boundary implicitly. The server tries
 to find the boundary at the beginning of the request body in this case.
@@ -536,7 +536,7 @@ DELETE _api/collection/nonexistent2 HTTP/1.1
 EOF
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 200 OK
 content-type: unset
@@ -586,4 +586,4 @@ Content-Length: 101
 
 --SomeBoundaryValue--
 ```
-{{< /expand >}}
+{{< /details >}}
diff --git a/site/content/3.12/develop/http-api/monitoring/logs.md b/site/content/3.12/develop/http-api/monitoring/logs.md
@@ -1038,7 +1038,7 @@ Example not generated because it changes on every run and returns up to 25MB of
 curl --header 'accept: application/json' --dump - http://localhost:8529/_admin/server/api-calls
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 200 OK
 X-Arango-Queue-Time-Seconds: 0.000000
@@ -1074,4 +1074,4 @@ Content-Length: 257
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
diff --git a/site/content/3.13/arangograph/security-and-access-control/_index.md b/site/content/3.13/arangograph/security-and-access-control/_index.md
@@ -122,7 +122,7 @@ export OASIS_TOKEN='<TOKEN>'
 ./oasisctl list roles --organization-id <ID> --format json | jq -r '.[] | select(.predefined == true) | "**\(.description)** (`\(.id)`):\n\(.permissions | split(", ") | map("- `\(.)`\n") | join(""))"'
 {{% /comment %}}
 
-{{< expand title="List of predefined roles and their permissions" >}}
+{{< details summary="List of predefined roles and their permissions" >}}
 
 {{</* tip */>}}
 The roles below are described following this pattern:
@@ -475,7 +475,7 @@ The roles below are described following this pattern:
 - `iam.user.get-personal-data`
 - `iam.user.update`
 
-{{< /expand >}}
+{{< /details >}}
 
 ### How to create a custom role
 

diff --git a/site/content/3.13/develop/http-api/administration.md b/site/content/3.13/develop/http-api/administration.md
@@ -1231,7 +1231,7 @@ Example not generated because it would require a valid license to demonstrate th
 curl --header 'accept: application/json' --dump - --data '"eyJncmFudCI6...(Base64-encoded license string)..."' -X PUT http://localhost:8529/_admin/license
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 201 Created
 content-type: application/json
@@ -1253,7 +1253,7 @@ x-content-type-options: nosniff
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
 
 ## Shutdown
 

diff --git a/site/content/3.13/develop/http-api/monitoring/logs.md b/site/content/3.13/develop/http-api/monitoring/logs.md
@@ -1038,7 +1038,7 @@ Example not generated because it changes on every run and returns up to 25MB of
 curl --header 'accept: application/json' --dump - http://localhost:8529/_admin/server/api-calls
 ```
 
-{{< expand title="Show output" >}}
+{{< details summary="Show output" >}}
 ```bash
 HTTP/1.1 200 OK
 X-Arango-Queue-Time-Seconds: 0.000000
@@ -1074,4 +1074,4 @@ Content-Length: 257
   }
 }
 ```
-{{< /expand >}}
+{{< /details >}}
diff --git a/site/themes/arangodb-docs-theme/layouts/partials/shortcodes/examples/render.html b/site/themes/arangodb-docs-theme/layouts/partials/shortcodes/examples/render.html
@@ -21,11 +21,5 @@
 {{- end }}
 
 {{- $output := transform.Highlight $content.output $language }}
-{{- $block := printf "%s" $output }}
-{{- partial "shortcodes/expand.html" (dict
-  "context" $context
-  "content" $block
-  "open"    "open"
-  "title"   "Show output"
-) }}
+<details><summary>Show output</summary>{{ $context.Page.RenderString $output }}</details>
 <br>
diff --git a/site/themes/arangodb-docs-theme/layouts/partials/shortcodes/expand.html b/site/themes/arangodb-docs-theme/layouts/partials/shortcodes/expand.html
diff --git a/site/themes/arangodb-docs-theme/layouts/shortcodes/details.html b/site/themes/arangodb-docs-theme/layouts/shortcodes/details.html
@@ -0,0 +1,3 @@
+{{ $summary := .Get "summary" -}}
+{{ if not $summary }}{{ errorf "Missing summary for %q shortcode at %s" .Name .Position }}{{ end -}}
+<details><summary>{{ $summary | markdownify }}</summary>{{ .Inner | .Page.RenderString (dict "display" "block") }}</details>
diff --git a/site/themes/arangodb-docs-theme/layouts/shortcodes/expand.html b/site/themes/arangodb-docs-theme/layouts/shortcodes/expand.html
diff --git a/site/themes/arangodb-docs-theme/layouts/shortcodes/program-options.md b/site/themes/arangodb-docs-theme/layouts/shortcodes/program-options.md
@@ -113,12 +113,7 @@ Effective on {{ delimit . ", " " and " }} only.
 {{ end }}
 
 {{ with $option.longDescription }}
-  {{- partial "shortcodes/expand.html" (dict
-    "context" $context
-    "content" .
-    "open"    "open"
-    "title"   "Show details"
-  ) }}
+<details><summary>Show details</summary>{{ . | $context.Page.RenderString (dict "display" "block") }}</details>
 {{ end }}
 
 ---