Welcome to maptrics.io! This guide will walk you through setting up your first website, configuring deploy webhooks, enabling Slack notifications, and understanding how our SEO monitoring system works.

Let's get started

maptrics.io helps you catch SEO regressions before Google does by automatically crawling your website after every deploy. This guide covers everything you need to know to get started and make the most of the platform.

First, complete your profile

When you first sign up, you'll go through a quick onboarding flow. This helps us personalize your experience and set up your account correctly.

Choose your user type - Are you a solo developer, part of a team, or managing multiple client websites? This helps us recommend the right features and subscription tier for your needs.

The onboarding process is straightforward and takes just a few minutes. Once complete, you'll be ready to add your first website.

Create your first project

Projects help you organize your websites. Think of them as containers for related websites—you might have one project per client, or one project for all your staging environments.

Why projects matter - Projects make it easy to:

Organize websites by client or environment
Set team-level permissions
Track activity across related sites
Manage billing and subscriptions

To create a project, simply click "New Project" in your dashboard and give it a name. You can always add more projects later as your needs grow.

Add your website

Adding your first website is simple. Enter your domain name (e.g., example.com) and we'll start discovering your pages.

Understanding subscription tiers - Each tier comes with different URL limits:

Starter: Perfect for small sites
Growth: For growing businesses
Pro: For larger sites with more pages
Business: For agencies managing multiple sites
Agency: For large-scale operations

Choose the tier that matches your site size. You can always upgrade later if you need more capacity.

Initial crawl process - Once you add your website, we'll perform an initial crawl to:

Discover your sitemap
Index all your pages
Establish a baseline for SEO health
Detect any existing issues

This first crawl may take a few minutes depending on your site size. You'll receive a notification when it's complete.

Set up some tags

Tags help you organize and filter your websites. Use them to categorize sites by:

Environment (staging, production)
Client names
Project types
Any other classification that makes sense for your workflow

How to add tags - Navigate to your website settings and click "Add Tag". You can add multiple tags to each website, making it easy to filter and search across your portfolio.

Tags are especially useful when managing multiple websites—you can quickly filter to see all staging sites, all client sites, or sites in a specific category.

Connect your deploy webhooks

This is where the magic happens. Deploy webhooks automatically trigger a crawl after every deployment, ensuring you catch SEO regressions immediately.

Why webhook integration matters - Without webhooks, you'd need to manually trigger crawls or rely on scheduled checks. With webhooks, every deploy automatically gets monitored, giving you instant feedback on SEO health.

How to create a webhook token - Navigate to your website settings and find the "Deploy Webhooks" section. Click "Create Webhook Token" and copy the generated token.

Your webhook URL will look like this:

https://maptrics.io/api/deploy/webhook/[your-token]

Integration examples - Here's how to integrate with Vercel:

Add the webhook URL to your project settings under "Deploy Hooks". Vercel will automatically call the webhook after each successful deployment.

Once configured, every deploy will automatically trigger a crawl, and you'll receive notifications about any SEO issues detected.

Get Slack notifications

Get real-time alerts about SEO issues directly in your Slack workspace. This ensures your team stays informed without constantly checking the dashboard.

Benefits of Slack integration - Receive instant notifications about:

New SEO issues detected
Crawl completions
Critical regressions
Deploy-linked issues

OAuth connection flow - To connect Slack:

Navigate to your team settings
Click "Integrations" → "Slack"
Click "Connect Slack Workspace"
Authorize maptrics.io to access your workspace
Choose which channels should receive notifications

Configuring notification preferences - You can customize:

Which channels receive notifications
What types of issues trigger alerts
Notification frequency (immediate or digest)
Issue severity filters

What alerts you'll receive - You'll get notifications for:

New critical issues (broken links, missing meta tags, etc.)
Crawl completions with issue summaries
Deploy-linked regressions
URL limit warnings

How crawling works

Our crawling system is designed to be comprehensive yet efficient. Here's how it works:

Sitemap-first approach - We start by discovering your sitemap. This helps us understand your site structure and ensures we crawl all important pages.

URL processing pipeline - Each URL goes through several stages:

Fetch - Download the page content
Extract - Parse HTML, meta tags, structured data
Snapshot - Store a snapshot for comparison
Detect - Identify SEO issues and regressions
Score - Calculate SEO health score

Issue detection system - We check for:

Broken internal and external links
Missing or duplicate meta tags
Structured data errors
Content changes that might affect SEO
Performance issues
Accessibility problems

Viewing crawl results - After each crawl, you can:

See a summary of issues found
View detailed reports for each URL
Compare current state with previous snapshots
Track SEO health score changes

Managing your issues

When issues are detected, you'll see them organized by type and severity.

Issue types and severity levels:

Critical - Issues that can significantly impact SEO (broken links, missing titles)
High - Issues that may affect SEO (duplicate content, slow pages)
Medium - Issues that may affect SEO (missing meta tags, small content changes)
Low - Issues that are not critical but should be addressed (small content changes)
Info - Informational items (new pages discovered, minor changes)

Viewing issue details - Click any issue to see:

Which URLs are affected
When the issue first appeared
Historical context
Recommended fixes

Historical tracking - Every issue is tracked over time. You can see:

When an issue was first detected
If it was resolved and came back
Which deploy introduced the issue
Trend analysis

Resolving and dismissing issues - Once you've fixed an issue:

Mark it as resolved (it will be verified on the next crawl)
Dismiss false positives
Add notes for your team

Chat with the AI assistant

Our AI assistant helps you understand your SEO health and get answers quickly.

Asking questions - Try queries like:

"What SEO issues were introduced in the last deploy?"
"Why did my health score drop?"
"What pages have broken links?"
"Show me all meta tag issues"

Understanding AI recommendations - The AI analyzes:

Your crawl history
Issue patterns
Best practices
Your specific site structure

Example queries - Here are some useful queries to get started:

"What broke in the last crawl?"
"Show me critical issues"
"Compare this week to last week"
"What's affecting my SEO score?"

Follow these tips to get the most out of maptrics.io:

Set up webhooks early - The sooner you connect webhooks, the more historical data you'll have. This makes it easier to identify patterns and trends.

Configure Slack for real-time alerts - Don't wait for email notifications. Slack alerts ensure your team knows about issues immediately.

Review issues after each deploy - Make it part of your deployment workflow. Check for issues right after deploying, not days later.

Use tags to organize websites - Tags make it easy to filter and manage multiple websites. Set up a consistent tagging strategy from the start.

Check the AI assistant regularly - The AI can surface insights you might miss. Ask questions regularly to stay informed about your SEO health.

Establish a monitoring cadence - Decide how often you'll review issues. Daily? After each deploy? Weekly? Consistency helps catch problems early.

Need help?

Need assistance? We're here to help:

Documentation - Check our comprehensive documentation for detailed guides and API references.

Support - Reach out to our support team through the in-app chat or email. We typically respond within 24 hours.

Community - Join our community to connect with other users, share tips, and get help from the community.

Ready to start monitoring your SEO health? Add your first website and set up your first deploy webhook!

Getting Started with maptrics.io: Complete Setup Guide