diff --git a/topics/reference_guide/custom_language_support/registering_file_type.md b/topics/reference_guide/custom_language_support/registering_file_type.md
index 57e563e1b..31999c84b 100644
--- a/topics/reference_guide/custom_language_support/registering_file_type.md
+++ b/topics/reference_guide/custom_language_support/registering_file_type.md
@@ -29,6 +29,10 @@ To associate the file type in the IDE, specify one or more associations as liste
+> The FileType Factory approach is deprecated. Use it only when the plugin requires support for platform versions older than 2019.2.
+>
+{type="warning"}
+
To register a file type, the plugin developer provides a subclass of [`FileTypeFactory`](upsource:///platform/ide-core/src/com/intellij/openapi/fileTypes/FileTypeFactory.java), which is registered via the `com.intellij.fileTypeFactory` extension point.
diff --git a/topics/tutorials/custom_language_support/language_and_filetype.md b/topics/tutorials/custom_language_support/language_and_filetype.md
index 60cc5e00a..130954b7f 100644
--- a/topics/tutorials/custom_language_support/language_and_filetype.md
+++ b/topics/tutorials/custom_language_support/language_and_filetype.md
@@ -48,9 +48,7 @@ The Simple Language file type is defined by subclassing [`LanguageFileType`](ups
-Direct registration is possible - no `FileTypeFactory` is required.
-
-Instead, the file type is registered via the `com.intellij.fileType` extension point in plugin.xml and registered with *.simple extension:
+The Simple Language file type is registered via the `com.intellij.fileType` extension point in plugin.xml and registered with *.simple extension:
```xml
@@ -67,6 +65,10 @@ Instead, the file type is registered via the `com.intellij.fileType` extension p
+> The FileType Factory approach is deprecated. Use it only when the plugin requires support for platform versions older than 2019.2.
+>
+{type="warning"}
+
### Define a FileType Factory
First, define `SimpleFileTypeFactory` as a subclass of [`FileTypeFactory`](upsource:///platform/ide-core/src/com/intellij/openapi/fileTypes/FileTypeFactory.java).