diff --git a/src/vue/components/EmbedContent/EmbedContent.vue b/src/vue/components/EmbedContent/EmbedContent.vue
index b2897d18..2c825d6f 100644
--- a/src/vue/components/EmbedContent/EmbedContent.vue
+++ b/src/vue/components/EmbedContent/EmbedContent.vue
@@ -1,5 +1,5 @@
 <script lang="ts">
-import Vue, { CreateElement, PropType, VNode } from 'vue';
+import Vue, { CreateElement, VNode } from 'vue';
 import { getScriptSrcFromOembedHTML, loadScript } from '../../../embed-utils';
 
 type Props = {
@@ -12,7 +12,7 @@ export default Vue.extend<NonNullish, NonNullish, NonNullish, Props>({
   name: 'EmbedContent',
   props: {
     content: {
-      type: String as PropType<string>,
+      type: String,
       required: true,
     },
   },
diff --git a/src/vue/components/EmbedContent/README.md b/src/vue/components/EmbedContent/README.md
index c30951fd..7bb960de 100644
--- a/src/vue/components/EmbedContent/README.md
+++ b/src/vue/components/EmbedContent/README.md
@@ -1,2 +1,28 @@
-# Component for rendering arbitrary html content
+# Component for rendering arbitrary (OEmbed) html content
 
+This component can be used to process and display arbitrary (OEmbed) content.
+
+## Props
+
+| Name    | Type   | Required | Description |
+| ------- | ------ | -------- | ----------- |
+| content | string | true     | HTML embed content for given vendor that usually comes from Iframely (OEmbed format)  |
+
+## Example
+
+```vue
+<template>
+  <embed-content :content="content"></embed-content>
+</template>
+
+<script>
+import { EmbedContent } from '@spring-media/red-sourcepoint-cmp/dist/esm/vue/components';
+
+export default {
+  components: { EmbedContent },
+  data: () => ({
+    content: 'some oembed/iframely html content'
+  }),
+};
+</script>
+```
diff --git a/src/vue/components/EmbedInstagram/EmbedInstagram.vue b/src/vue/components/EmbedInstagram/EmbedInstagram.vue
index ef522fda..1a6a1316 100644
--- a/src/vue/components/EmbedInstagram/EmbedInstagram.vue
+++ b/src/vue/components/EmbedInstagram/EmbedInstagram.vue
@@ -29,7 +29,7 @@ export default Vue.extend<Data, Methods, NonNullish, Props>({
   props: {
     content: {
       type: String,
-      default: '',
+      required: true,
     },
   },
   methods: {
diff --git a/src/vue/components/EmbedInstagram/README.md b/src/vue/components/EmbedInstagram/README.md
index 4cda0c16..03953a70 100644
--- a/src/vue/components/EmbedInstagram/README.md
+++ b/src/vue/components/EmbedInstagram/README.md
@@ -1 +1,31 @@
 # Component for Instagram Embeds
+
+This component can be used to process and display Instagram (OEmbed format) content.
+
+> Instagram needs to run some code after embedding content into the page. For other vendors consider using the provided generic embed component [EmbedContent](../EmbedContent/README.md).
+
+
+## Props
+
+| Name    | Type   | Required | Description |
+| ------- | ------ | -------- | ----------- |
+| content | string | true     | HTML embed content for given vendor that usually comes from Iframely (OEmbed format)  |
+
+## Example
+
+```vue
+<template>
+  <embed-instagram :content="content"></embed-instagram>
+</template>
+
+<script>
+import { EmbedInstagram } from '@spring-media/red-sourcepoint-cmp/dist/esm/vue/components';
+
+export default {
+  components: { EmbedInstagram },
+  data: () => ({
+    content: 'some oembed/iframely html content'
+  }),
+};
+</script>
+```