Settings

Basic settings

Key	Description	Type	Default
EXTENDS		`str`	`None`
MANAGE_VIEWS_ENABLED	Show manage view button, values are: `yes,no,debug_only`	`str`	`debug_only`
CRUD_VIEWS_MANAGE_GROUP	Django group name that grants manage view access regardless of MANAGE_VIEWS_ENABLED	`str`	`CRUD_VIEWS_MANAGE`
CRUD_VIEWS_MANAGE_SHOW_USERS	Whether to show a Users column in the Permission Holders section of ManageView	`bool`	`False`
CRUD_VIEWS_MANAGE_VIEW_CLASS	Dotted import path to a custom `ManageView` subclass used as the base for auto-registered manage views. When `None`, uses `ManageView`.	`str \\| None`	`None`
CRUD_VIEWS_GUARDIAN_MANAGE_VIEW_CLASS	Dotted import path to a custom `GuardianManageView` subclass used as the base for auto-registered guardian manage views. When `None`, uses `GuardianManageView`.	`str \\| None`	`None`

Session

Session settings.

Key	Description	Type	Default
SESSION_DATA_KEY	The session key used to store data for `django-crud-views`	`str`	`viewset`

Filter

Settings for filter.

Key	Description	Type	Default
FILTER_PERSISTENCE	Store filter in Django session	`bool`	True
FILTER_ICON	Filter icon (boostrap5 only)	`str`	fa-solid fa-filter
FILTER_RESET_BUTTON_CSS_CLASS	Filter reset button css flass (bootstrap5 only)	`str`	btn btn-secondary

View Context Actions

Default context actions for CRUD views.

Key	Description	Type	Default
LIST_CONTEXT_ACTIONS	Global switch	`List[str]`	`parent, filter, create`
DETAIL_CONTEXT_ACTIONS	Global switch	`List[str]`	`home, update, delete`
CREATE_CONTEXT_ACTIONS	Global switch	`List[str]`	`home`
UPDATE_CONTEXT_ACTIONS	Global switch	`List[str]`	`home`
DELETE_CONTEXT_ACTIONS	Global switch	`List[str]`	`home`
MANAGE_CONTEXT_ACTIONS	Global switch	`List[str]`	`home`
CREATE_SELECT_CONTEXT_ACTIONS	Global switch	`List[str]`	`home`

List Actions

Default list actions for list view.

Key	Description	Type	Default
LIST_ACTIONS	Global switch	`List[str]`	`detail, update, delete`

Content Security Policy (CSP)

django-crud-views is compatible with strict Content Security Policy headers. The package does not use inline scripts, inline event handlers, inline styles, or javascript: URIs.

Projects can enforce a CSP without unsafe-inline for both script-src and style-src directives.

Template tags

The {% cv_config %} template tag renders server-side request data as data-* attributes on a hidden DOM element. Place it in your base template where {% cv_const_js %} was previously used:

{% load crud_views %}

{% cv_config %}
{% cv_css %}
{% cv_js %}

The {% cv_const_js %} tag still works as a backwards-compatible alias but renders the same CSP-safe output as {% cv_config %}.

JavaScript architecture

All interactive behavior (list action form submissions, cancel button navigation, filter toggling) is handled via event delegation in the external viewset.js static file. Dynamic data is passed from Django to JavaScript through data-* attributes:

#cv-config element carries data-request-path and data-query-string
[data-cv-action="submit-form"] elements trigger form submission
[data-cv-cancel-url] elements trigger navigation

No nonces or hashes are required.

django-tables2 compatibility

The list view table template crud_views/templates/crud_views/table/bootstrap5.html requires django-tables2 ≥ 3.0.

django-tables2 3.0 renamed the {% querystring %} template tag to {% querystring_replace %}. The updated template uses the new tag name and is therefore not compatible with django-tables2 < 3.0.

If you need to use django-tables2 < 3.0, switch to the legacy template via the DJANGO_TABLES2_TEMPLATE setting:

DJANGO_TABLES2_TEMPLATE = "crud_views/table/bootstrap5_lt3.html"

django-object-detail

Settings for the django-object-detail package used by the DetailView. These are standard Django settings (not prefixed with CRUD_VIEWS_).

Key	Description	Type	Default
`OBJECT_DETAIL_TEMPLATE_PACK_LAYOUT`	Layout pack for group/property structure	`str`	`"split-card"`
`OBJECT_DETAIL_TEMPLATE_PACK_TYPES`	Type template pack for value rendering	`str`	`"default"`
`OBJECT_DETAIL_ICONS_LIBRARY`	Icon library: `"bootstrap"` or `"fontawesome"`	`str`	`"bootstrap"`
`OBJECT_DETAIL_ICONS_CLASS`	Base CSS class (`"bi"` or `"fa"`)	`str`	per library
`OBJECT_DETAIL_ICONS_TYPE`	Icon type (`None` for Bootstrap, `"regular"` for FA)	`str`	per library
`OBJECT_DETAIL_ICONS_PREFIX`	Icon name prefix (`"bi"` or `"fa"`)	`str`	per library
`OBJECT_DETAIL_NAMED_ICONS`	Dict mapping named icons to icon names	`dict`	per library

Example configuration for Font Awesome with Bootstrap 5:

OBJECT_DETAIL_TEMPLATE_PACK_LAYOUT = "split-card"
OBJECT_DETAIL_TEMPLATE_PACK_TYPES = "default"
OBJECT_DETAIL_ICONS_LIBRARY = "fontawesome"
OBJECT_DETAIL_ICONS_TYPE = "solid"