diff --git a/.gitignore b/.gitignore
index cd3ce97f..ddf8e997 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,6 +33,7 @@ __pycache__
 web/manager-api/dist/
 web/static/
 web/project-website/public/
+web/project-website/resources/_gen/
 /dist/
 /tools/
 
diff --git a/internal/manager/api_impl/jobs.go b/internal/manager/api_impl/jobs.go
index bda08fcd..b032f9c3 100644
--- a/internal/manager/api_impl/jobs.go
+++ b/internal/manager/api_impl/jobs.go
@@ -94,8 +94,8 @@ func (f *Flamenco) SubmitJob(e echo.Context) error {
 	authoredJob, err := f.jobCompiler.Compile(ctx, submittedJob)
 	switch {
 	case errors.Is(err, job_compilers.ErrJobTypeBadEtag):
-		logger.Warn().Err(err).Msg("rejecting submitted job, job type etag does not match")
-		return sendAPIError(e, http.StatusPreconditionFailed, "rejecting job, job type etag does not match")
+		logger.Warn().Err(err).Msg("rejecting submitted job because its settings are outdated, refresh the job type")
+		return sendAPIError(e, http.StatusPreconditionFailed, "rejecting job because its settings are outdated, refresh the job type")
 	case err != nil:
 		logger.Warn().Err(err).Msg("error compiling job")
 		// TODO: make this a more specific error object for this API call.
diff --git a/web/project-website/content/faq/_index.md b/web/project-website/content/faq/_index.md
index 0f1e123e..e13de260 100644
--- a/web/project-website/content/faq/_index.md
+++ b/web/project-website/content/faq/_index.md
@@ -6,6 +6,13 @@ weight: 30
 This is a list of frequently asked questions, with their answers. It's by no
 means an exhaustive list.
 
+## What do "Error: Cached job type is old" or "job type etag does not match" mean?
+
+This means that you have to click on the little "Refresh" icon next to the job type:
+
+<img src="job-types-refresh.webp" width="396" height="41">
+
+
 ## ​What's the difference with OpenCue?
 
 OpenCue is aimed at a different audience than Flamenco. OpenCue is a large and
diff --git a/web/project-website/content/faq/job-types-refresh.webp b/web/project-website/content/faq/job-types-refresh.webp
new file mode 100644
index 00000000..75e3d86f
Binary files /dev/null and b/web/project-website/content/faq/job-types-refresh.webp differ