diff --git a/customize/custom-scripts.mdx b/customize/custom-scripts.mdx
index 2bede3b03..d866bcedd 100644
--- a/customize/custom-scripts.mdx
+++ b/customize/custom-scripts.mdx
@@ -28,7 +28,29 @@ Tailwind CSS arbitrary values are not supported. For custom values, use the `sty
 
 ## Add custom CSS
 
-Add CSS files to your repository to apply their defined class names and make them available in all of your MDX files.
+Mintlify automatically includes any `.css` file inside your content directory on every page of your documentation site, the same way it includes custom `.js` files. You do not need to import or reference the file from `docs.json` or your MDX files.
+
+To add custom styles, create a `.css` file (for example, `style.css`) at any level of your content directory. Any class names, ID selectors, or element selectors you define become available across all of your MDX files.
+
+For example, define a class in `style.css`:
+
+```css
+.my-callout {
+  border-radius: 1rem;
+  background: #f0f9ff;
+  padding: 1rem;
+}
+```
+
+Then use it in any MDX file with the `className` prop:
+
+```mdx
+<div className="my-callout">
+  Content here.
+</div>
+```
+
+You can combine custom class names with [Tailwind CSS](#style-with-tailwind-css) classes on the same element.
 
 The references and styling of common elements are subject to change. Use custom styling with caution since breaking changes may occur in future updates.
 
diff --git a/es/customize/custom-scripts.mdx b/es/customize/custom-scripts.mdx
index 4fe3d8b88..ef3375e72 100644
--- a/es/customize/custom-scripts.mdx
+++ b/es/customize/custom-scripts.mdx
@@ -32,7 +32,29 @@ Los valores arbitrarios de Tailwind CSS no están admitidos. Para valores person
   ## Añadir CSS personalizado
 </div>
 
-Añade archivos CSS a tu repositorio y los nombres de clase que definas en ellos se aplicarán y estarán disponibles en todos tus archivos MDX.
+Mintlify incluye automáticamente cualquier archivo `.css` dentro de tu directorio de contenido en todas las páginas de tu sitio de documentación, del mismo modo que incluye los archivos `.js` personalizados. No necesitas importar ni referenciar el archivo desde `docs.json` ni desde tus archivos MDX.
+
+Para añadir estilos personalizados, crea un archivo `.css` (por ejemplo, `style.css`) en cualquier nivel de tu directorio de contenido. Cualquier nombre de clase, selector de ID o selector de elemento que definas quedará disponible en todos tus archivos MDX.
+
+Por ejemplo, define una clase en `style.css`:
+
+```css
+.my-callout {
+  border-radius: 1rem;
+  background: #f0f9ff;
+  padding: 1rem;
+}
+```
+
+Luego úsala en cualquier archivo MDX con la prop `className`:
+
+```mdx
+<div className="my-callout">
+  Contenido aquí.
+</div>
+```
+
+Puedes combinar nombres de clase personalizados con clases de [Tailwind CSS](/es/customize/custom-scripts#style-with-tailwind-css) en el mismo elemento.
 
 Las referencias y el estilo de los elementos comunes están sujetos a cambios. Usa estilos personalizados con precaución, ya que pueden producirse cambios incompatibles en futuras actualizaciones.
 
diff --git a/fr/customize/custom-scripts.mdx b/fr/customize/custom-scripts.mdx
index f6951470e..2a35b7e66 100644
--- a/fr/customize/custom-scripts.mdx
+++ b/fr/customize/custom-scripts.mdx
@@ -32,7 +32,29 @@ Les valeurs arbitraires de Tailwind CSS ne sont pas prises en charge. Pour des v
   ## Ajouter du CSS personnalisé
 </div>
 
-Ajoutez des fichiers CSS à votre référentiel pour appliquer les noms de classes qu'ils définissent et les rendre disponibles dans tous vos fichiers MDX.
+Mintlify inclut automatiquement tout fichier `.css` présent dans votre répertoire de contenu sur chaque page de votre site de documentation, de la même manière qu'il inclut les fichiers `.js` personnalisés. Vous n'avez pas besoin d'importer ni de référencer le fichier depuis `docs.json` ou depuis vos fichiers MDX.
+
+Pour ajouter des styles personnalisés, créez un fichier `.css` (par exemple, `style.css`) à n'importe quel niveau de votre répertoire de contenu. Tous les noms de classes, sélecteurs d'ID ou sélecteurs d'éléments que vous y définissez deviennent disponibles dans tous vos fichiers MDX.
+
+Par exemple, définissez une classe dans `style.css` :
+
+```css
+.my-callout {
+  border-radius: 1rem;
+  background: #f0f9ff;
+  padding: 1rem;
+}
+```
+
+Puis utilisez-la dans n'importe quel fichier MDX avec la prop `className` :
+
+```mdx
+<div className="my-callout">
+  Contenu ici.
+</div>
+```
+
+Vous pouvez combiner des noms de classes personnalisés avec les classes [Tailwind CSS](/fr/customize/custom-scripts#style-with-tailwind-css) sur le même élément.
 
 Les références et la mise en forme des éléments courants sont susceptibles de changer. Utilisez les styles personnalisés avec prudence, car des changements incompatibles peuvent survenir lors de futures mises à jour.
 
diff --git a/zh/customize/custom-scripts.mdx b/zh/customize/custom-scripts.mdx
index 2e1658879..c2b3012d6 100644
--- a/zh/customize/custom-scripts.mdx
+++ b/zh/customize/custom-scripts.mdx
@@ -32,7 +32,29 @@ keywords: ["CSS", "JavaScript", "Tailwind CSS", "样式定制"]
   ## 添加自定义 CSS
 </div>
 
-将 CSS 文件添加到你的存储库中，这些文件中定义的类名会在你所有的 MDX 文件中生效并可用。
+Mintlify 会自动在你的文档站点的每个页面中包含内容目录下的任何 `.css` 文件，方式与包含自定义 `.js` 文件相同。你无需在 `docs.json` 或 MDX 文件中导入或引用该文件。
+
+要添加自定义样式，请在内容目录的任意层级创建一个 `.css` 文件（例如 `style.css`）。你在其中定义的任何类名、ID 选择器或元素选择器都可以在所有 MDX 文件中使用。
+
+例如，在 `style.css` 中定义一个类：
+
+```css
+.my-callout {
+  border-radius: 1rem;
+  background: #f0f9ff;
+  padding: 1rem;
+}
+```
+
+然后在任意 MDX 文件中通过 `className` 属性使用它：
+
+```mdx
+<div className="my-callout">
+  内容在这里。
+</div>
+```
+
+你可以在同一个元素上将自定义类名与 [Tailwind CSS](/zh/customize/custom-scripts#style-with-tailwind-css) 类组合使用。
 
 引用和常用元素的样式可能会发生变化。请谨慎使用自定义样式，因为未来更新中可能出现不兼容的变更。