diff --git a/CUSTOMIZATION.md b/CUSTOMIZATION.md
index 0ad0cde..636e6fe 100644
--- a/CUSTOMIZATION.md
+++ b/CUSTOMIZATION.md
@@ -16,6 +16,10 @@
- [Layout Changes](#layout-changes)
- [Branding](#branding)
- [Template Customization](#template-customization)
+- [Analytics Configuration](#analytics-configuration)
+ - [Option 1: Use Your Own Matomo](#option-1-use-your-own-matomo-instance)
+ - [Option 2: Remove Matomo](#option-2-remove-matomo-entirely)
+ - [Option 3: Use Alternative Analytics](#option-3-use-google-analytics-or-other-service)
- [Advanced Customization](#advanced-customization)
- [Testing Your Changes](#testing-your-changes)
- [Examples](#examples)
@@ -89,6 +93,7 @@ open http://localhost:1999
4. Replace `education` section
5. Update `skills` section
6. Replace profile photo
+7. **Update Matomo analytics** (see [Analytics Configuration](#analytics-configuration) below)
---
@@ -1012,6 +1017,135 @@ tmpl := template.New("").Funcs(funcMap)
---
+## Analytics Configuration
+
+**CRITICAL:** If you use this template, you **MUST** update or remove the Matomo analytics configuration.
+
+### Option 1: Use Your Own Matomo Instance
+
+**Step 1:** Set up your own Matomo server
+- Install Matomo on your server or use a hosted service
+- Create a new website in Matomo dashboard
+- Note your Site ID and server URL
+
+**Step 2:** Update tracking code in `templates/index.html` (around line 635-649)
+
+Find this section:
+```javascript
+
+
+
+```
+
+**Change:**
+1. **Line 642:** Replace `https://matomo.drolo.club/` with your Matomo server URL
+2. **Line 644:** Replace `'4'` with your Site ID from Matomo dashboard
+
+**Step 3:** Update Content Security Policy in `internal/middleware/security.go` (lines 33, 37)
+
+Find and update these lines:
+```go
+// Line 33: Allow your Matomo domain for scripts
+"script-src 'self' 'unsafe-inline' https://unpkg.com https://code.iconify.design https://YOUR-MATOMO-DOMAIN.com; " +
+
+// Line 37: Allow your Matomo domain for API calls
+"connect-src 'self' https://api.iconify.design https://YOUR-MATOMO-DOMAIN.com; " +
+```
+
+Replace `https://matomo.drolo.club` with your Matomo domain.
+
+**Step 4:** Create your own privacy policy
+- Copy `PRIVACY.md` and update with your contact information
+- Update cookie disclosure with your Matomo server details
+- Ensure compliance with GDPR/privacy laws in your jurisdiction
+
+### Option 2: Remove Matomo Entirely
+
+If you don't want analytics:
+
+**Step 1:** Remove tracking code from `templates/index.html`
+
+Delete lines 623-649 (the entire Matomo section):
+```javascript
+// Delete this entire block:
+// Track HTMX navigation events with Matomo
+document.body.addEventListener('htmx:afterSwap', function(evt) { ... });
+
+
+
+
+```
+
+**Step 2:** Remove Matomo from CSP headers in `internal/middleware/security.go`
+
+Remove `https://matomo.drolo.club` from lines 33 and 37:
+```go
+// Before:
+"script-src 'self' 'unsafe-inline' https://unpkg.com https://code.iconify.design https://matomo.drolo.club; " +
+
+// After:
+"script-src 'self' 'unsafe-inline' https://unpkg.com https://code.iconify.design; " +
+```
+
+**Step 3:** Update or remove `PRIVACY.md`
+- Remove analytics section
+- Keep only essential privacy information
+
+### Option 3: Use Google Analytics or Other Service
+
+If you prefer Google Analytics, Plausible, or another service:
+
+1. **Remove Matomo code** (see Option 2 above)
+2. **Add your analytics provider's code** in the same location
+3. **Update CSP headers** to allow your analytics domain
+4. **Update PRIVACY.md** with your analytics provider's details
+5. **Ensure compliance** with privacy regulations (GDPR, CCPA, etc.)
+
+### Testing Analytics
+
+After configuration:
+
+```bash
+# 1. Build and run
+go build -o cv-server . && ./cv-server
+
+# 2. Open browser with developer tools
+open http://localhost:1999
+
+# 3. Check Console for errors
+# - Should see Matomo requests if configured
+# - Should see no errors about blocked scripts
+
+# 4. Verify in your analytics dashboard
+# - Real-time visitors should show your session
+# - Language switches should track as pageviews
+```
+
+### Privacy Compliance
+
+**Important legal considerations:**
+
+- ✅ Add cookie banner if required in your jurisdiction (EU requires consent)
+- ✅ Create privacy policy explaining data collection
+- ✅ Provide opt-out mechanism
+- ✅ Comply with GDPR, CCPA, or local privacy laws
+- ✅ Update privacy policy when changing analytics providers
+
+**See [PRIVACY.md](PRIVACY.md) for template privacy policy.**
+
+---
+
## Advanced Customization
### Adding New Languages (Beyond en/es)
diff --git a/PRIVACY.md b/PRIVACY.md
new file mode 100644
index 0000000..5c17eb5
--- /dev/null
+++ b/PRIVACY.md
@@ -0,0 +1,99 @@
+# Privacy & Cookies Policy
+
+**Last Updated:** November 9, 2025
+
+This website is a personal CV/portfolio site for Juan Andrés Moreno Rubio. This privacy notice explains what data is collected and how it's used.
+
+---
+
+## Analytics & Tracking
+
+### Matomo Analytics
+
+This website uses **Matomo**, a self-hosted, privacy-friendly analytics platform to understand visitor behavior.
+
+**What is collected:**
+- Pages you visit
+- Language preference (EN/ES)
+- Approximate location (country/city level)
+- Browser type and operating system
+- Referring website (if any)
+- Time spent on site
+- Clicks on external links
+
+**What is NOT collected:**
+- Personal identifying information (name, email, phone)
+- Precise geolocation
+- Cross-site tracking data
+
+**Cookies used:**
+- `_pk_id`: Visitor identifier (13 months)
+- `_pk_ses`: Session identifier (30 minutes)
+- `_pk_ref`: Attribution information (6 months)
+
+**Data storage:**
+- All analytics data is stored on my own server (`matomo.drolo.club`)
+- Data is NOT shared with third parties
+- Data is NOT sold or used for advertising
+
+**Opt-out:**
+- Matomo respects "Do Not Track" browser settings
+- You can block cookies in your browser settings
+- You can use browser extensions to block analytics scripts
+
+---
+
+## Other Data Collection
+
+### Language Preference
+
+The site stores your language preference (English/Spanish) in **localStorage** to remember your choice across visits. This is stored only in your browser and is never sent to the server.
+
+### No Account System
+
+This website does NOT require accounts, logins, or user registration. No personal data is collected through forms.
+
+---
+
+## Contact
+
+If you have questions about this privacy policy or data handling:
+
+**Email:** Contact information available on the CV itself
+**GitHub:** [https://github.com/juanatsap/cv-site](https://github.com/juanatsap/cv-site)
+
+---
+
+## For Developers Using This Code
+
+If you fork or use this code as a template:
+
+1. **Update Matomo Site ID** in `templates/index.html`:
+ ```javascript
+ _paq.push(['setSiteId', '4']); // Change to your Matomo site ID
+ ```
+
+2. **Update Matomo Server URL**:
+ ```javascript
+ var u="https://matomo.drolo.club/"; // Change to your Matomo instance
+ ```
+
+3. **Update this privacy policy** with your own contact information and data handling practices.
+
+4. **Configure CSP headers** in `internal/middleware/security.go` to allow your Matomo domain:
+ ```go
+ "script-src 'self' 'unsafe-inline' ... https://your-matomo-domain.com; "
+ "connect-src 'self' ... https://your-matomo-domain.com; "
+ ```
+
+5. **Remove Matomo entirely** if you don't want analytics - just delete the Matomo `