Sitewrap documentation

Overview

Sitewrap sits in front of your existing website and gives you a modern website operations layer. You can improve speed, understand what visitors are doing, publish selected pages, run experiments, collect leads, and protect sensitive routes from one dashboard.

Quickstart

Get a site live with the dashboard wizard, then review performance and traffic from your Sitewrap dashboard.

• Add website: enter your website domain and current origin URL.
• Verify setup: follow the dashboard checks before switching traffic.
• Warm important pages: preload key URLs so first visitors get fast responses.
• Review traffic: use request logs, live users, analytics, and leads to understand behavior.
• Publish safely: deploy selected page changes when you are ready.

Register and add a website

Use this flow when you are a normal Sitewrap user adding a website you own or manage.

1. Create your account. Open the Sitewrap signup page, enter your work email, and complete the login or signup flow.
2. Open the account home. Click Add website and enter the bare domain, for example example.com. Do not include https:// or a path.
3. Verify ownership. Sitewrap shows a TXT record. Open your DNS provider, add the TXT record exactly as shown, save it, and wait until the dashboard marks ownership as verified.
4. Review website detection. Sitewrap checks your homepage and suggests a starting configuration. If WordPress is detected, you can apply the recommended WordPress settings before going live.
5. Discover pages. Sitewrap reads your sitemap and lists pages. Review the detected URLs and continue when the important pages are visible.
6. Point traffic to Sitewrap. In your DNS provider, update the root A record to the IP shown by Sitewrap. Remove conflicting A records for the same root domain.
7. Confirm activation. Sitewrap checks DNS and activates the website automatically when the A record points to Sitewrap.

Account home and site switcher

The account home is where you manage websites, team access, account-wide settings, and billing information available to your role.

1. Open the Sitewrap dashboard and click the Sitewrap logo or home icon to return to account home.
2. Use Sites to open a website dashboard, continue a pending setup, add a new website, or remove a website when you no longer need it.
3. Use the site switcher in the top bar to search and switch between websites you can access.
4. Use Users to invite teammates, set roles, and limit which websites each teammate can access.
5. Use Global settings for account-wide defaults such as bot detection patterns, assistant availability, origin health interval, Slack app credentials, and email sending settings.
6. Use Billing to review usage and credits when billing is enabled for your account.

Home tab

The Home tab is the daily overview for one selected website. It summarizes availability, traffic, cache behavior, popular pages, leads, A/B tests, firewall activity, and recent operational signals.

1. Select the website from the site switcher at the top of the dashboard.
2. Open Home.
3. Use the timeframe selector when available to review a standard period such as the last 24 hours, or enter a custom range.
4. Check the top status widget first. It shows whether requests are being served by Sitewrap, your website origin, or other sources.
5. Review popular pages, recent leads, recent blocks, and experiment summaries to decide what needs attention.

Request log

The Request log shows traffic reaching your website through Sitewrap. It is the best place to debug pages, check response times, inspect cache source, and understand visitor engagement.

1. Open Request log for the selected website.
2. Use filters to narrow by page, status code, method, source, device, user, A/B flow, bot traffic, or time range.
3. Click Pause if new traffic is moving too quickly and you want to inspect the current rows.
4. Click a row to open details, including page title, URL, response time, source, device, visitor context, A/B assignment, time on page, interactions, and scroll depth.
5. Use the visitor badge to open the visitor profile and see related activity when available.
6. Use masked user/IP details for analytics. Full IP visibility should only be used in security and diagnostic workflows where appropriate.

Live users

Live users helps you understand who is currently active on the website, what page they are viewing, and how they are engaging.

1. Open Live users.
2. Review connected visitors, current page, device, country, A/B flows, and latest activity time.
3. Click the watch icon to open a live preview for a visitor.
4. Use the live view to review cursor movement, scroll position, current page, and engagement context.
5. Open visitor details from the visitor identity badge when you need the broader journey.

Live visibility depends on the website being served through Sitewrap and the visitor session being active.

Pages, editor and AI

The Pages tab lists pages known to Sitewrap and gives you tools to view, edit, create, search, deploy, and review page performance.

Find and review pages

1. Open Pages.
2. Use the path filter to find a known URL.
3. Use Search content to search text inside cached page content.
4. Use page actions to view the live page, open stats, edit page settings, deploy, or open the visual editor.

Create a page

1. Click Add page.
2. Enter the destination path, such as /pricing or /landing/summer.
3. Choose a creation method: fetch from origin, create with AI, blank page, import HTML, or clone an existing page.
4. If using AI, describe the page, choose complexity, and decide whether to continue the existing design or start from scratch with suggested colors.
5. Review the result in the editor, save it, and deploy when ready.

Edit a page

1. Click Edit on a page.
2. Select an element in the preview.
3. Use the style controls to adjust classes, spacing, colors, typography, layout, or selected element attributes.
4. For images, update the source and alt text, or upload a replacement image.
5. Use the AI tab when you want Sitewrap to change design or content based on your instruction.
6. If the page is part of an A/B test, choose the correct flow before editing.
7. Click Save, then deploy the page when you are ready to publish it.

A/B testing

A/B tests let you split visitors across variants and edit page versions per flow.

1. Open A/B Tests.
2. Click New experiment.
3. Name the experiment clearly, for example Homepage hero CTA.
4. Add variants/flows, set their traffic weights, and define which pages should have variant-specific content.
5. Save as a draft while preparing pages.
6. Open the relevant page in the editor, choose the flow selector, and save the version for each flow.
7. Return to A/B Tests and publish when all variants are ready.
8. Review assigned flows in Request log, Live users, Leads, and page stats.

For privacy-sensitive regions, configure consent behavior before using persistent variant storage.

Forms and leads

Forms are detected from your website pages. Leads are captured submissions that can be reviewed, grouped, assigned, commented on, and connected to visitor activity.

Set up forms

1. Open Forms.
2. Refresh after pages have been visited or preloaded.
3. Expand a form row to review method, target, fields, and pages where the form appears.
4. Give the form a readable name.
5. Choose a lead group and map form fields to lead fields when you want submissions to appear in Leads.
6. Open the form protection settings to enable bot protection for submissions.

Work leads

1. Open Leads.
2. Use groups to separate sales, support, demos, partnerships, or other lead types.
3. Search by name, email, or field value.
4. Filter by status, open a lead, review submitted values and visitor context, then add comments or update status.
5. Create a manual lead with New lead when you need to add a contact yourself.
6. Use bulk selection to delete selected leads when cleanup is needed.

Cache, site usage and preload

Sitewrap cache improves performance and reduces load on your existing website. Preload warms known pages so visitors are more likely to receive fast cached responses.

Review site usage

1. Open Site usage.
2. Review cached pages, assets, broad storage usage, memory entries, and recent source breakdown.
3. Use the hit/miss summary to understand whether requests are served by Sitewrap or your origin.

Run preload

1. Open Preload.
2. Review the sitemap URL, total URLs, cached URLs, skipped URLs, and failed URLs.
3. Use the search field to find a specific path.
4. Click Reload sitemap or Run full sitemap crawl when you want Sitewrap to refresh known URLs.
5. Pause or resume preload if you need to reduce traffic to your origin temporarily.

You can also configure preload from Settings -> Preload, including the sitemap URL and delay between URL fetches.

Deployments

Deployments publish cached or edited pages so changes are available to visitors.

Deploy one page

1. Open Pages.
2. Find the page you want to publish.
3. Click the page deploy action.
4. Review the deployment/version modal and start deployment.
5. Use version history to preview or restore previous versions when needed.

Deploy the full site

1. Open Deploy.
2. Click Deploy full site.
3. Confirm the action. Use Force redeploy only when you want every page regenerated even if unchanged.
4. Watch the progress bar and recent deployment list.

Choose deployment target

1. Open Settings -> Deployment.
2. Choose Local for the default Sitewrap-hosted deployment path (available on Launch and above).
3. On Enterprise, choose Amazon S3 if you want deployed files copied to your own S3 bucket and delivered through CloudFront.
4. For S3 mode, enter bucket name, AWS region, optional prefix, access key ID, secret key, and CloudFront distribution ID, then test the connection.

Security and firewall

Security features help reduce unwanted traffic and protect sensitive website paths.

1. Open Firewall to review blocked traffic, recent IPs, country, path, and status.
2. Open firewall settings from the gear icon.
3. Use the master switch to turn protections on or off.
4. Enable modules such as rate limiting, repeated 404 protection, blacklist rules, and suspicious probe protection based on your website risk.
5. Add trusted IPs to the allowlist when your team or partners must never be blocked.
6. Add manual blocklist entries for known abusive IPs.
7. Use Clear firewall stats when you want a fresh 24-hour view after a configuration change.

Use Settings -> Routes for path-level rules such as blacklist patterns, error page path, redirect fixing, and "only serve deployed pages".

Settings guide

Settings are per website. Open Settings, choose a subsection, update values, and click Save settings.

External tracking partners

Sitewrap can send analytics to Google Tag Manager, Google Analytics 4, and Mixpanel when configured for your website. Always align these settings with your consent banner and privacy policy.

Set up Google Tag Manager

1. Create or open a Google Tag Manager account.
2. Create a web container for your website.
3. Copy the container ID, for example GTM-XXXXXXX.
4. In Sitewrap, open Settings -> Tracking -> Google Tag Manager.
5. Enable GTM, paste the container ID, and save settings.
6. Preview your website and confirm tags fire according to your consent setup.

Set up Google Analytics 4

1. Create or open a Google Analytics account.
2. Create a GA4 property for your website.
3. Create a Web data stream and copy the Measurement ID, for example G-XXXXXXXXXX.
4. For server-side events, open the GA4 data stream settings and create a Measurement Protocol API secret.
5. In Sitewrap, open Settings -> Tracking -> Google Analytics 4.
6. Enable GA4, paste the Measurement ID, paste the API secret if you want server-side events, and set the consent default.
7. Choose tracking levels: frontend, socket fallback, and server. Leave only the levels you actually need enabled.
8. Choose event groups such as page views, CTA clicks, scroll depth, form submit, lead capture, video events, 404s, and performance timing.
9. Set sample rate. Use 1 for all events or a lower value such as 0.25 for 25% sampling.
10. Add excluded paths or user agents when you do not want analytics sent for specific traffic.
11. Save settings and verify events in GA4 Realtime or DebugView.

Set up Mixpanel (MP)

1. Go to mixpanel.com and create a Mixpanel account.
2. Create an organization if Mixpanel asks for one.
3. Create a project for the website you will track.
4. Open Project Settings in Mixpanel and find the Project Token.
5. Copy the Project Token. Do not use your personal password or unrelated API credentials.
6. In Sitewrap, open Settings -> Tracking -> Mixpanel.
7. Enable Mixpanel and paste the Project Token.
8. Choose persistence: memory for the most privacy-conscious default, localStorage or cookie only when your consent setup allows persistent storage.
9. Set consent default to denied unless your legal basis and consent banner support a different default.
10. Enable People/profile updates only if you want identified lead or user profile data sent to Mixpanel and you have the right notice/consent.
11. Choose tracking levels, event groups, sample rate, debug mode, bot filtering, excluded paths, and excluded user agents.
12. Save settings, then open your website and check Mixpanel Live View or Events to confirm data arrives.

Other dashboard tabs

Core concepts

These are the customer-facing ideas you will see throughout the Sitewrap dashboard.

Dashboard

The dashboard is where you manage your websites, review traffic, improve performance, collect leads, publish changes, and monitor security.

Pages, editor & AI

Sitewrap provides production-ready tools to create, edit, and deploy pages without layout drift.

• Pages tab: site structure from cache, page stats, templates, deploy versions.
• Visual page editor: select elements, adjust styles, update images, and prepare A/B variants visually.
• AI build studio: generate or refine sections with guided prompts and reusable design kits.
• Uploads: upload image assets and update image descriptions from the editor.

A/B testing

Define tests with weighted variants and review performance through request logs, leads, and visitor activity.

• Variants: create multiple page versions and control how traffic is split.
• Fast assignment: visitors are routed to the right variant at the edge.
• Consent-aware storage: persistent variant storage is only used when permitted by your consent setup.

Deployments

Publish selected pages or larger site updates with version history and rollback-friendly workflows.

• Deploy page: publish a single page and its required assets.
• Deploy site: publish broader cached site changes when you are ready.
• Version history: keep a clear record of changes so updates are easier to review and recover from.

Tracking & analytics

Sitewrap gives you request-level visibility, live user context, leads, and privacy-aware analytics for your own website.

• Request log: view pages, status codes, response time, device, source, and A/B flow.
• Consent-aware IDs: persistent visitor storage is only used after tracking consent where required.
• No-consent sessions: live engagement uses short-lived, server-side, coarse matching only for the active visit.
• Lead context: connect form submissions to pages, experiments, and visitor activity.
• Masked IPs: analytics and request-log views show anonymized IPs by default, while full IP use is limited to security, abuse prevention, diagnostics, and short retention windows.
• Website-owner controls: configure analytics behavior based on your privacy and consent requirements.

Security

Sitewrap helps reduce unwanted traffic before it reaches your website and gives you clearer security visibility.

• Firewall: block suspicious IPs, scanners, and abusive traffic.
• Origin protection: serve more requests from Sitewrap so fewer requests hit your hosting stack.
• Sensitive route protection: add extra checks around login screens, account pages, and private areas.
• Security logs: review blocked requests, suspicious paths, and recent security activity.
• Access control: dashboard access is account-based so only authorized users can manage your websites.

Integrations

• Email notifications: receive important account, support, and operational messages.
• Analytics tools: connect supported analytics destinations where appropriate for your plan and consent setup.
• Support workflows: share your domain, affected URL, and dashboard context when asking for help.

Account and website access

Sitewrap is designed for normal website owners and teams. After you register, you can add your website, invite the right teammates, and manage each website from your dashboard.

• Signup: create your Sitewrap account and start the website setup flow.
• Website access: only authorized account users should be able to change settings, publish pages, or view sensitive security details.
• Support: if something does not look right, contact support with your domain and the URL you are checking.

Troubleshooting

• Website does not activate: check the dashboard setup steps, DNS status, and whether your current website origin is reachable.
• Changes are not visible: refresh the relevant page cache from the dashboard and confirm you published the right version.
• Analytics look incomplete: confirm consent settings, tracking preferences, and whether the page is being served through Sitewrap.
• Security events look unexpected: review the affected URL, country, device, and blocked request details, then contact support if you need help.