diff --git a/openpype/plugins/publish/help/validate_publish_dir.xml b/openpype/plugins/publish/help/validate_publish_dir.xml
new file mode 100644
index 0000000000..9f62b264bf
--- /dev/null
+++ b/openpype/plugins/publish/help/validate_publish_dir.xml
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+<error id="main">
+<title>Source directory not collected</title>
+<description>
+## Source directory not collected
+
+Instance is marked for in place publishing. Its 'originalDirname' must be collected. Contact OP developer to modify collector.
+
+</description>
+<detail>
+### __Detailed Info__ (optional)
+
+In place publishing uses source directory and file name in resulting path and file name of published item. For this instance
+    all required metadata weren't filled. This is not recoverable error, unless instance itself is removed.
+    Collector for this instance must be updated for instance to be published.
+</detail>
+</error>
+<error id="not_in_dir">
+<title>Source file not in project dir</title>
+<description>
+## Source file not in project dir
+
+Path '{original_dirname}' not in project folder. Please publish from inside of project folder.
+
+### How to repair?
+
+Restart publish after you moved source file into project directory.
+</description>
+</error>
+</root>
\ No newline at end of file
diff --git a/openpype/plugins/publish/validate_publish_dir.py b/openpype/plugins/publish/validate_publish_dir.py
index e375fadf49..2f41127548 100644
--- a/openpype/plugins/publish/validate_publish_dir.py
+++ b/openpype/plugins/publish/validate_publish_dir.py
@@ -1,7 +1,7 @@
 import pyblish.api
 from openpype.pipeline.publish import ValidateContentsOrder
 from openpype.pipeline.publish import (
-    KnownPublishError,
+    PublishXmlValidationError,
     get_publish_template_name,
 )
 
@@ -35,20 +35,25 @@ class ValidatePublishDir(pyblish.api.InstancePlugin):
 
         original_dirname = instance.data.get("originalDirname")
         if not original_dirname:
-            raise KnownPublishError(
+            raise PublishXmlValidationError(
+                self,
                 "Instance meant for in place publishing."
                 " Its 'originalDirname' must be collected."
-                " Contact OP developer to modify collector.")
+                " Contact OP developer to modify collector."
+            )
 
         anatomy = instance.context.data["anatomy"]
 
         success, _ = anatomy.find_root_template_from_path(original_dirname)
-        self.log.info(_)
+
+        formatting_data = {
+            "original_dirname": original_dirname,
+        }
+        msg = "Path '{}' not in project folder.".format(original_dirname) + \
+              " Please publish from inside of project folder."
         if not success:
-            raise PublishValidationError(
-                "Path '{}' not in project folder.".format(original_dirname) +
-                " Please publish from inside of project folder."
-            )
+            raise PublishXmlValidationError(self, msg, key="not_in_dir",
+                                            formatting_data=formatting_data)
 
     def _get_template_name_from_instance(self, instance):
         project_name = instance.context.data["projectName"]