diff --git a/settings.mdx b/settings.mdx
index 778b78a96..a0e19f13b 100644
--- a/settings.mdx
+++ b/settings.mdx
@@ -127,8 +127,26 @@ See [Themes](themes) for more information.
     <ResponseField name="eyebrows" type="&quot;section&quot; | &quot;breadcrumbs&quot;">
       The style of the page eyebrow. Choose `section` to show the section name or `breadcrumbs` to show the full navigation path. Defaults to `section`.
     </ResponseField>
-    <ResponseField name="codeblocks" type="&quot;system&quot; | &quot;dark&quot;">
-      The theme of the code blocks. Choose `system` to match the site theme or `dark` for always dark code blocks. Defaults to `system`.
+    <ResponseField name="codeblocks" type="&quot;system&quot; | &quot;dark&quot; | object">
+      The theme of the code blocks. Choose `system` to match the site theme, `dark` for always dark code blocks, or specify custom themes. Defaults to `system`.
+
+      <Expandable title="Codeblocks">
+        <ResponseField name="theme" type="string">
+          A single theme to use for code blocks in both light and dark modes. Example: `"dracula"`.
+        </ResponseField>
+        <ResponseField name="themes" type="object">
+          Separate themes for light and dark modes.
+
+          <Expandable title="Themes">
+            <ResponseField name="light" type="string" required>
+              Theme to use in light mode.
+            </ResponseField>
+            <ResponseField name="dark" type="string" required>
+              Theme to use in dark mode.
+            </ResponseField>
+          </Expandable>
+        </ResponseField>
+      </Expandable>
     </ResponseField>
   </Expandable>
 </ResponseField>