Email Reports: Setup & Troubleshooting
Receive automated SEO performance reports in your inbox -- weekly or monthly. This guide covers setup, email deliverability, and troubleshooting.
Email Reports are available on the Pro tier and above.
What You Get
SEObolt compiles data from Google Search Console and your site's SEO analysis into a clean HTML email:
| Report Section | Data Included |
|---|---|
| Traffic Overview | Clicks, impressions, CTR, average position |
| Top Keywords | Best-performing search queries with position changes |
| Top Pages | Highest-traffic pages with SEO scores |
| Score Distribution | Pie chart of Good/Fair/Poor SEO scores across all content |
| 404 Summary | New 404 errors detected in the reporting period |
| Keyword Movements | Keywords that improved or declined in position |
Setup (5 Minutes)
Step 1: Check Email Deliverability
Before configuring reports, make sure your site can actually send emails:
- Go to SEObolt > Settings > Analytics > Email Reports
- Look for the Email Deliverability status indicator:
| Status | What It Means | Action Needed |
|---|---|---|
| Green (SMTP Detected) | An SMTP plugin is installed | You're good to go |
| Yellow (No SMTP) | Using PHP mail() | Install WP Mail SMTP for reliability |
| Red (Shared Hosting) | Email likely blocked | SMTP plugin required -- see below |
Install an SMTP plugin first. Without it, reports will likely land in spam or not deliver at all.
Recommended SMTP Plugins
| Plugin | Best For |
|---|---|
| Royal SMTP | Our own lightweight SMTP plugin — pairs perfectly with SEObolt (available in WordPress plugin directory) |
| WP Mail SMTP | Most popular, supports Gmail/SendGrid/Mailgun |
| FluentSMTP | Clean UI, multi-connection support |
| Post SMTP | Detailed email logging |
Quick SMTP setup with Gmail:
Install WP Mail SMTP
Install and activate the WP Mail SMTP plugin from the WordPress plugin repository.
Choose Gmail
Choose "Google / Gmail" as the mailer in the setup wizard.
Complete OAuth Setup
Follow the OAuth setup wizard to connect your Gmail account.
Send a Test Email
Send a test email to verify everything is working.
Step 2: Configure Reports
Navigate to Email Reports
Go to SEObolt > Settings > Analytics > Email Reports.
Enable Email Reports
Toggle Enable Email Reports to ON.
Configure Settings
Set your preferred frequency, day, recipients, and sections.
| Setting | Recommended | Description |
|---|---|---|
| Frequency | Weekly | Monthly is too infrequent to catch issues early |
| Day | Monday | Start the week with SEO insights |
| Recipients | Your email | Comma-separated for multiple recipients |
| Include Sections | All checked | Uncheck sections you don't need |
Send Test Email
Click "Send Test Email" to verify delivery.
Save Settings
Click "Save Settings" to activate scheduled reports.
Step 3: Verify Delivery
After clicking "Send Test Email":
- Check your inbox (wait up to 2 minutes)
- Check your spam/junk folder
- If nothing arrives, see the Troubleshooting section below
Prerequisites
Email reports require:
- Google Search Console connected -- Reports pull traffic data from GSC. Without it, traffic sections will be empty.
- Email delivery working -- An SMTP plugin configured with a real email service.
- Active Pro license -- Email reports are a Pro+ feature.
For Agencies: Client Reporting
Email reports are great for agency-client communication:
- Add your client's email to the Recipients field
- Set frequency to Monthly for clients (less overwhelming)
- Each site sends its own report -- configure per WordPress installation
- Reports are branded with your site name
Pair email reports with the SaaS Dashboard (Business tier) for more detailed client reporting.
Troubleshooting
Not Receiving Reports
Check in this order:
- Check spam folder -- Automated WordPress emails are frequently flagged as spam
- Send test email -- Click the Test button in Settings > Analytics > Email Reports
- If test email arrives: Reports are working. Wait for the next scheduled send.
- If test email fails: Continue troubleshooting.
- Check SMTP plugin -- Is an SMTP plugin installed AND configured?
- Install WP Mail SMTP if you don't have one
- Send a test from WP Mail SMTP's own settings page
- Check email address -- Typo in the recipients field?
- Check schedule -- Reports only send on the configured day. If you set "Monday," wait until Monday.
- Check GSC connection -- Go to SEObolt > Analytics and verify GSC shows data
Test Email Works But Scheduled Reports Don't
- WordPress cron issue -- Reports are sent via
wp_cron. If cron is broken:- Check if
DISABLE_WP_CRONis set inwp-config.php - If disabled, set up a real server cron job:
- Check if
*/15 * * * * wget -qO- https://yoursite.com/wp-cron.php
- Caching plugin interference -- Some caching plugins prevent wp-cron from running. Exclude
wp-cron.phpfrom cache. - Low traffic site -- wp-cron only runs when someone visits your site. Set up a real cron job (above) for reliable scheduling.
Report Data Is Empty
- GSC not connected -- Connect Google Search Console in SEObolt > Analytics
- New site -- Sites with very little traffic may have insufficient data
- Date range -- The first report after setup may have limited data; subsequent reports will be fuller
- Property mismatch -- Selected GSC property must match your site URL
Report Looks Broken (Formatting Issues)
- Email client -- Some email clients strip HTML formatting
- Try a different client -- Open in Gmail web instead of Outlook desktop
- Report still generates -- The data is correct even if styling is imperfect
Frequently Asked Questions
"Can I customize the report design?"
Not currently. Reports use a standard HTML template with your site name and the SEObolt brand.
"Can I send reports to multiple people?"
Yes. Enter multiple email addresses separated by commas in the Recipients field.
"What time are reports sent?"
Reports send during the first wp-cron execution on the scheduled day, which depends on site traffic. For precise timing, set up a server-side cron job.
"Can I get daily reports?"
Not currently. Weekly and monthly are the available frequencies.
"Do reports include SaaS Dashboard data?"
No. Email reports pull data from your WordPress installation (GSC connection, local SEO scores). The SaaS Dashboard has its own reporting.