---
title: "Generic editing views"
version: 6.1
locale: el
source: https://docs.djangoproject.com/el/6.1/ref/class-based-views/generic-editing/
canonical: https://djangodocs.dev/el/6.1/ref/class-based-views/generic-editing/
---
# Generic editing views

The following views are described on this page and provide a foundation for
editing content:

- [`django.views.generic.edit.FormView`](#django.views.generic.edit.FormView)
- [`django.views.generic.edit.CreateView`](#django.views.generic.edit.CreateView)
- [`django.views.generic.edit.UpdateView`](#django.views.generic.edit.UpdateView)
- [`django.views.generic.edit.DeleteView`](#django.views.generic.edit.DeleteView)

> **See also**
>
> The [messages framework](/el/6.1/ref/contrib/messages/) contains
> [`SuccessMessageMixin`](/el/6.1/ref/contrib/messages/#django.contrib.messages.views.SuccessMessageMixin), which
> facilitates presenting messages about successful form submissions.

> **Note**
>
> Some of the examples on this page assume that an `Author` model has been
> defined as follows in `myapp/models.py`:
>
> ```
> from django.db import models
> from django.urls import reverse
>
>
> class Author(models.Model):
>     name = models.CharField(max_length=200)
>
>     def get_absolute_url(self):
>         return reverse("author-detail", kwargs={"pk": self.pk})
> ```

## `FormView`

#### `class django.views.generic.edit.FormView`

A view that displays a form. On error, redisplays the form with validation
errors; on success, redirects to a new URL.

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.base.TemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.edit.BaseFormView`](#django.views.generic.edit.BaseFormView)
- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)
- [`django.views.generic.base.View`](/el/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Example myapp/forms.py**:

```
from django import forms

class ContactForm(forms.Form):
    name = forms.CharField()
    message = forms.CharField(widget=forms.Textarea)

    def send_email(self):
        # send email using the self.cleaned_data dictionary
        pass
```

**Example myapp/views.py**:

```
from myapp.forms import ContactForm
from django.views.generic.edit import FormView

class ContactFormView(FormView):
    template_name = "contact.html"
    form_class = ContactForm
    success_url = "/thanks/"

    def form_valid(self, form):
        # This method is called when valid form data has been POSTed.
        # It should return an HttpResponse.
        form.send_email()
        return super().form_valid(form)
```

**Example myapp/contact.html**:

```html+django
<form method="post">{% csrf_token %}
    {{ form.as_p }}
    <input type="submit" value="Send message">
</form>
```

#### `class django.views.generic.edit.BaseFormView`

A base view for displaying a form. It is not intended to be used directly,
but rather as a parent class of the
[`django.views.generic.edit.FormView`](#django.views.generic.edit.FormView) or other views displaying a
form.

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)

## `CreateView`

#### `class django.views.generic.edit.CreateView`

A view that displays a form for creating an object, redisplaying the form
with validation errors (if there are any) and saving the object.

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.detail.SingleObjectTemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.edit.BaseCreateView`](#django.views.generic.edit.BaseCreateView)
- [`django.views.generic.edit.ModelFormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ModelFormMixin)
- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.detail.SingleObjectMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)
- [`django.views.generic.base.View`](/el/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Attributes**

#### `template_name_suffix`

The `CreateView` page displayed to a `GET` request uses a
`template_name_suffix` of `'_form'`. For
example, changing this attribute to `'_create_form'` for a view
creating objects for the example `Author` model would cause the
default `template_name` to be `'myapp/author_create_form.html'`.

#### `object`

When using `CreateView` you have access to `self.object`, which is
the object being created. If the object hasn’t been created yet, the
value will be `None`.

**Example myapp/views.py**:

```
from django.views.generic.edit import CreateView
from myapp.models import Author

class AuthorCreateView(CreateView):
    model = Author
    fields = ["name"]
```

**Example myapp/author\_form.html**:

```html+django
<form method="post">{% csrf_token %}
    {{ form.as_p }}
    <input type="submit" value="Save">
</form>
```

#### `class django.views.generic.edit.BaseCreateView`

A base view for creating a new object instance. It is not intended to be
used directly, but rather as a parent class of the
[`django.views.generic.edit.CreateView`](#django.views.generic.edit.CreateView).

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.edit.ModelFormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ModelFormMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)

**Methods**

#### `get(request, *args, **kwargs)`

Sets the current object instance (`self.object`) to `None`.

#### `post(request, *args, **kwargs)`

Sets the current object instance (`self.object`) to `None`.

## `UpdateView`

#### `class django.views.generic.edit.UpdateView`

A view that displays a form for editing an existing object, redisplaying
the form with validation errors (if there are any) and saving changes to
the object. This uses a form automatically generated from the object’s
model class (unless a form class is manually specified).

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.detail.SingleObjectTemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.edit.BaseUpdateView`](#django.views.generic.edit.BaseUpdateView)
- [`django.views.generic.edit.ModelFormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ModelFormMixin)
- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.detail.SingleObjectMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)
- [`django.views.generic.base.View`](/el/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Attributes**

#### `template_name_suffix`

The `UpdateView` page displayed to a `GET` request uses a
`template_name_suffix` of `'_form'`. For
example, changing this attribute to `'_update_form'` for a view
updating objects for the example `Author` model would cause the
default `template_name` to be `'myapp/author_update_form.html'`.

#### `object`

When using `UpdateView` you have access to `self.object`, which is
the object being updated.

**Example myapp/views.py**:

```
from django.views.generic.edit import UpdateView
from myapp.models import Author

class AuthorUpdateView(UpdateView):
    model = Author
    fields = ["name"]
    template_name_suffix = "_update_form"
```

**Example myapp/author\_update\_form.html**:

```html+django
<form method="post">{% csrf_token %}
    {{ form.as_p }}
    <input type="submit" value="Update">
</form>
```

#### `class django.views.generic.edit.BaseUpdateView`

A base view for updating an existing object instance. It is not intended to
be used directly, but rather as a parent class of the
[`django.views.generic.edit.UpdateView`](#django.views.generic.edit.UpdateView).

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.edit.ModelFormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ModelFormMixin)
- [`django.views.generic.edit.ProcessFormView`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.ProcessFormView)

**Methods**

#### `get(request, *args, **kwargs)`

Sets the current object instance (`self.object`).

#### `post(request, *args, **kwargs)`

Sets the current object instance (`self.object`).

## `DeleteView`

#### `class django.views.generic.edit.DeleteView`

A view that displays a confirmation page and deletes an existing object.
The given object will only be deleted if the request method is `POST`. If
this view is fetched via `GET`, it will display a confirmation page that
should contain a form that POSTs to the same URL.

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.detail.SingleObjectTemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectTemplateResponseMixin)
- [`django.views.generic.base.TemplateResponseMixin`](/el/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.TemplateResponseMixin)
- [`django.views.generic.edit.BaseDeleteView`](#django.views.generic.edit.BaseDeleteView)
- [`django.views.generic.edit.DeletionMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin)
- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.base.ContextMixin`](/el/6.1/ref/class-based-views/mixins-simple/#django.views.generic.base.ContextMixin)
- [`django.views.generic.detail.BaseDetailView`](/el/6.1/ref/class-based-views/generic-display/#django.views.generic.detail.BaseDetailView)
- [`django.views.generic.detail.SingleObjectMixin`](/el/6.1/ref/class-based-views/mixins-single-object/#django.views.generic.detail.SingleObjectMixin)
- [`django.views.generic.base.View`](/el/6.1/ref/class-based-views/base/#django.views.generic.base.View)

**Attributes**

#### `form_class`

Inherited from [`BaseDeleteView`](#django.views.generic.edit.BaseDeleteView). The
form class that will be used to confirm the request. By default
[`django.forms.Form`](/el/6.1/ref/forms/api/#django.forms.Form), resulting in an empty form that is always
valid.

By providing your own `Form` subclass, you can add additional
requirements, such as a confirmation checkbox, for example.

#### `template_name_suffix`

The `DeleteView` page displayed to a `GET` request uses a
`template_name_suffix` of `'_confirm_delete'`. For
example, changing this attribute to `'_check_delete'` for a view
deleting objects for the example `Author` model would cause the
default `template_name` to be `'myapp/author_check_delete.html'`.

**Example myapp/views.py**:

```
from django.urls import reverse_lazy
from django.views.generic.edit import DeleteView
from myapp.models import Author

class AuthorDeleteView(DeleteView):
    model = Author
    success_url = reverse_lazy("author-list")
```

**Example myapp/author\_confirm\_delete.html**:

```html+django
<form method="post">{% csrf_token %}
    <p>Are you sure you want to delete "{{ object }}"?</p>
    {{ form }}
    <input type="submit" value="Confirm">
</form>
```

#### `class django.views.generic.edit.BaseDeleteView`

A base view for deleting an object instance. It is not intended to be used
directly, but rather as a parent class of the
[`django.views.generic.edit.DeleteView`](#django.views.generic.edit.DeleteView).

**Ancestors (MRO)**

This view inherits methods and attributes from the following views:

- [`django.views.generic.edit.DeletionMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin)
- [`django.views.generic.edit.FormMixin`](/el/6.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin)
- [`django.views.generic.detail.BaseDetailView`](/el/6.1/ref/class-based-views/generic-display/#django.views.generic.detail.BaseDetailView)