diff --git a/doc/user_documentation.rst b/doc/user_documentation.rst
index 12c88f7f6..532eb979a 100644
--- a/doc/user_documentation.rst
+++ b/doc/user_documentation.rst
@@ -859,6 +859,22 @@ contents of the directories. Either please ignore the inconsistency, or visit
the `non-cached host variant
`_.
+.. _`faq-build-timeout`:
+
+.. rubric:: My build failed because of a timeout, why? :ref:`¶ `
+
+Builds are not allowed to run forever. The default limit is 5 hours
+(18000 seconds) but users can increase it up to 30 hours (108000
+seconds). If the timeout limit is exceeded, the build will be killed
+with the following error message:
+
+::
+
+ !! Copr timeout => sending INT
+ Copr build error: Build failed
+ Shared connection to builder closed.
+
+
.. _`Weird SCM build failure?`:
.. rubric:: Weird SCM build failure? :ref:`¶ `