Documentation

Everything you need to protect your family

Installation, configuration, AI classification, YouTube protection, the escalation system, and the Windows desktop agent — all in one place.

Quick Start

Get Child Web Guard running in under 5 minutes.

1

Install Child Web Guard

Download the installer from the download page and run it on your child's PC — it sets everything up and adds protection to Chrome and Edge automatically.

2

Create your parent account

Create a free account at child-web-guard.com/login.

3

Configure your rules

Choose what to block in the web dashboard. If you use your own AI key, add it in the Child Web Guard app on your child's PC (the shield icon next to the clock).

4

Done — settings sync automatically

Settings sync automatically to every protected PC. You're protected.

Installation

Installing on Windows

Child Web Guard comes as one Windows installer — get it from the download page and run it on your child's PC. Protection appears in Chrome and Edge the next time the browser opens, and a small background app keeps it in place. There is nothing to add from the Chrome Web Store — the installer takes care of everything.

System Requirements

Google Chrome or Microsoft Edge

A recent version of either browser on the protected PC — protection is added to both automatically.

Windows 10 or 11

Child Web Guard needs a Windows PC. The installer sets everything up — nothing else to install.

Note: an internet connection is needed for AI checks. Sites that were checked before keep working offline.

Configuration

AI Providers

Child Web Guard supports three AI providers. All use OpenAI-compatible APIs:

  • Qwen (Aliyun) — Default. Endpoint: maas.aliyuncs.com. Model: qwen3.7-plus
  • Kimi (Moonshot) — Endpoint: api.kimi.com. Model: kimi-k2.7
  • z.ai (GLM) — Endpoint: api.z.ai. Model: glm-5.2

Blocking Rules Priority

Rules are evaluated in this order (first match wins):

1

Parent allow list

Always allow (overrides everything)

2

Parent block list

Always block (overrides AI)

3

YouTube rules

Blocked channels and YouTube mode (AI / block / allow)

4

Escalated domains

Auto-blocked after repeated violations; parents undo via Exceptions

5

Known facts

Built-in gaming/short-video lists, cached AI verdicts, per-video facts — most specific match wins

6

Default: allow

Unknown sites are analyzed by AI; anything unmatched is allowed

AI Classification

When an unknown site is visited, the extension sends the page title and content (truncated to 3,000 characters) to the AI provider. The AI returns a JSON verdict:

json — verdict response
{
  "category": "gaming",
  "tags": { "gaming": 93 },
  "language": "English",
  "reason": "This is a gaming platform"
}

Blocked categories: adult gambling violence gaming short_video attention_trap

Allowed categories: educational, entertainment, social, news, shopping, tool, reference, other

Custom Rules

Add plain-text rules in the dashboard that shape AI decisions:

custom rules — examples
# General rules (apply to all sites)
No content about pranks or challenges
Allow math puzzle games

# Domain rules (apply only when domain matches)
scratch.mit.edu: kids may create projects,
  but playing others' games is blocked

YouTube Protection

YouTube has three modes:

AI mode DEFAULT

Each video is classified individually. Educational content is allowed; harmful or attention-trap content is blocked. Shorts are hidden if short-video blocking is enabled.

Block mode

All of YouTube is blocked.

Allow mode

All of YouTube is allowed (no classification).

Channel Blocking

Add YouTube channel handles (e.g., @guagua883) to the blocked channels list. Videos from these channels are blocked regardless of AI verdict.

Escalation System

When 5 or more subdomains of the same registered domain are blocked (e.g., foo.itch.io, bar.itch.io), the domain is escalated for parent review.

In the dashboard Escalated Domains tab, you can:

  • Allow this domain — Clears the escalation. The domain will no longer be auto-blocked.
  • Keep blocked — No action. The domain remains blocked.
  • Add to whitelist — Go to Settings and add the domain to the whitelist for permanent allowance.

Activity & Screen Time

The extension keeps a local activity record in each browser (every browser and browser profile has its own) so you can see how it is used. Open it from the extension popup → Known sites on this device (PIN required) → Activity in this browser. You will find:

  • Today's numbers — screen time, safe visits, AI checks, and blocks.
  • 7-day screen-time chart — active browsing minutes per day.
  • Top sites and categories — where the time goes and what kind of content is viewed.
  • Recent activity — pages visited with allowed/blocked outcomes.

Privacy is built in, not bolted on: the record never leaves the computer (not uploaded, not synced, not in the web dashboard), the page list auto-deletes after 7 days, and your child can see their own daily summary in the extension popup. You can pause counting or erase the record at any time from the same device page.

Desktop Agent (Windows)

The Desktop Agent is a small Windows program that keeps Child Web Guard in place. It installs automatically with everything else — and it's the reason your child can't remove or disable the protection.

What It Enforces

  • Keeps protection installed in every Chrome and Edge profile — even if your child tries to remove it
  • Turns off Incognito/InPrivate mode, so browsing can't be hidden
  • Blocks guest mode and new browser profiles — two common bypass tricks
  • Disables developer tools
  • Checks itself every 30 seconds and re-applies protection if anything was changed

Installation

Nothing separate to install — the Desktop Agent is included in the installer from the download page and starts automatically with Windows.

Troubleshooting

Extension not blocking sites

  • Check that protection is turned on (dashboard → Overview, or click the Child Web Guard shield icon in the browser toolbar)
  • Verify your AI provider and API key are set up in the Child Web Guard app (the shield icon next to the clock)
  • Check the dashboard for any allow-list entries that might override blocking
  • Clear the AI cache and try again

YouTube videos not being classified

  • Ensure YouTube mode is set to "AI analysis"
  • Check that the extension has permission to run on youtube.com
  • Look for errors in the browser console (F12)

Settings not syncing

  • Verify you're signed in to the same account on all devices
  • Changes you save in the dashboard reach the protected PC within about a minute
  • Check your internet connection

Desktop agent not working

  • Run the agent installer as Administrator
  • Check that cwg-agent.exe is running in Task Manager
  • Review logs at C:\ProgramData\Child Web Guard\

Still have questions?

Our support team is here to help.

Contact Support