Install & Compatibility
Where this runs
tested against v3.3.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 68MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.4s · import 0.000s · 69MB
67MB installed
● package 67MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
'djangocms_admin_style'
✓ INSTALLED_APPS = [
'djangocms_admin_style',
'django.contrib.admin',
# ... other apps
]
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.
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.
# settings.py
INSTALLED_APPS = [
'djangocms_admin_style', # Must be before 'django.contrib.admin'
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
# ... your other apps
]
# No changes required in urls.py for basic styling.
Debug
Known issues
breakingAdmin 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).fixUpgrade `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`.
affects: Prior to 3.2.5 for general Django 4.2 compatibility, prior to 3.3.0 for specific Django 5.0 fixes.
gotchaIncorrect placement of `djangocms_admin_style` in `INSTALLED_APPS` will result in the default Django admin look without the custom styling being applied.fixEnsure `'djangocms_admin_style'` is listed *before* `'django.contrib.admin'` in your Django project's `settings.py`.
affects: All versions
gotchaUsing `djangocms-admin-style` alongside other third-party Django admin themes (e.g., `grappelli`, `jazzmin`) can lead to CSS conflicts and unexpected rendering issues.fixOnly include one primary admin styling app in `INSTALLED_APPS`. If conflicts occur, disable other admin themes or troubleshoot specific CSS overrides.
affects: All versions
Upgrade
Version history
3.3.1latest on PyPI · released Feb 29, 2024
Audit
Dependencies
DjangorequiredRuntime dependency for the Django administration interface styling.