Site Settings
Configure your site's analytics settings and preferences.
Accessing Settings
To access your site settings:
- Select your site from the dashboard
- Click "Settings" in the sidebar
- Or navigate to
/site/{siteId}/settings
General Settings
Site Name
A friendly name for your site displayed in the dashboard and reports.
Site ID
The 8-character Site ID identifies your site. It's the value of the data-site attribute in your tracking script, and the settings page shows a ready-to-copy snippet. The Site ID is not tied to a domain - use Included Domains (below) to control which hostnames can send data.
Domain Settings
Included Domains
When this list is empty, hits from any hostname are accepted. Once you add domains, only hits from those hostnames are recorded. Wildcards are supported: *.example.com matches blog.example.com and app.example.com, but not example.com itself - add it separately.
Excluded Domains
Hits from these hostnames are always dropped (for example staging.example.com or localhost). Excluded domains take precedence over included domains.
Privacy & Tracking
Enable Tracking
Pause data collection for the site without removing the script. While disabled, incoming hits are ignored.
Respect Do Not Track
When enabled, requests from browsers that send the DNT: 1 header are not recorded. You can also enforce this in the browser with data-honor-dnt="true" on the script tag.
Tracking Mode
Choose how visitors are recognised (tracking_mode in the API):
- Privacy (default) — the script stores nothing on the visitor's device: no cookies, no
localStorage, no fingerprinting. The server recognises a visitor for one day with a hash of the site, IP address and user agent, keyed with a salt that is replaced every UTC day. Designed so you don't need a cookie banner for Invoker. Unique visitors are counted per day, and there are no returning visitors or multi-day journeys. - Enhanced — the script keeps a random visitor ID (
invoker_cid) and a session ID (invoker_session) in your site'slocalStorage. Adds returning visitors, Visitor Logs across days, multi-day journeys and first-touch attribution. Needs visitor consent in the EU/UK.
Enhanced mode needs both the setting and data-mode="enhanced" on your script tag; the settings page shows the updated snippet when you switch. If storage is blocked, Enhanced mode falls back to the Privacy mode hash. When the script is served through a first-party proxy on your domain, the API may set first-party inv_visitor/inv_sid cookies in Enhanced mode. No third-party cookies are used in either mode. See Privacy & GDPR for the trade-offs and the Cookie Policy for every key.
IP Addresses
There's nothing to configure: visitor IP addresses are never stored. They're used only while a hit is processed, for location lookup (via a local DB-IP database) and IP/country blocking, and then discarded.
Bot Filtering
Known bots and crawlers are filtered out by user agent. This is on by default (filter_bots).
Exclude Query Parameters
Specify query parameters to strip from tracked URLs:
- Useful for removing session IDs, tokens or tracking parameters
- Helps consolidate page data
SPA & Hash Routing
Single-page app tracking is configured on the script tag, not in settings: add data-spa="history" (or "hash" for #/route routers). See Tracking Script.
Traffic Filtering
Block specific IPs, CIDR ranges or countries from being tracked. See Traffic Filtering for details.
Goals
Goals need no setup in settings: a goal appears in the Goals report the first time your site sends it with trackGoal(). See Goal Tracking.
Alerts
Traffic spike alerts by email, Slack or Discord live under Alerts in the sidebar. See Traffic Alerts.
Export Data
The Export Data card downloads pageviews, visitors, events, goals or sessions for the last 30 days as CSV or JSON. See Data Export.
Email Reports
Set up automated email reports:
- Weekly or monthly schedules
- Up to 10 recipients
- See Email Reports for details
Dashboard Sharing
Create shareable dashboard links:
- Optional password
- Optional expiry (1–365 days)
- See Dashboard Sharing for details
Team Settings
Team Members
Manage who has access to your site:
- Owner: Full access, can delete the site and manage the team
- Admin: Can change site settings and invite or manage team members with a lower role
- Editor: Can change site settings, but can't manage the team
- Viewer: Read-only access to analytics
See Team Management for the full permission matrix.
Inviting Members
- Open Team in the site's sidebar
- Enter the email address
- Select the role
- Send the invitation
Deleting a Site
The site owner can delete a site from Settings → Site Settings → Danger Zone (the account settings page). The site disappears from your account and stops collecting data. Export anything you need first. If you need its stored analytics erased right away, contact us.
API Access
Update site settings via the API (name is required on update):
PUT https://api.invoker.app/api/sites/{site_id}
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"name": "My Website",
"included_domains": ["example.com", "*.example.com"],
"excluded_domains": ["staging.example.com"],
"respect_dnt": true,
"filter_bots": true,
"exclude_query_params": ["session_id"],
"blocked_ips": ["203.0.113.10"],
"blocked_countries": ["XX"]
}