---
title: "PostgreSQL specific form fields and widgets"
version: 3.0
locale: el
source: https://docs.djangoproject.com/el/3.0/ref/contrib/postgres/forms/
canonical: https://djangodocs.dev/el/3.0/ref/contrib/postgres/forms/
---
# PostgreSQL specific form fields and widgets
All of these fields and widgets are available from the
`django.contrib.postgres.forms` module.
## Fields
### `SimpleArrayField`
#### `class SimpleArrayField(base_field, delimiter=',', max_length=None, min_length=None)`
A field which maps to an array. It is represented by an HTML ``.
#### `base_field`
This is a required argument.
It specifies the underlying form field for the array. This is not used
to render any HTML, but it is used to process the submitted data and
validate it. For example:
```
>>> from django import forms
>>> from django.contrib.postgres.forms import SimpleArrayField
>>> class NumberListForm(forms.Form):
... numbers = SimpleArrayField(forms.IntegerField())
>>> form = NumberListForm({'numbers': '1,2,3'})
>>> form.is_valid()
True
>>> form.cleaned_data
{'numbers': [1, 2, 3]}
>>> form = NumberListForm({'numbers': '1,2,a'})
>>> form.is_valid()
False
```
#### `delimiter`
This is an optional argument which defaults to a comma: `,`. This
value is used to split the submitted data. It allows you to chain
`SimpleArrayField` for multidimensional data:
```
>>> from django import forms
>>> from django.contrib.postgres.forms import SimpleArrayField
>>> class GridForm(forms.Form):
... places = SimpleArrayField(SimpleArrayField(IntegerField()), delimiter='|')
>>> form = GridForm({'places': '1,2|2,1|4,3'})
>>> form.is_valid()
True
>>> form.cleaned_data
{'places': [[1, 2], [2, 1], [4, 3]]}
```
> **Note**
>
> The field does not support escaping of the delimiter, so be careful
> in cases where the delimiter is a valid character in the underlying
> field. The delimiter does not need to be only one character.
#### `max_length`
This is an optional argument which validates that the array does not
exceed the stated length.
#### `min_length`
This is an optional argument which validates that the array reaches at
least the stated length.
> **User friendly forms**
>
> `SimpleArrayField` is not particularly user friendly in most cases,
> however it is a useful way to format data from a client-side widget for
> submission to the server.
### `SplitArrayField`
#### `class SplitArrayField(base_field, size, remove_trailing_nulls=False)`
This field handles arrays by reproducing the underlying field a fixed
number of times.
#### `base_field`
This is a required argument. It specifies the form field to be
repeated.
#### `size`
This is the fixed number of times the underlying field will be used.
#### `remove_trailing_nulls`
By default, this is set to `False`. When `False`, each value from
the repeated fields is stored. When set to `True`, any trailing
values which are blank will be stripped from the result. If the
underlying field has `required=True`, but `remove_trailing_nulls`
is `True`, then null values are only allowed at the end, and will be
stripped.
Some examples:
```
SplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=False)
['1', '2', '3'] # -> [1, 2, 3]
['1', '2', ''] # -> ValidationError - third entry required.
['1', '', '3'] # -> ValidationError - second entry required.
['', '2', ''] # -> ValidationError - first and third entries required.
SplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=False)
['1', '2', '3'] # -> [1, 2, 3]
['1', '2', ''] # -> [1, 2, None]
['1', '', '3'] # -> [1, None, 3]
['', '2', ''] # -> [None, 2, None]
SplitArrayField(IntegerField(required=True), size=3, remove_trailing_nulls=True)
['1', '2', '3'] # -> [1, 2, 3]
['1', '2', ''] # -> [1, 2]
['1', '', '3'] # -> ValidationError - second entry required.
['', '2', ''] # -> ValidationError - first entry required.
SplitArrayField(IntegerField(required=False), size=3, remove_trailing_nulls=True)
['1', '2', '3'] # -> [1, 2, 3]
['1', '2', ''] # -> [1, 2]
['1', '', '3'] # -> [1, None, 3]
['', '2', ''] # -> [None, 2]
```
### `HStoreField`
#### `class HStoreField`
A field which accepts JSON encoded data for an
[`HStoreField`](/el/3.0/ref/contrib/postgres/fields/#django.contrib.postgres.fields.HStoreField). It casts all values
(except nulls) to strings. It is represented by an HTML `