Doc'd the need to provide initial for formset submissions.

1 files changed, 5 insertions, 0 deletions

diff --git a/docs/topics/forms/formsets.txt b/docs/topics/forms/formsets.txt
index 3cae784dcc..f1419b6a92 100644
--- a/docs/topics/forms/formsets.txt
+++ b/docs/topics/forms/formsets.txt
@@ -80,6 +80,11 @@ There are now a total of three forms showing above. One for the initial data
 that was passed in and two extra forms. Also note that we are passing in a
 list of dictionaries as the initial data.
 
+If you use an ``initial`` for displaying a formset, you should pass the same
+``initial`` when processing that formset's submission so that the formset can
+detect which forms were changed by the user. For example, you might have
+something like: ``ArticleFormSet(request.POST, initial=[...])``.
+
 .. seealso::
 
     :ref:`Creating formsets from models with model formsets <model-formsets>`.