diff --git a/docs/embed.md b/docs/embed.md
index 7c31ed69..fa678204 100644
--- a/docs/embed.md
+++ b/docs/embed.md
@@ -6,12 +6,17 @@ nav_order: 1
parent: Usage
---
-## Embed event[s] in your webpage
+
+
+## Embed a single event or a list of events in your webpage
+{: .no_toc }
You can embed a list of filtered events or a specific event card in your webpage using a classic old-school `iframe` or a shiny new webcomponent.
+1. TOC
+{:toc}
## Webcomponents
-Webcomponents usage requires a small (~5kB gzipped) js script to be loaded in your page (note that you should use your instance name):
+[Webcomponents](https://www.webcomponents.org/introduction) usage requires a small (~5kB gzipped) js script to be loaded in your page (note that you should use your instance name):
```html
```
@@ -32,11 +37,26 @@ You can also embed a list of events using `` custom element, you
```html
-
+
+ Gancio Events
+
```
-
+Gancio Events
> info "Customize"
> Note that you can modify the title (or completely remove it using an empty `title` param) and the icon,
> you can limit the list to a maximum number of events using the `maxlength` parameter and filter events by `tags` or `places` using that parameters (it's easier using **gancio** than to explain it here)
+
+
+## IFrame
+You can also use the old iframe method
+
+
+```html
+
+```
+
+
+## Wordpress
+To embed an event or a list of events into a [WordPress](https://wordpress.com) website you can use the [WPGancio](https://wordpress.org/plugins/wpgancio/) plugin, this allows you to use webcomponents and shortcodes and automatically includes the needed script in each page and post.
\ No newline at end of file