This is an automated email from the ASF dual-hosted git repository.
pierrejeambrun pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 49674b776df Document that plugin names must be unique (#73197)
49674b776df is described below
commit 49674b776df40562e47b60693958293b734199ce
Author: Aaron Chen <[email protected]>
AuthorDate: Wed Sep 16 00:28:11 2026 +0800
Document that plugin names must be unique (#73197)
---
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 d215940c054..c209a403bbe 100644
--- a/airflow-core/docs/administration-and-deployment/plugins.rst
+++ b/airflow-core/docs/administration-and-deployment/plugins.rst
@@ -177,6 +177,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
