diff --git a/src/webengine/doc/src/qtwebengine-deploying.qdoc b/src/webengine/doc/src/qtwebengine-deploying.qdoc
index 8530bc075c8badfd50a15a2b069fa28be86ada6a..c9f0f35808b927d85f0080c4575f1efc73bdbfdc 100644
--- a/src/webengine/doc/src/qtwebengine-deploying.qdoc
+++ b/src/webengine/doc/src/qtwebengine-deploying.qdoc
@@ -141,4 +141,18 @@
             directory specified by
             QLibraryInfo::location(QLibraryInfo::TranslationsPath)
     \endlist
+
+    \section2 JavaScript Files in Qt Resource Files
+
+    If your WebEngine application is built using the Qt Quick Compiler, and the application ships
+    JavaScript files inside .qrc resources, and these files are supposed to be loaded from inside
+    HTML pages, make sure to specify the resource files in a \c QTQUICK_COMPILER_SKIPPED_RESOURCES
+    qmake variable inside your project. This prevents the Qt Quick Compiler from trying to generate
+    C++ code for the corresponding JavaScript code, as well as removing the original JavaScript code
+    from the Qt resources file, which would lead to broken HTML pages. For example:
+
+    \code
+    QTQUICK_COMPILER_SKIPPED_RESOURCES += resources/my_resource.qrc
+    \endcode
+
 */
diff --git a/src/webengine/doc/src/qtwebengine-overview.qdoc b/src/webengine/doc/src/qtwebengine-overview.qdoc
index 904e4a5511d63133118fa344bf62bc5bab68f59e..ccba7450427538d35d8fc0e38c5dcdfc1c1c2e21 100644
--- a/src/webengine/doc/src/qtwebengine-overview.qdoc
+++ b/src/webengine/doc/src/qtwebengine-overview.qdoc
@@ -205,6 +205,10 @@
     window.alert("Page is from qt.io, but not wiki.qt.io");
     \endcode
 
+    If your WebEngine application is built using the Qt Quick Compiler, and the application ships
+    JavaScript files inside .qrc resources, consider reading the section
+    \l{JavaScript Files in Qt Resource Files}.
+
     \section1 Managing Certificates
 
     Qt WebEngine uses its own network stack, and therefore QSslConfiguration is not used to