summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/applications.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/applications.txt b/docs/ref/applications.txt
index 69d04380ce..eecaa9e323 100644
--- a/docs/ref/applications.txt
+++ b/docs/ref/applications.txt
@@ -186,6 +186,14 @@ Configurable attributes
It must be unique across a Django project.
+ .. warning::
+
+ Changing this attribute after migrations have been applied for an
+ application will result in breaking changes to a project or, in the
+ case of a reusable app, any existing installs of that app. This is
+ because ``AppConfig.label`` is used in database tables and migration
+ files when referencing an app in the dependencies list.
+
.. attribute:: AppConfig.verbose_name
Human-readable name for the application, e.g. "Administration".