This is an automated email from the ASF dual-hosted git repository.
pierrejeambrun pushed a commit to branch v3-3-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-3-test by this push:
new 0e9f66a9574 [v3-3-test] Document that plugin names must be unique
(#73197) (#73203)
0e9f66a9574 is described below
commit 0e9f66a9574c5372239f938c23e4fe31f0d661cb
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Sep 16 17:22:45 2026 +0200
[v3-3-test] Document that plugin names must be unique (#73197) (#73203)
(cherry picked from commit 49674b776df40562e47b60693958293b734199ce)
Co-authored-by: Aaron Chen <[email protected]>
---
airflow-core/docs/administration-and-deployment/plugins.rst | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/airflow-core/docs/administration-and-deployment/plugins.rst
b/airflow-core/docs/administration-and-deployment/plugins.rst
index 265237fc22d..eaa3a6f5979 100644
--- a/airflow-core/docs/administration-and-deployment/plugins.rst
+++ b/airflow-core/docs/administration-and-deployment/plugins.rst
@@ -172,6 +172,10 @@ You can derive it by inheritance (please refer to the
example below). In the exa
defined as class attributes, but you can also define them as properties if you
need to perform
additional initialization. Please note ``name`` inside this class must be
specified.
+``name`` must also be unique across all plugins. Airflow registers the first
plugin it discovers under a
+given name and skips any later plugin that reuses it, so two plugins sharing a
name means one of them is
+not loaded.
+
Make sure you restart the webserver and scheduler after making changes to
plugins so that they take effect.
Plugin Management Interface
