diff --git a/elementor-category-grid-widget.php b/elementor-category-grid-widget.php
index 86a96ea..cce84fe 100644
--- a/elementor-category-grid-widget.php
+++ b/elementor-category-grid-widget.php
@@ -1,15 +1,20 @@
 <?php
-/**
- * Plugin Name: Elementor Category Grid Widget
- * Description: Custom Elementor widget to display a grid of post categories with images.
- * Version:     1.2.0
- * Author:      MrRaph_
+ /**
+ * Plugin Name:     Elementor Category Grid Widget
+ * Plugin URI:      https://git.mrraph.fr/WordPress/elementor-category-grid-widget
+ * Description:     Grille responsive de catégories d’articles avec image pour Elementor.
+ * Version:         1.2.1
+ * Author:          MrRaph_
+ * Author URI:      https://mrraph.photo
+ * Requires at least: 5.8
+ * Requires PHP:      7.0
  * Text Domain: category-grid-widget
  * Requires Plugins: elementor
- * Elementor tested up to: 3.25.0
- * Elementor Pro tested up to: 3.25.0
+ * License:           GPLv2 or later
+ * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
  */
 
+
 if ( ! defined( 'ABSPATH' ) ) {
     exit; // Sécurité : empêche l'accès direct.
 }
@@ -36,7 +41,7 @@ function ccgw_enqueue_media_uploader( $hook_suffix ) {
         'ccgw-category-image',
         plugin_dir_url( __FILE__ ) . 'admin/js/category-image.js',
         [ 'jquery' ],
-        '1.2.0',
+        '1.2.1',
         true
     );
 
@@ -172,7 +177,7 @@ function ccgw_enqueue_front_styles() {
             'ccgw-category-grid-style',
             plugin_dir_url( __FILE__ ) . 'css/style.css',
             [],
-            '1.2.0'
+            '1.2.1'
         );
     }
 }
diff --git a/readme.txt b/readme.txt
new file mode 100644
index 0000000..c0bbc16
--- /dev/null
+++ b/readme.txt
@@ -0,0 +1,56 @@
+=== Elementor Category Grid Widget ===
+Contributors: mrraph
+Donate link: https://your-site.example/donate
+Tags: elementor, category, grid, widget, posts
+Requires at least: 5.8
+Tested up to: 6.8.1
+Requires PHP: 7.0
+Stable tag: 1.2.1
+License: GPLv2 or later
+License URI: https://www.gnu.org/licenses/gpl-2.0.html
+
+Responsive grid of post categories with images for Elementor.
+Allows manual selection of categories to display, inclusion of subcategories, hiding categories without images, and control over number of columns, image sizes, style settings, and hover effects.
+
+== Description ==
+**Elementor Category Grid Widget** adds a simple yet powerful widget to Elementor for displaying your post categories in a grid:
+- Manual selection of categories to display
+- Option to show subcategories
+- Option to hide categories without an image
+- Configurable number of columns (1–6)
+- Choice of image size (thumbnail, medium, large, full)
+- **Style** tab: spacing, card background & border, typography, shadow
+- **Hover** tab: customizable overlay (color & opacity), title color on hover
+- Each card is clickable and links to the category archive page
+
+The widget uses WordPress’s native category image feature (a “Category Image” field added in the admin).
+
+== Installation ==
+1. Upload the `elementor-category-grid-widget` folder to `/wp-content/plugins/`.
+2. Activate **Elementor Category Grid Widget** in the **Plugins** menu.
+3. In Elementor, add the **Category Grid** widget to your layout.
+4. Configure: select categories, columns, style, and hover effects.
+
+== Screenshots ==
+1. Elementor editor: widget settings panel  
+2. 4-column grid with hover overlay  
+3. Mobile: responsive single column  
+4. Advanced options in the Style tab  
+
+== Frequently Asked Questions ==
+= How do I assign an image to a category? =
+When creating or editing a category, a “Category Image” field appears in the admin. Click “Select Image” to set it.
+
+= Can I hide categories without an image? =
+Yes, enable the **“Hide categories without image”** option in the widget’s Content tab.
+
+= How do I customize the hover effect? =
+Open the **Style » Hover** tab: choose the overlay color & opacity, and the title color on hover.
+
+== Changelog ==
+= 1.2.1 =
+* Initial release  
+* Manual category and subcategory selection  
+* Configurable number of columns and image size  
+* Option to hide categories without image  
+* Added Style and Hover tabs for advanced customization