rsnext/errors/built-in-css-disabled.mdx
Lee Robinson 6527d29c8a
docs: Improve some of the error messages pages. (#52271)
Now that we've improved `/messages`
(https://github.com/vercel/next.js/pull/52038), we'd like to start
updating some of the content as well 🙏
2023-07-05 19:22:34 -07:00

21 lines
1.3 KiB
Text

---
title: Resolving "Built-in CSS Support Disabled" Error in Next.js
description: This document provides a comprehensive explanation of the "Built-in CSS Support Disabled" error in Next.js and suggests ways to fix it.
---
## Why This Error Occurred
The "Built-in CSS Support Disabled" error typically occurs when a custom CSS configuration is added in the `next.config.js` file. This action deactivates the built-in CSS/SCSS support to avoid conflicts in configuration.
If you have added a legacy plugin like `@zeit/next-css` in your `next.config.js` file, you may encounter this error message.
## Possible Ways to Fix It
If you want to use the built-in CSS/SCSS support, you need to remove any custom CSS configuration or plugins such as `@zeit/next-css` or `@zeit/next-sass` in your `next.config.js` file. We recommend this approach.
On the other hand, if you choose not to use the built-in support, you can safely ignore this warning.
## Useful Links
- [Built-in CSS Support docs](/docs/pages/building-your-application/styling) - Learn more about the built-in CSS/SCSS support in Next.js and how to use it effectively.
- [Custom webpack config docs](/docs/pages/api-reference/next-config-js/webpack) - Get more information on customizing your webpack configuration in Next.js.