Webful Documentation

Complete guide to install and use Webful on your site

1. Introduction

Webful is an ultra-lightweight and privacy-friendly traffic analysis solution. This documentation will guide you step by step to install Webful on your website.

✨ Before you begin

  • Make sure you have created a Webful account
  • Identify your site type: WordPress or classic site (HTML/PHP)
  • Allow 5 minutes for installation

Two installation methods

🔌
RECOMMENDED

Official WordPress plugin

One-click installation from WordPress.org. Available directly from your WordPress admin.

→ See guide
💻

Tracking code

Copy-paste a code into your site. For classic HTML/PHP sites.

→ See guide

2. WordPress Installation

🎉 WEBFUL Analytics is now available on WordPress.org!

Ultra-simple one-click installation from your WordPress admin. No need to download or manually upload the plugin.

1

Install the plugin from WordPress.org

  1. a.

    Log in to your WordPress administration

    WordPress Login
  2. b.

    In the left menu, go to PluginsAdd New

    Plugins Menu
  3. c.

    In the search bar, type WEBFUL

    Search WEBFUL
  4. d.

    The WEBFUL Analytics plugin appears in the results. Click Install Now

    Install plugin
  5. e.

    Once installation is complete, click Activate

    Activate plugin
  6. f.

    Accept consent for data processing

    🔒 WEBFUL Analytics collects anonymized data to generate your statistics:

    • Pages visited and time spent
    • Traffic source (referrer)
    • IP address irreversibly hashed (SHA-256)

    ✅ GDPR Protection: No cookies, no identifiable personal data, data stored in Europe.

    Accept tracking consent

    I accept and enable tracking

✅ The plugin is now installed, activated and configured!

Next step: connect your site to your Webful account

🔌

View on WordPress.org

Check out the official plugin page, user reviews and detailed information.

Open on WordPress.org
2

Connect your site to Webful

  1. a.

    In the WordPress left menu, click on Webful

    Webful Menu
  2. b.

    Enter your Webful credentials:

    • Email : your Webful email
    • Password : your Webful password
    Login form
  3. c.

    Click Connect my site

    The plugin will automatically register your WordPress site in your Webful account.

  4. d.

    You will see the status Connected

    Site connected

🎉 Congratulations! Your WordPress site is now connected to Webful!

Tracking is automatically enabled on all pages of your site.

⚙️ Optional settings

On the plugin configuration page, you can customize the behavior:

Don't track logged-in administrators

Your own visits won't be counted (recommended)

Pages to exclude from tracking

Exclude certain pages (e.g.: /thank-you, /confirmation)

3. Classic Site Installation

📌 This method is for HTML, PHP sites, or any non-WordPress site.
If you have a WordPress site, use the WordPress plugin instead.

1

Add your site in Webful

  1. a.

    Log in to your Webful dashboard

  2. b.

    Go to My sites

    My sites menu
  3. c.

    Click + Add a site

    Add site button
  4. d.

    Fill in the form:

    • Your site name : a name to identify your site (e.g.: "My Blog")
    • Your site URL : the full address of your site (e.g.: https://mysite.com)
    Add site form
  5. e.

    Click Create site

    Webful will automatically generate a unique tracking code for your site.

2

Copy the tracking code

  1. a.

    Once the site is created, you'll see the tracking code displayed

    Tracking code
  2. b.

    Click the Copy code button

    The code looks like this:

    <script src="https://webful.com/tracking/Webful-track.js" data-api-key="YOUR_UNIQUE_API_KEY"></script>
3

Install the code on your site

Paste the tracking code in the <head> section of all pages on your site:

<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>My Page</title> <!-- Webful tracking code --> <script src="https://webful.com/tracking/Webful-track.js" data-api-key="YOUR_API_KEY"></script> </head> <body> <!-- Page content --> </body> </html>

⚠️ Important:

  • Place the code in the <head>, not in the <body>
  • The code must be present on all pages you want to track
  • If you use a common template/header, add it once in that file

💡 Tip:

If your site uses a header.php or header.html file shared by all pages, add the code once in that file. It will automatically be present on all pages!

✅ Tracking is now installed on your site!

4. Verify it works

Once tracking is installed (WordPress or classic site), verify everything works correctly:

1️⃣

Visit your site

Open your site in a private browsing window (to avoid being blocked if you enabled "Don't track admins")

2️⃣

Navigate 2-3 pages

Click on several pages of your site to generate visits

3️⃣

Check the Webful dashboard

Log in to your Webful dashboard

Dashboard with statistics

You should see your visits appear in the statistics! 📊

✅ Everything works perfectly!

You can now track all your statistics in real-time from your Webful dashboard.

❓ Statistics not showing?

Check the Frequently Asked Questions section below.

5. Frequently Asked Questions

❓ Statistics don't appear in my dashboard

Check the following points:

  • Is the code installed? View your page source (Right-click > View source) and search for "Webful"
  • Wait a few seconds: data is sent when you leave the page or after 30 seconds
  • Private browsing: use a browser in private mode to test
  • Ad blockers: some blockers may block tracking, disable them temporarily
  • Browser cache: clear the cache and reload the page (Ctrl+Shift+R or Cmd+Shift+R)
❓ Does the WordPress plugin slow down my site?

No! The Webful tracking script is less than 1 KB and loads asynchronously. It has no noticeable impact on your site's loading speed.

❓ Are my own visits counted in the statistics?

No, your visits are NOT counted if you're logged into Webful!

✅ Automatic protection enabled

When you're logged into your Webful account and visit your own site, your visits aren't recorded in the statistics. This ensures accurate data representative of your real visitors.

⚠️ Important: How to test tracking without skewing your statistics

If you want to test that tracking works correctly on your site, you need to:

  • Option 1: Use a different browser (if you're logged in on Chrome, test with Firefox or Safari)
  • Option 2: Use a private browsing window (Ctrl+Shift+N on Chrome/Edge, Cmd+Shift+N on Safari)
  • Option 3: Log out of Webful before testing

💡 Tip: Private browsing is the simplest and fastest method to test.

ℹ️ Technical note: This protection works through your Webful login session. The system automatically detects that you're the site owner and excludes your visits from statistics.

❓ Is Webful GDPR compliant?

Yes, completely! Webful is designed to be privacy-friendly:

  • No cookies are used
  • No identifiable personal data is collected
  • IP addresses are irreversibly hashed
  • Native GDPR compliance
❓ Can I track multiple sites with one account?

Yes! The number of sites depends on your plan:

  • Free: 1 site
  • Solo: 1 site
  • Pro: 3 sites
  • Enterprise: 10+ sites

→ See all pricing

❓ Where can I find additional help?

If you need help, several options are available:

Our team typically responds within 24 hours on business days.

Ready to get started?

Create your free Webful account and install tracking in 5 minutes