{"id":9690,"library":"djangocms-admin-style","title":"Django CMS Admin Style","description":"djangocms-admin-style provides a clean, modern, and user-friendly CSS styling layer for the Django admin interface, specifically tailored for django CMS projects. It aims to improve the visual consistency and user experience of the Django administration backend. The current version is 3.3.1, and it maintains a regular release cadence, often aligning with Django and django CMS major versions to ensure compatibility and address styling regressions.","status":"active","version":"3.3.1","language":"en","source_language":"en","source_url":"https://github.com/django-cms/djangocms-admin-style","tags":["django","django-cms","admin","theme","style","css"],"install":[{"cmd":"pip install djangocms-admin-style","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Runtime dependency for the Django administration interface styling.","package":"Django","optional":false}],"imports":[{"note":"This library is primarily configured by adding its app name string to Django's INSTALLED_APPS setting. It must be placed before 'django.contrib.admin' to correctly override admin styles.","symbol":"'djangocms_admin_style'","correct":"INSTALLED_APPS = [\n    'djangocms_admin_style',\n    'django.contrib.admin',\n    # ... other apps\n]"}],"quickstart":{"code":"# settings.py\nINSTALLED_APPS = [\n    'djangocms_admin_style',  # Must be before 'django.contrib.admin'\n    'django.contrib.admin',\n    'django.contrib.auth',\n    'django.contrib.contenttypes',\n    'django.contrib.sessions',\n    'django.contrib.messages',\n    'django.contrib.staticfiles',\n    # ... your other apps\n]\n\n# No changes required in urls.py for basic styling.","lang":"python","description":"Add 'djangocms_admin_style' to your project's `INSTALLED_APPS` in `settings.py`. It is crucial that it appears *before* `django.contrib.admin` for its styles to take precedence. No additional URL configurations are typically needed as it overrides existing admin static files."},"warnings":[{"fix":"Upgrade `djangocms-admin-style` to version 3.3.0 or later to ensure compatibility with Django 4.2+ and Django 5.0: `pip install --upgrade djangocms-admin-style`.","message":"Admin styling may break or render incorrectly with Django 4.2, Django 5.0, and newer versions due to upstream changes in Django's admin CSS (e.g., flex display for submit-row, dark mode features).","severity":"breaking","affected_versions":"Prior to 3.2.5 for general Django 4.2 compatibility, prior to 3.3.0 for specific Django 5.0 fixes."},{"fix":"Ensure `'djangocms_admin_style'` is listed *before* `'django.contrib.admin'` in your Django project's `settings.py`.","message":"Incorrect placement of `djangocms_admin_style` in `INSTALLED_APPS` will result in the default Django admin look without the custom styling being applied.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Only include one primary admin styling app in `INSTALLED_APPS`. If conflicts occur, disable other admin themes or troubleshoot specific CSS overrides.","message":"Using `djangocms-admin-style` alongside other third-party Django admin themes (e.g., `grappelli`, `jazzmin`) can lead to CSS conflicts and unexpected rendering issues.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"In your `settings.py`, ensure `'djangocms_admin_style'` is included in `INSTALLED_APPS` and positioned *before* `'django.contrib.admin'`.","cause":"`djangocms_admin_style` is either missing from `INSTALLED_APPS` or is placed after `django.contrib.admin`.","error":"My Django admin interface looks plain, without the custom styles from django CMS, or the styles are inconsistent."},{"fix":"Upgrade `djangocms-admin-style` to version 3.3.0 or newer: `pip install --upgrade djangocms-admin-style`.","cause":"The installed version of `djangocms-admin-style` is not fully compatible with the CSS changes introduced in Django 4.2+ or 5.0, such as changes to flex display properties.","error":"Buttons or elements like the submit-row in the Django admin are misaligned or have incorrect spacing after upgrading Django to 4.2 or 5.0."},{"fix":"Upgrade `djangocms-admin-style` to version 3.3.1 or newer to fix the CSS rendering: `pip install --upgrade djangocms-admin-style`.","cause":"A specific CSS bug in `djangocms-admin-style` versions prior to 3.3.1 caused rendering issues for the picture upload widget in `djangocms-blog`.","error":"The picture upload widget in `djangocms-blog` is hidden or broken within the Django admin interface."}]}