diff --git a/.wordpress-org/screenshot-1.png b/.wordpress-org/screenshot-1.png
new file mode 100644
index 0000000..039b93c
Binary files /dev/null and b/.wordpress-org/screenshot-1.png differ
diff --git a/.wordpress-org/screenshot-2.png b/.wordpress-org/screenshot-2.png
new file mode 100644
index 0000000..17dba3f
Binary files /dev/null and b/.wordpress-org/screenshot-2.png differ
diff --git a/.wordpress-org/screenshot-3.png b/.wordpress-org/screenshot-3.png
new file mode 100644
index 0000000..c92eef2
Binary files /dev/null and b/.wordpress-org/screenshot-3.png differ
diff --git a/.wordpress-org/screenshot-4.png b/.wordpress-org/screenshot-4.png
new file mode 100644
index 0000000..c616ff7
Binary files /dev/null and b/.wordpress-org/screenshot-4.png differ
diff --git a/readme.txt b/readme.txt
index 461a46b..60ec4fc 100644
--- a/readme.txt
+++ b/readme.txt
@@ -9,4 +9,31 @@ Requires PHP: 8.0
 License: MIT
 License URI: https://opensource.org/licenses/MIT
 
-VO HTML Sitemap is a simple plugin that adds a HTML sitemap to your WordPress site.
+Adds an HTML sitemap to easily display your site structure.
+
+== Description ==
+
+## VO HTML Sitemap, what does it do?
+
+This plugin adds an HTML sitemap to your WordPress website. This sitemap allows visitors and search engine crawlers to easily navigate your website structure.
+
+## Why use an HTML sitemap?
+
+An HTML sitemap is a great way to show your website structure to your visitors. It helps them to easily navigate your website. Besides that, it also helps search engine crawlers to index your website. This can help to improve your SEO.
+
+## Features
+
+- Easy to use
+- Lightweight
+- Simple configuration
+- Works out of the box
+
+## How to use
+
+After installing the plugin and selecting the page where you want to display the sitemap in the plugins settings, flush the permalinks. You can do this by going to the permalinks settings page and clicking the save button.
+
+== Screenshots ==
+1. The sitemap overview
+2. Today's overview
+3. Month overview
+4. Year overview