From 618bc4e65316681314522f63522c419fb6f7285e Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Fri, 24 Apr 2015 08:25:33 -0400 Subject: [PATCH] Documented INSTALLED_APPS requirement for HStoreField. --- docs/ref/contrib/postgres/fields.txt | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/ref/contrib/postgres/fields.txt b/docs/ref/contrib/postgres/fields.txt index 1a1d228da9..e5b7a1148a 100644 --- a/docs/ref/contrib/postgres/fields.txt +++ b/docs/ref/contrib/postgres/fields.txt @@ -251,11 +251,15 @@ HStoreField A field for storing mappings of strings to strings. The Python data type used is a ``dict``. - To use this field, you'll need to setup the hstore extension in PostgreSQL - by adding a migration with the - :class:`~django.contrib.postgres.operations.HStoreExtension` operation. - You'll see an error like ``'type "hstore" does not exist'`` if you skip - this step. + To use this field, you'll need to: + + 1. Add ``'django.contrib.postgres'`` in your :setting:`INSTALLED_APPS`. + 2. Setup the hstore extension in PostgreSQL before the first ``CreateModel`` + or ``AddField`` operation by adding a migration with the + :class:`~django.contrib.postgres.operations.HStoreExtension` operation. + + You'll see an error like ``can't adapt type 'dict'`` if you skip the first + step, or ``type "hstore" does not exist`` if you skip the second. .. note::