summaryrefslogtreecommitdiffstats
path: root/docs/content/en/_common/ref-and-relref-error-handling.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/_common/ref-and-relref-error-handling.md')
-rw-r--r--docs/content/en/_common/ref-and-relref-error-handling.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/content/en/_common/ref-and-relref-error-handling.md b/docs/content/en/_common/ref-and-relref-error-handling.md
new file mode 100644
index 000000000..1d67bbc1f
--- /dev/null
+++ b/docs/content/en/_common/ref-and-relref-error-handling.md
@@ -0,0 +1,10 @@
+---
+_comment: Do not remove front matter.
+---
+
+By default, Hugo will throw an error and fail the build if it cannot resolve the path. You can change this to a warning in your site configuration, and specify a URL to return when the path cannot be resolved.
+
+{{< code-toggle file=hugo >}}
+refLinksErrorLevel = 'warning'
+refLinksNotFoundURL = '/some/other/url'
+{{< /code-toggle >}}