diff --git a/src/components/NcEmptyContent/NcEmptyContent.vue b/src/components/NcEmptyContent/NcEmptyContent.vue
index b23c217a44..e4550e5c0f 100644
--- a/src/components/NcEmptyContent/NcEmptyContent.vue
+++ b/src/components/NcEmptyContent/NcEmptyContent.vue
@@ -48,7 +48,8 @@ export default {
 ```
 
 You can also customize the title using the `#title` slot
-and add actions.
+and add actions. But to keep the style consistent across Nextcloud
+consider only using header elements as the root elements for the title slot.
 
 ```
 <template>
@@ -59,7 +60,7 @@ and add actions.
 		</template>
 		<template #title>
 			<h1 class="empty-content__title">
-				No Comments
+				No comments
 			</h1>
 		</template>
 		<template #action>
@@ -73,6 +74,34 @@ and add actions.
 <script>
 import Comment from 'vue-material-design-icons/Comment'
 
+export default {
+	components: {
+		Comment,
+	},
+}
+</script>
+```
+
+Similar to the `#title` slot, you could also use the `#description` slot.
+The content will be rendered within a paragraph so you can use any inline element,
+like a link.
+
+```
+<template>
+	<NcEmptyContent
+		title="No comments">
+		<template #icon>
+			<Comment />
+		</template>
+		<template #description>
+			<a href="https://en.wikipedia.org/wiki/Comment">What is even a comment?</a>
+		</template>
+	</NcEmptyContent>
+</template>
+
+<script>
+import Comment from 'vue-material-design-icons/Comment'
+
 export default {
 	components: {
 		Comment,
@@ -88,13 +117,17 @@ export default {
 			<!-- @slot Optional material design icon -->
 			<slot name="icon" />
 		</div>
+		<!-- @slot Optional title if not set as property, shall be enclosed by a header element -->
 		<slot name="title">
 			<h2 v-if="hasTitle" class="empty-content__title">
 				{{ title }}
 			</h2>
 		</slot>
 		<p v-if="hasDescription">
-			{{ description }}
+			<!-- @slot Optional formatted description rendered inside a paragraph -->
+			<slot name="description">
+				{{ description }}
+			</slot>
 		</p>
 		<div v-if="$slots.action" class="empty-content__action">
 			<!-- @slot Optional slot for a button or the like -->
@@ -123,8 +156,11 @@ export default {
 		hasTitle() {
 			return this.title !== ''
 		},
+		/**
+		 * Check if a description is given as either property or slot
+		 */
 		hasDescription() {
-			return this.description !== ''
+			return this.description !== '' || this.$slots.description?.[0]
 		},
 	},
 }