# Synoveo Documentation



Welcome to the Synoveo documentation. Find guides, tutorials, and reference materials to help you get the most out of Synoveo.

## Choose Your Path

<Cards>
  <Card title="Getting Started" description="New to Synoveo? Start here to learn the basics." href="/docs/getting-started" />

  <Card title="WordPress Plugin" description="Install and configure the WordPress plugin." href="/docs/wordpress" />

  <Card title="Dashboard Guide" description="Master the Synoveo dashboard." href="/docs/dashboard" />

  <Card title="API Reference" description="Build custom integrations with our API." href="/api-reference" />
</Cards>

## Popular Topics

<Cards>
  <Card title="Connect Google Business Profile" href="/docs/getting-started/connect-google" />

  <Card title="Auto-Post to Google" href="/docs/wordpress/auto-post" />

  <Card title="Manage Locations" href="/docs/dashboard/locations" />

  <Card title="Plans & Pricing" href="/docs/billing/plans-overview" />
</Cards>


# Agency Overview



Synoveo's agency features help you manage multiple Google Business Profile locations efficiently.

## Agency Dashboard

When you have 4+ locations, Synoveo automatically switches to the Agency Dashboard view:

* **Location overview** - All locations at a glance
* **Quick filters** - Filter by status, business, group
* **Bulk actions** - Select and act on multiple locations
* **Summary metrics** - Aggregate stats across locations

## Business Plans for Agencies

| Plan                   | Locations | Best For         |
| ---------------------- | --------- | ---------------- |
| **Pro**                | 3         | Small agencies   |
| **Business**           | 10        | Growing agencies |
| **Business + Add-ons** | 10+       | Large agencies   |

### Extra Locations

Need more than your plan includes?

* $5/month per additional location
* No limit on add-ons
* Scale as you grow

## Key Concepts

### Businesses

In Synoveo, a "Business" is a container that groups related locations:

* One business per client
* Or one business per brand/franchise
* Keeps API keys, billing, and settings organized

### Location Assignment

Google locations must be assigned to a Synoveo business:

* Links the Google location to your account
* Enables sync and management
* One location = one business assignment

### Google Groups

Synoveo respects your Google Business Profile organization:

* Groups import automatically
* Display in collapsible sections
* No manual reorganization needed

## Workflow

<Steps>
  <Step>
    ### Connect Google Account

    Link your agency Google account with access to all client locations
  </Step>

  <Step>
    ### Create Businesses

    Create a Synoveo business for each client or brand
  </Step>

  <Step>
    ### Assign Locations

    Map Google locations to the appropriate business
  </Step>

  <Step>
    ### Generate API Keys

    Create keys for each location/business as needed
  </Step>

  <Step>
    ### Start Managing

    Sync, post, review, and analyze across all locations
  </Step>
</Steps>

<Cards>
  <Card title="Managing Businesses" href="/docs/agency/managing-businesses" />

  <Card title="Location Assignment" href="/docs/agency/location-assignment" />
</Cards>


# Agency Best Practices



Best practices for agencies managing multiple Google Business Profile locations.

## Organization

### Use Clear Naming

```
[Client Name] - [Location City]
```

Example: "ABC Corp - Chicago", "ABC Corp - New York"

### Group by Client

Create one Synoveo business per client:

* Clear separation
* Easier billing tracking
* Client-specific settings

### Document Everything

Keep records of:

* Which Google account owns which locations
* API key assignments
* Client-specific requirements

## Efficiency

### Templates

Create reusable templates for:

* Review responses
* Common posts
* Sync configurations

### Bulk Operations

Use bulk actions for:

* Multi-location posts
* Mass sync operations
* Settings changes

### Scheduling

* Schedule posts in advance
* Set up auto-sync intervals
* Plan bulk operations during off-peak

## Client Management

### Onboarding Checklist

1. ☐ Get Google account access
2. ☐ Create Synoveo business
3. ☐ Assign all locations
4. ☐ Generate API keys
5. ☐ Set up WordPress (if applicable)
6. ☐ Configure sync settings
7. ☐ Run initial sync
8. ☐ Set up monitoring

### Regular Maintenance

* Weekly: Check sync status, respond to reviews
* Monthly: Review performance, update posts
* Quarterly: Audit profile health, optimize

### Client Reporting

Export data for client reports:

* Profile health scores
* Review metrics
* Post performance
* Sync history

## Security

### API Key Management

* One key per location or use case
* Descriptive names
* Regular rotation
* Immediate revocation when client leaves

### Access Control

* Limit who has Synoveo access
* Use strong authentication
* Review connected accounts regularly

## Troubleshooting

### Common Issues

1. **Sync failures** - Check individual location errors
2. **Rate limiting** - Space out bulk operations
3. **Missing locations** - Verify Google account access
4. **Stale data** - Refresh location cache

### Escalation Path

1. Check Synoveo logs
2. Review Google Business Profile directly
3. Contact Synoveo support with details

## Scaling

### As You Grow

* Upgrade plan before hitting limits
* Add locations proactively
* Automate repetitive tasks
* Consider API integration for custom workflows

### Enterprise Needs

Contact us for:

* Custom pricing
* Dedicated support
* Advanced features
* SLA guarantees

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Bulk Operations



Save time by performing actions on multiple locations at once.

<Callout type="info">
  Bulk operations require Business plan.
</Callout>

## Available Bulk Operations

### Sync

* **Bulk Sync** - Sync multiple locations simultaneously
* **Sync Preview** - Preview changes for all selected

### Posts

* **Bulk Post** - Create the same post across locations
* **Scheduled Posts** - Schedule for multiple locations

### Assignment

* **Bulk Assign** - Assign multiple locations to a business
* **Bulk Unassign** - Remove assignments

### Settings

* **Bulk Enable Sync** - Enable sync for multiple locations
* **Bulk Disable Sync** - Disable sync

## Performing Bulk Operations

<Steps>
  <Step>
    ### Select Locations

    Check the boxes next to locations you want to modify
  </Step>

  <Step>
    ### Open Bulk Actions

    Click "Bulk Actions" in the toolbar
  </Step>

  <Step>
    ### Choose Action

    Select the operation to perform
  </Step>

  <Step>
    ### Configure

    Set options specific to the action
  </Step>

  <Step>
    ### Execute

    Click "Apply to X Locations"
  </Step>
</Steps>

## Bulk Posting

Create posts across multiple locations:

1. Select target locations
2. Click "Bulk Actions → Create Post"
3. Write your post content
4. Choose post type
5. Add image (applied to all)
6. Publish or schedule

### Customization

* Use `{location_name}` placeholder for location-specific text
* Image is shared across all posts
* CTA links can be location-specific

## Bulk Sync

Sync multiple locations at once:

1. Select locations
2. Click "Bulk Actions → Sync Now"
3. Choose sync direction (Push/Pull)
4. Start sync
5. Monitor progress in bulk status view

### Rate Limiting

Bulk operations respect rate limits:

* Operations queued if needed
* Progress shown per location
* Errors reported individually

## Best Practices

1. **Start small** - Test with 2-3 locations first
2. **Review carefully** - Check selection before executing
3. **Monitor progress** - Watch for individual failures
4. **Use off-peak** - Schedule large operations for low-traffic times
5. **Check limits** - Ensure quota covers all operations

<Cards>
  <Card title="Best Practices" href="/docs/agency/best-practices" />

  <Card title="Rate Limits" href="/api-reference/introduction/rate-limits" />
</Cards>


# Agency & Multi-Location



For agencies and businesses managing multiple locations, Synoveo provides powerful tools to streamline your workflow.

## Who This Is For

* **Marketing agencies** managing client GBP profiles
* **Franchises** with multiple locations
* **Multi-location businesses** (retail chains, restaurants)
* **Consultants** handling GBP for multiple businesses

## Key Features

* **Bulk operations** - Update multiple locations at once
* **Location grouping** - Organize by client, region, or category
* **Unified dashboard** - See all locations in one view
* **Team access** - Collaborate with team members (coming soon)

## Quick Links

<Cards>
  <Card title="Agency Overview" href="/docs/agency/agency-overview" />

  <Card title="Managing Businesses" href="/docs/agency/managing-businesses" />

  <Card title="Location Assignment" href="/docs/agency/location-assignment" />

  <Card title="Best Practices" href="/docs/agency/best-practices" />
</Cards>


# Location Assignment



Before you can sync or manage a Google location, you must assign it to a Synoveo business.

## Why Assignment?

Assignment links a Google Business Profile location to a Synoveo business:

* **Organization** - Group locations by client or brand
* **Access control** - API keys only access assigned locations
* **Billing** - Track usage per business
* **Isolation** - Prevent accidental changes across businesses

## Assigning a Location

<Steps>
  <Step>
    ### Go to Locations

    Navigate to **Dashboard → Locations**
  </Step>

  <Step>
    ### Find Unassigned Location

    Look for locations without a business badge
  </Step>

  <Step>
    ### Click Assign

    Click the location and select "Assign to Business"
  </Step>

  <Step>
    ### Select Business

    Choose an existing business or create a new one
  </Step>

  <Step>
    ### Confirm

    Click "Assign" to complete
  </Step>
</Steps>

## Filtering Unassigned

Use the toggle to show only unassigned locations:

* Helps focus during onboarding
* Quickly identify locations needing assignment

## Assignment Rules

* One location can only be assigned to one business
* Unassign before reassigning to a different business
* Assignment doesn't affect Google - only Synoveo organization

## Unassigning a Location

To move a location to a different business:

1. Click the location
2. Select "Unassign"
3. Confirm removal
4. Location appears as unassigned
5. Assign to new business

<Callout type="info">
  Unassigning a location disables sync and revokes API key access for that location.
</Callout>

## Bulk Assignment

For multiple locations:

1. Select multiple locations (checkbox)
2. Click "Bulk Actions"
3. Select "Assign to Business"
4. Choose the target business
5. Confirm

## Assignment Badges

Assigned locations show a blue badge:

* Business name displayed
* Quick identification
* Click to see assignment details

<Cards>
  <Card title="Bulk Operations" href="/docs/agency/bulk-operations" />

  <Card title="API Keys" href="/api-reference/authentication/api-keys" />
</Cards>


# Managing Multiple Businesses



Learn how to create and manage multiple businesses in your Synoveo account.

## What is a Business?

A "Business" in Synoveo is a container that groups:

* Google Business Profile locations
* API keys
* Billing and quotas
* Settings and preferences

## Creating a Business

<Steps>
  <Step>
    ### Navigate to Businesses

    Go to **Dashboard → Businesses**
  </Step>

  <Step>
    ### Click Create

    Click "Create New Business"
  </Step>

  <Step>
    ### Enter Details

    * Business name (e.g., "Client XYZ" or "Brand ABC")
    * Description (optional)
  </Step>

  <Step>
    ### Save

    Click "Create Business"
  </Step>
</Steps>

## Organizing Businesses

### Naming Conventions

Use consistent naming:

* `[Client Name]` - For agencies
* `[Brand] - [Region]` - For franchises
* `[Category] - [Location]` - For multi-location

### Business Limits

Based on your plan:

* Lite: 1 business
* Solo: 1 business
* Pro: Multiple businesses
* Business: Unlimited businesses

## Managing a Business

### View Details

Click a business to see:

* Assigned locations
* API keys
* Sync status
* Quota usage

### Edit Business

Update business name or description.

### Delete Business

Remove a business:

1. Unassign all locations first
2. Revoke all API keys
3. Delete the business

<Callout type="warning">
  Deleting a business doesn't affect Google Business Profiles, only Synoveo's organization.
</Callout>

## Business Isolation

Each business is isolated:

* API keys only access assigned locations
* Quotas tracked per business
* Settings don't affect other businesses

This ensures:

* Client data stays separate
* No accidental cross-business changes
* Clear billing attribution

<Cards>
  <Card title="Location Assignment" href="/docs/agency/location-assignment" />

  <Card title="API Keys" href="/api-reference/authentication/api-keys" />
</Cards>


# Add-ons



Add more capacity and capabilities to your Synoveo plan.

<Callout type="info">
  Add-on pricing is fetched from our [public API endpoint](/api-reference/endpoints/config#pricing). Prices are stored in the database and can be updated without code changes.
</Callout>

## Extra Locations

Need more locations than your plan includes?

**$5/month per additional location**

### How It Works

1. Go to **Settings → Billing**
2. Click "Add Locations"
3. Select number to add
4. Confirm purchase
5. Locations available immediately

### Availability

| Plan     | Extra Locations         |
| -------- | ----------------------- |
| Lite     | <IconX /> Not available |
| Solo     | <IconCheck /> Available |
| Pro      | <IconCheck /> Available |
| Business | <IconCheck /> Available |

<Callout type="info">
  Extra locations are billed monthly on top of your base plan.
</Callout>

## Solo Plan Add-ons

Solo plan users can purchase add-ons to unlock additional features:

### Engagement Add-on - $7/month

Unlock content management capabilities:

* Local posts (updates, events, offers)
* Media/photo uploads
* All 600+ GBP attributes
* Social media links

### Reputation Add-on - $7/month

Unlock review management:

* Reply to reviews from Synoveo
* Manage review responses at scale
* Track review sentiment

<Callout type="tip">
  Consider upgrading to Pro instead of buying both add-ons. Pro includes all Engagement features and costs less than Solo + both add-ons ($29 vs $26).
</Callout>

## Pro Plan Add-ons

Pro plan includes Engagement features by default. Only the Reputation add-on is available:

### Reputation Add-on - $10/month

* Reply to reviews from Synoveo
* Manage review responses
* Review analytics

## Business Plan Bundles

Business plan uses a bundle system instead of individual add-ons. Choose the bundle that fits your needs:

### Basic Bundle - Included

Core sync capabilities:

* Business name, address, phone
* Hours and website
* Basic profile sync

### Engagement Bundle - $40/month

Content management for all locations:

* Posts, media, attributes
* Social links
* Full profile editing

### Reputation Bundle - $40/month

Review management for all locations:

* Reply to reviews
* Review tracking
* Response management

### All-In Bundle - $70/month

Everything included:

* All Engagement features
* All Reputation features
* Performance analytics
* Search keyword insights
* Advanced reporting

### Per-Location Customization

Business plan also supports per-location bundle upgrades:

* Tenant bundle is the baseline for all locations
* Individual locations can be upgraded to higher bundles
* Delta pricing: only pay the difference

## Managing Add-ons

### View Current Add-ons

Go to **Settings → Billing → Add-ons** to see:

* Active add-ons
* Cost per add-on
* Total add-on charges

### Remove Add-ons

1. Click the add-on to remove
2. Confirm removal
3. Access removed at end of billing period

### Billing

Add-ons are billed:

* Monthly
* Prorated when added mid-cycle
* On same invoice as base plan

## Cost Examples

| Scenario                      | Calculation     | Total      |
| ----------------------------- | --------------- | ---------- |
| Solo + 2 extra locations      | $12 + (2 × $5)  | $22/month  |
| Solo + Engagement add-on      | $12 + $7        | $19/month  |
| Solo + Both add-ons           | $12 + $7 + $7   | $26/month  |
| Pro + 5 extra locations       | $29 + (5 × $5)  | $54/month  |
| Pro + Reputation add-on       | $29 + $10       | $39/month  |
| Business + 10 extra locations | $79 + (10 × $5) | $129/month |
| Business + All-In Bundle      | $79 + $70       | $149/month |

## API Access

Fetch current add-on pricing:

```bash
curl https://api.synoveo.com/api/v1/config/pricing
```

The response includes add-ons for each plan with prices in cents.

<Cards>
  <Card title="Manage Subscription" href="/docs/billing/manage-subscription" />

  <Card title="Plans Overview" href="/docs/billing/plans-overview" />
</Cards>


# Billing & Subscriptions



Everything you need to know about Synoveo pricing, plans, and billing.

<Callout type="info">
  **New to Synoveo?** Every new user gets a **14-day free Pro trial** with full features. No credit card required. [Learn more](/docs/billing/plans-overview#14-day-pro-trial)
</Callout>

## Plans

| Plan         | Price     | Locations | Best For         |
| ------------ | --------- | --------- | ---------------- |
| **Lite**     | Free      | 1         | Trying Synoveo   |
| **Solo**     | $12/month | 1         | Single location  |
| **Pro**      | $29/month | 3         | Growing business |
| **Business** | $79/month | 10        | Agencies         |

<Card title="Full Plan Details" href="/docs/billing/plans-overview" />

## Quick Links

<Cards>
  <Card title="Plans Overview" href="/docs/billing/plans-overview" />

  <Card title="Plan Features" href="/docs/billing/plan-features" />

  <Card title="Add-ons" href="/docs/billing/add-ons" />

  <Card title="Manage Subscription" href="/docs/billing/manage-subscription" />
</Cards>


# Invoices & History



Access your billing history and download invoices.

## Viewing Invoices

Go to **Settings → Billing → Billing History** to see:

* All past invoices
* Payment status
* Amount charged
* Download links

## Invoice Details

Each invoice shows:

* Invoice number
* Date
* Plan charges
* Add-on charges (if any)
* Tax (if applicable)
* Total amount
* Payment status

## Downloading Invoices

### Single Invoice

1. Find the invoice in Billing History
2. Click "Download PDF"
3. Invoice downloads to your device

### Bulk Download

1. Select date range
2. Click "Download All"
3. ZIP file with all invoices

## Invoice Status

| Status       | Meaning              |
| ------------ | -------------------- |
| **Paid**     | Successfully charged |
| **Pending**  | Payment processing   |
| **Failed**   | Payment failed       |
| **Refunded** | Amount refunded      |

## Payment Receipts

Each successful payment sends an email receipt to your registered email with:

* Payment confirmation
* Amount charged
* Link to download invoice

## Billing Address

To update billing address for invoices:

1. Go to **Settings → Billing → Billing Address**
2. Update company name, address, VAT number
3. Save changes
4. Future invoices use new address

## Refunds

Refund policy:

* Pro-rated for downgrades
* Full refund within 14 days if dissatisfied
* Contact support for refund requests

## Tax Information

### VAT/Sales Tax

* VAT charged for EU customers
* Tax shown separately on invoice
* Enter VAT ID to reverse charge (EU B2B)

### Tax Exempt

Contact support with tax exemption certificate.

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Manage Subscription



Manage your Synoveo subscription from the dashboard.

## Viewing Your Plan

Go to **Settings → Billing** to see:

* Current plan
* Monthly cost
* Included locations
* Used locations
* Renewal date

## Upgrading

<Steps>
  <Step>
    ### Go to Billing

    Navigate to **Settings → Billing**
  </Step>

  <Step>
    ### Click Upgrade

    Click "Upgrade Plan"
  </Step>

  <Step>
    ### Select New Plan

    Choose your new plan
  </Step>

  <Step>
    ### Confirm

    Review changes and confirm
  </Step>
</Steps>

### Upgrade Billing

* Upgrade takes effect immediately
* Current period prorated
* Access new features right away

## Downgrading

<Steps>
  <Step>
    ### Go to Billing

    Navigate to **Settings → Billing**
  </Step>

  <Step>
    ### Click Change Plan

    Click "Change Plan"
  </Step>

  <Step>
    ### Select Lower Plan

    Choose the plan to downgrade to
  </Step>

  <Step>
    ### Confirm

    Review impact and confirm
  </Step>
</Steps>

### Downgrade Impact

* Takes effect at end of billing period
* Excess locations will stop syncing
* Advanced features become unavailable
* Data remains on Google (won't be deleted)

<Callout type="warning">
  Before downgrading, ensure your location count is within the new plan's limit.
</Callout>

## Canceling

### To Cancel

1. Go to **Settings → Billing**
2. Click "Cancel Subscription"
3. Complete cancellation survey (optional)
4. Confirm cancellation

### After Cancellation

* Access continues until period ends
* Account reverts to Lite (free)
* Data remains (not deleted)
* Can resubscribe anytime

## Reactivating

If you canceled:

1. Go to **Settings → Billing**
2. Click "Reactivate"
3. Choose a plan
4. Complete payment
5. Access restored immediately

## Payment Methods

### Update Payment Method

1. Go to **Settings → Billing → Payment Methods**
2. Click "Update"
3. Enter new card details
4. Save

### Supported Methods

* Visa
* Mastercard
* American Express
* Discover

## Billing Issues

### Failed Payment

* Email notification sent
* 7-day grace period
* Update payment method to continue
* Account pauses after grace period

### Disputes

For billing questions:

1. Check **Billing History** for details
2. Contact support with invoice number
3. We'll resolve within 2 business days

<Cards>
  <Card title="Payment Methods" href="/docs/billing/payment-methods" />

  <Card title="Invoices" href="/docs/billing/invoices" />
</Cards>


# Payment Methods



Manage how you pay for your Synoveo subscription.

## Supported Payment Methods

Synoveo accepts:

* **Visa**
* **Mastercard**
* **American Express**
* **Discover**

All payments processed securely through Stripe.

## Adding a Payment Method

<Steps>
  <Step>
    ### Go to Billing

    Navigate to **Settings → Billing → Payment Methods**
  </Step>

  <Step>
    ### Click Add

    Click "Add Payment Method"
  </Step>

  <Step>
    ### Enter Details

    Enter card number, expiration, CVC
  </Step>

  <Step>
    ### Save

    Click "Save Card"
  </Step>
</Steps>

## Updating Payment Method

To update your card:

1. Go to **Settings → Billing → Payment Methods**
2. Click "Update" on your current card
3. Enter new card details
4. Save

Or add a new card and set as default.

## Default Payment Method

Your default card is charged for:

* Monthly subscription
* Add-on purchases
* Plan upgrades

To change default:

1. Add new payment method
2. Click "Set as Default"
3. Old card remains saved (optional)

## Removing a Payment Method

To remove a saved card:

1. Must have another card saved (or cancel subscription)
2. Click "Remove" on the card
3. Confirm removal

<Callout type="warning">
  You must have at least one payment method on file while subscribed.
</Callout>

## Security

Your payment info is:

* Encrypted end-to-end
* Processed by Stripe (PCI compliant)
* Never stored on Synoveo servers
* Protected by fraud detection

## Troubleshooting

### "Card Declined"

* Verify card details are correct
* Check sufficient funds/credit
* Contact your bank if issues persist
* Try a different card

### "Invalid Card"

* Check expiration date
* Verify card number
* Ensure CVC is correct

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Plan Features



Detailed breakdown of features available in each plan.

## Plan Overview

| Plan         | Price     | Locations | Best For                   |
| ------------ | --------- | --------- | -------------------------- |
| **Lite**     | Free      | 1         | Testing & basic sync       |
| **Solo**     | $12/month | 1         | Single location businesses |
| **Pro**      | $29/month | 3         | Growing businesses         |
| **Business** | $79/month | 10        | Agencies & multi-location  |

## Base Capabilities by Plan

| Capability               | Lite          | Solo          | Pro           | Business      |
| ------------------------ | ------------- | ------------- | ------------- | ------------- |
| Basic Sync               | <IconCheck /> | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| Simple Hours             | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| Google Connection        | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| Analytics Dashboard      | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| Reviews Display          | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| Engagement (Posts/Media) | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| All Attributes           | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| Hyper SEO                | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| Lodging Support          | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |

## GBP Fields by Plan

### Lite (9 fields)

Basic business information only:

* `title` - Business name
* `websiteUri` - Website URL
* `phoneNumbers.primaryPhone` - Primary phone
* `storefrontAddress.addressLines` - Street address
* `storefrontAddress.locality` - City
* `storefrontAddress.administrativeArea` - State/Province
* `storefrontAddress.postalCode` - ZIP/Postal code
* `storefrontAddress.regionCode` - Country code
* `regularHours.periods` - Business hours

### Solo (10+ field patterns)

Everything in Lite, plus:

* `phoneNumbers.additionalPhones` - Additional phones
* `storefrontAddress.*` - Full address fields
* `specialHours` - Holiday hours
* `profile.description` - Business description
* `categories.primaryCategory` - Main category
* `categories.additionalCategories` - Secondary categories

### Pro (Full engagement)

Everything in Solo, plus:

* `phoneNumbers.*` - All phone fields
* `regularHours.*` - All hours fields
* `categories.*` - All category fields
* `attributes/*` - All 600+ GBP attributes
* `media/*` - Photo and video uploads
* `localPosts/*` - All post types (updates, offers, events)

### Business (All features)

Everything in Pro, plus bundles for:

* Reviews management
* Performance insights
* Batch operations
* Priority support

## Available Add-ons

### Solo Add-ons

| Add-on     | What It Unlocks                      |
| ---------- | ------------------------------------ |
| Engagement | Posts, media uploads, all attributes |
| Reputation | Review responses and management      |

### Pro Add-ons

| Add-on     | What It Unlocks                 |
| ---------- | ------------------------------- |
| Reputation | Review responses and management |

Note: Pro already includes Engagement features (posts, media, attributes) in the base plan.

### Business Bundles

| Bundle     | What It Includes                          |
| ---------- | ----------------------------------------- |
| Basic      | Core sync features                        |
| Engagement | Posts, media, attributes, social links    |
| Reputation | Reviews management and responses          |
| All-In     | Everything including insights & analytics |

## Feature Details

### Basic Sync

Sync core business information from WordPress to Google Business Profile:

* Business name, address, phone
* Website URL
* Business hours

### Reviews Display (Solo+)

View and display reviews on your website. Read-only access to reviews through the dashboard and WordPress shortcodes.

### Engagement Features (Pro+)

Full content management:

* Create and publish GBP posts (updates, offers, events)
* Upload photos and videos
* Manage all 600+ category-specific attributes
* Social media links

### Reviews Management (Add-on)

Reply to customer reviews directly from Synoveo:

* Respond to positive and negative reviews
* Track review sentiment
* Manage review responses at scale

### Analytics (Business All-In)

Advanced performance tracking:

* Search keyword analysis
* Customer action metrics
* Performance trends
* Competitive insights

<Cards>
  <Card title="Add-ons" href="/docs/billing/add-ons" />

  <Card title="Upgrade Plan" href="/docs/billing/manage-subscription" />
</Cards>


# Plans Overview



Synoveo offers location-based pricing that scales with your business.

## Pricing Model

You pay per **location** you sync, not per domain or user:

* Each plan includes a set number of locations
* Add extra locations with add-ons ($5/month each)
* Unlimited WordPress sites per location
* Connect from any platform (WordPress, Shopify, custom SDK)

## Plans

### Lite - Free Forever

* **1 location included**
* Basic business info sync (9 fields)
* Name, address, phone, hours, website
* Perfect for trying Synoveo

### Solo - $12/month

* **1 location included**
* Extended profile management
* Description and categories
* Special/holiday hours
* Reviews display (read-only via shortcodes)
* Analytics dashboard
* Ideal for single-location businesses

**Optional Add-ons:**

* Engagement: Posts, media, all attributes
* Reputation: Review replies and management

### Pro - $29/month

* **3 locations included**
* Full engagement features included
* Local Posts (updates, events, offers)
* Media and photo upload
* All 600+ category attributes
* Hyper SEO optimization
* Lodging support (hotels, B\&Bs)
* Reviews display (read-only)
* Great for growing businesses

**Optional Add-on:**

* Reputation: Review replies and management

### Business - $79/month

* **10 locations included**
* Choose from capability bundles:
  * **Basic**: Core sync features
  * **Engagement**: Posts, media, attributes
  * **Reputation**: Review management
  * **All-In**: Everything plus analytics and insights
* Per-location customization
* Priority support
* Built for agencies

## Need More Locations?

Add extra locations to any paid plan:

* **$5/month per additional location**
* No limit on add-ons
* Added immediately
* Not available on Lite plan

## 14-Day Pro Trial

Every new user gets a **14-day free trial** with full Pro features:

* Starts automatically at first login
* Full Pro access (posts, media, 600+ attributes)
* 3 locations included during trial
* No credit card required

### During Trial

* Create and sync GBP posts
* Upload photos and media
* Manage all GBP attributes
* Display reviews on your site

### Trial Expiration

* Email reminders at day 3, 7, 10, and 13
* 24-hour grace period after day 14
* Automatic downgrade to Lite if not subscribed
* Your data stays on Google (nothing deleted)

## FAQ

### Can I switch plans?

Yes, upgrade or downgrade anytime. Changes are prorated.

### What if I downgrade?

Fields not included in your new plan won't sync, but existing data stays on Google.

### Is there a free trial?

Yes! Every new user gets a 14-day Pro trial with full features. After the trial, you can subscribe or continue with the free Lite plan.

### What's the difference between Solo and Pro?

Solo includes profile editing (description, categories, hours). Pro adds engagement features (posts, media, attributes) that help you actively promote your business on Google.

### Do I need the Reputation add-on?

Only if you want to reply to reviews from within Synoveo. All plans from Solo onwards can display reviews on your website.

### Annual billing?

Coming soon. Contact us for enterprise pricing.

<Cards>
  <Card title="Feature Comparison" href="/docs/billing/plan-features" />

  <Card title="Add-ons" href="/docs/billing/add-ons" />
</Cards>


# API Keys









import { Callout } from 'fumadocs-ui/components/callout'
import { Steps, Step } from 'fumadocs-ui/components/steps'

API keys authenticate your platforms (WordPress, custom apps) with Synoveo. Each key is scoped to a specific location and domain.

## Prerequisites

Before creating an API key:

* <IconCheck /> **Location sync enabled** — The location must have sync turned ON in the Locations page
* <IconCheck /> **Verified Google location** — The location must be verified on Google Business Profile

## Creating an API Key

<Steps>
  <Step>
    ### Navigate to API Keys

    Go to **API Keys** in the dashboard sidebar and click **Create API Key**.

        <img alt="Create API Key" src={__img0} placeholder="blur" />
  </Step>

  <Step>
    ### Configure the Key

    Fill in the required fields:

    | Field        | Description                                       |
    | ------------ | ------------------------------------------------- |
    | **Platform** | Select your platform (WordPress, Custom, etc.)    |
    | **Location** | Choose which Google location this key connects to |
    | **Domain**   | Your website URL (e.g., `https://example.com`)    |

    <Callout type="info">
      Only locations with sync enabled appear in the dropdown.
    </Callout>
  </Step>

  <Step>
    ### Confirm Creation

    Review your configuration and click **Create**.

        <img alt="Confirm API Key creation" src={__img1} placeholder="blur" />
  </Step>

  <Step>
    ### Copy Your Credentials

    Copy both the **Client ID** and **Client Secret**.

        <img alt="Copy credentials" src={__img2} placeholder="blur" />

    <Callout type="warning">
      **Save your Client Secret now** — it's only shown once! If you lose it, you'll need to create a new API key.
    </Callout>
  </Step>
</Steps>

## Managing API Keys

### Viewing Keys

The API Keys page shows all your keys with:

* Platform type
* Associated location
* Domain
* Creation date
* Status (active/revoked)

### Revoking a Key

To revoke an API key:

1. Find the key in the list
2. Click the **Revoke** button
3. Confirm the action

<Callout type="warning">
  Revoking a key immediately disconnects the associated platform. The platform will need a new key to reconnect.
</Callout>

## Using API Keys

### WordPress

Enter your Client ID and Client Secret in **Synoveo → Dashboard** in your WordPress admin.

See [WordPress Quick Start](/docs/getting-started/platforms/wordpress) for detailed setup.

### Custom Integrations

Use the credentials with the Synoveo API:

```bash
curl -X POST https://api.synoveo.com/v1/sync \
  -H "X-Client-ID: your_client_id" \
  -H "X-Client-Secret: your_client_secret" \
  -H "Content-Type: application/json" \
  -d '{"fields": {...}}'
```

## Troubleshooting

### "Location not available"

The location doesn't appear in the dropdown:

* Ensure sync is enabled for the location in the Locations page
* Verify the location is verified on Google

### "Domain mismatch"

The API key was created for a different domain:

* Create a new key with the correct domain
* Or update your site URL to match

### "Invalid credentials"

The Client ID or Secret is incorrect:

* Double-check both values
* Ensure no extra spaces when copying
* If lost, create a new API key

<Cards>
  <Card title="Locations" href="/docs/dashboard/locations" />

  <Card title="WordPress Setup" href="/docs/getting-started/platforms/wordpress" />

  <Card title="Sync Center" href="/docs/dashboard/sync-center" />
</Cards>


# Dashboard Guide



The Synoveo dashboard provides a complete interface for managing your Google Business Profile locations.

## Dashboard Overview

<Cards>
  <Card title="Personal Dashboard" description="For solo users with 1-3 locations" href="/docs/dashboard/overview" />

  <Card title="Agency Dashboard" description="For agencies managing 10+ locations" href="/docs/agency" />
</Cards>

## Key Features

* **Location Management** - View, assign, and configure Google locations
* **Profile Optimizer** - Track completeness and get recommendations
* **Sync Center** - Monitor sync operations and history
* **Reviews** - Read and respond to customer reviews
* **Posts** - Create and manage Google posts, media, and action links
* **Performance** - Track metrics and insights

## Quick Navigation

<Cards>
  <Card title="Manage Locations" href="/docs/dashboard/locations" />

  <Card title="Profile Optimizer" href="/docs/dashboard/profile-health" />

  <Card title="Respond to Reviews" href="/docs/dashboard/reviews" />

  <Card title="Create Posts" href="/docs/dashboard/local-posts" />
</Cards>


# Posts (Marketing Hub)



Create engaging posts to appear on your Google Business Profile and in search results.

<Callout type="info">
  Access the Marketing Hub via **Posts** in the sidebar. Posts require Pro plan or higher.
</Callout>

## Post Types

Google supports several post types:

### Update (What's New)

General updates about your business:

* News and announcements
* Tips and insights
* Behind-the-scenes content

### Event

Promote upcoming events:

* Event title and description
* Start and end date/time
* Location (optional)
* Call-to-action

### Offer

Share deals and promotions:

* Offer details
* Start and end date
* Coupon code (optional)
* Terms and conditions

### Product

Highlight specific products:

* Product name
* Description
* Price (optional)
* Category

## Creating a Post

<Steps>
  <Step>
    ### Select Location

    Choose which location to post to
  </Step>

  <Step>
    ### Choose Post Type

    Select Update, Event, Offer, or Product
  </Step>

  <Step>
    ### Add Content

    Write your post text (up to 1500 characters)
  </Step>

  <Step>
    ### Add Media

    Upload a photo (recommended: 1200x900px)
  </Step>

  <Step>
    ### Add Call-to-Action

    Optional button: Learn More, Sign Up, Book, etc.
  </Step>

  <Step>
    ### Publish

    Post immediately or schedule for later
  </Step>
</Steps>

## Post Guidelines

### Content

* Keep it relevant and valuable
* Use clear, concise language
* Include a call-to-action
* No contact info in post text (use CTA instead)

### Images

* Minimum: 400x300 pixels
* Recommended: 1200x900 pixels
* Format: JPG or PNG
* No text overlays covering key content

### Timing

* Posts stay visible for 7 days (Updates)
* Events/Offers visible until end date
* Post regularly to stay visible

## Managing Posts

### View All Posts

See all posts across locations:

* Status (published, scheduled, expired)
* Engagement metrics
* Edit or delete options

### Edit Posts

Click a post to edit:

* Update content
* Change image
* Modify CTA
* Change dates (Events/Offers)

### Delete Posts

Remove posts that are no longer relevant.

## Post Analytics

Track post performance:

* **Views** - How many saw the post
* **Clicks** - CTA button clicks
* **Engagement** - Interaction rate

## Scheduling

Schedule posts for future publication:

1. Create your post
2. Click "Schedule" instead of "Publish"
3. Select date and time
4. Post will auto-publish

## Bulk Posting

For agencies with multiple locations:

1. Create post content
2. Select multiple locations
3. Post to all at once

<Callout type="warning">
  Be mindful of location-specific details when bulk posting.
</Callout>

<Cards>
  <Card title="Auto-Post from WordPress" href="/docs/wordpress/auto-post" />

  <Card title="Reviews Management" href="/docs/dashboard/reviews" />
</Cards>


# Managing Locations



The Locations page is where you manage your Google Business Profile locations.

## Viewing Locations

After connecting your Google account, you'll see all accessible locations organized by:

* **Google Groups** - How they're organized in GBP
* **Assignment Status** - Assigned or unassigned
* **Verification Status** - Verified or pending

### Location Groups

Locations appear in collapsible groups matching your Google Business Profile organization:

* "Premium Clients"
* "Standard Clients"
* etc.

### Filtering

Use the toggle to show:

* **All locations** - See everything in groups
* **Unassigned only** - Focus on locations needing assignment

## Assigning Locations

Before syncing, assign locations to a Synoveo business:

<Steps>
  <Step>
    ### Select Location

    Click on an unassigned location
  </Step>

  <Step>
    ### Choose Business

    Select an existing business or create new
  </Step>

  <Step>
    ### Confirm

    Click "Assign" to complete
  </Step>
</Steps>

### Why Assign?

Assignment links a Google location to your Synoveo business for:

* API key generation
* Billing tracking
* Sync configuration

## Enabling Sync

Once assigned, enable sync for each location:

<Steps>
  <Step>
    ### Verify Location

    Location must be verified in Google (green checkmark)
  </Step>

  <Step>
    ### Toggle Sync

    Click the "Sync Enabled" toggle to ON
  </Step>

  <Step>
    ### Confirm

    Location is now ready to receive sync data
  </Step>
</Steps>

<Callout type="warning">
  Only verified Google Business Profile locations can have sync enabled.
</Callout>

## Location Details

Click a location to see:

* **Basic Info** - Name, address, phone
* **Verification Status** - Verified, pending, or action needed
* **Sync Status** - Enabled, disabled, last sync
* **Assignment** - Which business manages this location
* **API Keys** - Keys configured for this location

## Verification

### Check Verification Status

If a location shows as unverified:

1. Click the location
2. Click "Check Verification Status"
3. Synoveo will query Google for the latest status

### Complete Verification

To verify a location:

1. Go to [Google Business Profile Manager](https://business.google.com)
2. Select the location
3. Follow Google's verification process
4. Return to Synoveo and refresh status

## Troubleshooting

### "Location not showing"

* Verify you have Owner/Manager access in Google
* Try "Refresh Locations" button
* Recently added locations may take a few minutes

### "Can't enable sync"

* Location must be verified first
* Check verification status in Google

### "Location in wrong group"

* Groups are imported from Google
* Reorganize in Google Business Profile Manager

<Cards>
  <Card title="Profile Optimizer" href="/docs/dashboard/profile-health" />

  <Card title="Sync Center" href="/docs/dashboard/sync-center" />
</Cards>


# Media Management



Manage your Google Business Profile photos directly from the Synoveo dashboard.

<Callout type="info">
  Access media management via the **Posts** menu in the sidebar, then click the **Media** tab. Requires Pro plan or higher.
</Callout>

## Photo Categories

Google organizes photos by category:

| Category         | Description                 |
| ---------------- | --------------------------- |
| **Logo**         | Your business logo (square) |
| **Cover**        | Main banner image           |
| **Interior**     | Inside your business        |
| **Exterior**     | Outside your business       |
| **Product**      | Products you sell           |
| **At Work**      | Team members working        |
| **Food & Drink** | Menu items (restaurants)    |
| **Team**         | Staff photos                |
| **Additional**   | Other relevant images       |

## Uploading Photos

<Steps>
  <Step>
    ### Select Location

    Choose which location to add photos to
  </Step>

  <Step>
    ### Click Upload

    Click the "Upload Photos" button
  </Step>

  <Step>
    ### Select Files

    Choose images from your device
  </Step>

  <Step>
    ### Set Category

    Assign each photo to a category
  </Step>

  <Step>
    ### Upload

    Click "Upload" to send to Google
  </Step>
</Steps>

## Photo Guidelines

### Technical Requirements

* **Format**: JPG or PNG
* **Size**: 10KB - 5MB
* **Resolution**: 720x720 minimum
* **Aspect ratio**: Varies by category

### Category-Specific Sizes

| Category          | Recommended Size |
| ----------------- | ---------------- |
| Logo              | 720x720 (square) |
| Cover             | 1080x608 (16:9)  |
| Interior/Exterior | 720x540 (4:3)    |
| Products          | 720x720 (square) |

### Content Guidelines

* High quality, well-lit
* Represent your actual business
* No stock photos
* No text overlays
* No promotional content

## Managing Photos

### View Gallery

See all photos for a location organized by category.

### Reorder Photos

Drag and drop to set display order within categories.

### Set Primary

Click "Set as Primary" to make a photo the main image for its category.

### Delete Photos

Select and delete photos you no longer want.

## Photo Analytics

Track photo performance:

* **Views** - How many saw the photo
* **Customer photos** - User-submitted images
* **Photo count** - Total photos by category

## Customer Photos

Customers can upload photos to your profile:

* View in the "Customer Photos" tab
* Cannot delete (Google policy)
* Can report inappropriate photos

## Best Practices

1. **Upload quality images** - Professional if possible
2. **Cover all categories** - Complete your gallery
3. **Update regularly** - Add new photos periodically
4. **Show your best** - First impressions matter
5. **Be authentic** - Real photos of your business

## Troubleshooting

### "Upload failed"

* Check file size (max 5MB)
* Verify format (JPG/PNG only)
* Try a different image

### "Photo not showing"

* Allow up to 24 hours for Google processing
* Refresh your browser
* Check Google Business Profile directly

<Cards>
  <Card title="Performance Insights" href="/docs/dashboard/performance" />

  <Card title="Profile Fields" href="/docs/gbp/profile-fields" />
</Cards>


# Dashboard Overview



The Synoveo dashboard is your central hub for managing Google Business Profile locations.

## Dashboard Types

Synoveo provides two dashboard views based on your needs:

### Personal Dashboard

For users with 1-3 locations:

* Single location focus
* Simplified navigation
* Quick actions for common tasks

### Agency Dashboard

For users with 4+ locations:

* Multi-location overview
* Bulk operations
* Location grouping and filtering

<Callout type="info">
  The dashboard automatically switches based on your location count. You can manually switch via Settings.
</Callout>

## Navigation

### Sidebar Menu

The dashboard sidebar is organized into sections:

**Google Business Profile**

* **Locations** - View and manage Google Business locations
* **Sync Center** - Sync history and current status
* **Profile Optimizer** - Completeness scores and recommendations

**Content & Reviews**

* **Posts** - Posts, media, and action links (Marketing Hub)
* **Reviews** - Customer reviews and responses

**Analytics**

* **Performance** - Analytics and insights
* **Usage & Quotas** - Track your plan usage

**Integrations**

* **Platforms** - Connected platforms (WordPress, etc.)
* **API Keys** - Manage API credentials

**Account & Billing**

* **Subscription** - Current plan details
* **Compare Plans** - View available plans
* **Billing & Invoices** - Payment history
* **Payment Methods** - Manage cards

### Top Bar

* **Search** - Find locations quickly
* **Notifications** - Alerts and updates
* **Account** - Profile and logout

## Key Metrics

The dashboard home shows:

* **Locations** - Connected and syncing
* **Profile Score** - Average optimization score across locations
* **Pending Reviews** - Reviews awaiting response
* **Recent Syncs** - Last sync status

## Getting Started

1. Connect your Google account
2. Assign locations to your business
3. Enable sync for verified locations
4. Start managing!

<Cards>
  <Card title="Manage Locations" href="/docs/dashboard/locations" />

  <Card title="Profile Optimizer" href="/docs/dashboard/profile-health" />
</Cards>


# Performance & Insights



Monitor how customers find and interact with your Google Business Profile.

<Callout type="info">
  Performance insights require Business plan.
</Callout>

## Available Metrics

### Discovery Metrics

* **Search views** - Profile views from Google Search
* **Maps views** - Profile views from Google Maps
* **Total views** - Combined search and maps

### Customer Actions

* **Website clicks** - Clicks to your website
* **Direction requests** - Requests for directions
* **Phone calls** - Calls initiated from profile
* **Messages** - Messages sent (if enabled)

### Search Queries

* **Keywords** - What customers searched to find you
* **Query volume** - How often each term was searched
* **Trending** - Rising search terms

## Viewing Insights

### Time Range

Select a date range:

* Last 7 days
* Last 30 days
* Last 90 days
* Custom range

### Location Filter

View for:

* Single location
* All locations combined
* Compare locations

## Understanding Metrics

### Search Views

How often your profile appeared in Google Search:

* Direct searches (your business name)
* Discovery searches (category/keyword)
* Branded searches (related brand terms)

### Actions

What customers did after finding you:

* Most valuable: calls and direction requests
* Website clicks show interest
* Low actions may indicate incomplete profile

### Search Keywords

What customers typed to find you:

* Use to optimize your profile
* Add keywords to description
* Ensure categories match search intent

## Charts & Trends

### Performance Over Time

Line chart showing metrics over your selected period:

* Identify trends
* Spot unusual spikes
* Compare periods

### Location Comparison

Bar chart comparing metrics across locations:

* Identify top performers
* Find underperforming locations
* Allocate resources appropriately

## Exporting Data

Export metrics for reporting:

1. Select date range and locations
2. Click "Export"
3. Download CSV or PDF

## Best Practices

1. **Check weekly** - Monitor trends regularly
2. **Compare periods** - Look for growth/decline
3. **Act on keywords** - Optimize for top searches
4. **Improve low actions** - Update profile if actions are low
5. **Respond to trends** - Adjust marketing based on data

## Limitations

<Callout type="warning">
  Google aggregates some metrics for privacy. Very low numbers may show as ranges.
</Callout>

* Data may have 48-72 hour delay
* Some metrics unavailable for new profiles
* Google occasionally changes available metrics

<Cards>
  <Card title="Profile Optimizer" href="/docs/dashboard/profile-health" />

  <Card title="Subscription" href="/docs/billing/manage-subscription" />
</Cards>


# Profile Optimizer



The **Profile Optimizer** shows how complete your Google Business Profile is and provides recommendations for improvement.

## Health Score

Each location receives a score from 0-100%:

* **90-100%** - Excellent - Profile is well optimized
* **70-89%** - Good - Minor improvements possible
* **50-69%** - Fair - Several fields missing
* **Below 50%** - Needs work - Many fields incomplete

## Score Calculation

The score is calculated based on:

* **Required fields** - Essential business info
* **Recommended fields** - Important for visibility
* **Optional fields** - Nice to have

### Field Weights

| Field Category   | Weight |
| ---------------- | ------ |
| Business name    | 15%    |
| Address          | 15%    |
| Phone number     | 10%    |
| Hours            | 10%    |
| Categories       | 10%    |
| Description      | 10%    |
| Photos           | 10%    |
| Attributes       | 10%    |
| Reviews (recent) | 10%    |

## Quick Wins

The Profile Optimizer highlights "Quick Wins" - easy improvements with high impact:

* Add missing phone number
* Upload a logo photo
* Add business description
* Set special hours for holidays

Click a Quick Win to navigate directly to that field.

## Field Breakdown

View detailed field status:

* <IconCheck /> **Complete** - Field has value
* <IconWarning /> **Partial** - Field could be improved
* <IconX /> **Missing** - Field not set

## Alerts

The Profile Optimizer alerts you to issues:

* **Missing required fields** - Business won't rank well
* **Outdated hours** - Holiday hours not set
* **No recent posts** - Profile looks inactive
* **Unanswered reviews** - Customer engagement opportunity

## Improving Your Score

<Steps>
  <Step>
    ### Review Quick Wins

    Start with the easiest improvements
  </Step>

  <Step>
    ### Complete Required Fields

    Ensure all essential info is present
  </Step>

  <Step>
    ### Add Photos

    Upload quality images of your business
  </Step>

  <Step>
    ### Update Regularly

    Keep info current, respond to reviews
  </Step>
</Steps>

## Tracking Progress

The health score updates after each sync. Track improvement over time in the history chart.

<Cards>
  <Card title="Sync Center" href="/docs/dashboard/sync-center" />

  <Card title="Google Business Profile Fields" href="/docs/gbp/profile-fields" />
</Cards>


# Reviews Management



Manage your Google Business Profile reviews directly from the Synoveo dashboard.

<Callout type="info">
  Reviews management requires Pro plan or higher.
</Callout>

## Viewing Reviews

The Reviews page shows all reviews across your locations:

* **Star rating** - 1-5 stars
* **Reviewer name** - Customer's display name
* **Review text** - Full review content
* **Date** - When the review was posted
* **Response status** - Replied or pending

### Filtering

Filter reviews by:

* **Location** - Specific location or all
* **Rating** - Star rating range
* **Status** - Responded, pending, or all
* **Date** - Time period

### Sorting

Sort by:

* Newest first
* Oldest first
* Highest rating
* Lowest rating
* Pending response

## Responding to Reviews

<Steps>
  <Step>
    ### Select Review

    Click on a review to expand
  </Step>

  <Step>
    ### Write Response

    Enter your reply in the text box
  </Step>

  <Step>
    ### Submit

    Click "Post Reply" to publish
  </Step>
</Steps>

### Response Tips

* **Respond quickly** - Within 24-48 hours
* **Be professional** - Even to negative reviews
* **Thank customers** - Show appreciation
* **Address concerns** - Don't be defensive
* **Keep it brief** - 2-3 sentences usually enough

### Response Templates

Save time with templates:

1. Go to **Settings → Review Templates**
2. Create templates for common scenarios
3. Insert with one click when responding

Example templates:

* Thank you for positive review
* Addressing negative feedback
* Inviting customer to return

## Review Analytics

Track review performance:

* **Average rating** - Overall and by location
* **Review count** - Total and period-based
* **Response rate** - % of reviews responded to
* **Response time** - Average time to respond

## Notifications

Get notified of new reviews:

* **In-app** - Dashboard notifications
* **Email** - Configurable alerts

Configure in **Settings → Notifications**.

## Best Practices

1. **Respond to all reviews** - Good and bad
2. **Personalize responses** - Mention specifics
3. **Keep calm with negatives** - Take offline if needed
4. **Encourage reviews** - Ask satisfied customers
5. **Monitor regularly** - Check daily or weekly

## Troubleshooting

### "Can't see reviews"

* Verify Pro plan or higher
* Check location is connected
* Reviews may take time to sync from Google

### "Response failed to post"

* Check internet connection
* Verify OAuth connection is active
* Try reconnecting Google account

<Cards>
  <Card title="Posts & Media" href="/docs/dashboard/local-posts" />

  <Card title="Performance Insights" href="/docs/dashboard/performance" />
</Cards>


# Account Settings



Manage your account settings, notifications, and preferences.

<Callout type="info">
  Account settings are distributed across the **Account & Billing** section in the sidebar: **Subscription**, **Compare Plans**, **Billing & Invoices**, and **Payment Methods**.
</Callout>

## Account Settings

### Profile

Update your account information:

* Email address
* Display name
* Password (via email reset)

### Plan

View your current plan and limits:

* Plan type (Lite, Solo, Pro, Business)
* Locations included/used
* Feature access
* Upgrade options

### Billing

Manage payment and subscriptions:

* Current payment method
* Billing history
* Invoice download

<Card title="Billing Guide" href="/docs/billing" />

## Notification Settings

Configure how you receive alerts:

### Email Notifications

* **New reviews** - When customers leave reviews
* **Sync failures** - When sync operations fail
* **Quota warnings** - Approaching limits
* **Product updates** - New features and changes

### In-App Notifications

* **Real-time alerts** - Immediate dashboard alerts
* **Notification center** - Aggregated notifications

## API Keys

Manage API credentials via **API Keys** in the Integrations section of the sidebar:

* View existing keys
* Create new keys
* Revoke keys
* Track key usage

<Card title="API Keys Guide" href="/api-reference/authentication/api-keys" />

## Connected Accounts

### Google Connection

* View connected Google account
* Reconnect if needed
* Disconnect (removes all locations)

<Callout type="warning">
  Disconnecting Google will remove all locations from Synoveo but won't affect your actual Google Business Profile.
</Callout>

## Data & Privacy

### Export Data

Download all your data:

1. Click "Export My Data"
2. Receive email with download link
3. Download ZIP with your data

### Delete Account

Permanently delete your Synoveo account:

1. Click "Delete Account"
2. Confirm via email
3. Account deleted within 30 days

<Callout type="error">
  Account deletion is permanent. All data, settings, and history will be removed.
</Callout>

## Advanced Settings

### Debug Mode

Enable verbose logging for troubleshooting:

* View detailed API requests
* See sync operation details
* Download debug logs

### Dashboard View

Toggle between dashboard views:

* Personal (simple)
* Agency (advanced)

### Timezone

Set your preferred timezone for:

* Scheduled posts
* Sync times
* Report dates

<Cards>
  <Card title="Getting Started" href="/docs/getting-started" />

  <Card title="Contact Support" href="/docs/troubleshooting/contact-support" />
</Cards>


# Sync Center



import { Callout } from 'fumadocs-ui/components/callout'
import { Cards, Card } from 'fumadocs-ui/components/card'

The Sync Center is your control panel for managing data synchronization between WordPress and Google Business Profile.

<Callout type="info">
  **New to syncing?** See the [Sync Quickstart](/docs/guides/sync-quickstart) or [Complete Sync Guide](/docs/guides/sync-complete-guide).
</Callout>

## Accessing Sync Center

Navigate to **Sync Center** in the dashboard sidebar (under Google Business Profile section).

## Location Selector

Select which location to manage using the dropdown at the top of the page.

**Requirements:**

* Location must have an API key assigned
* Location must be verified on Google

## Tabs Overview

### Google Business Profile Tab

Displays current data on your Google Business Profile:

* Business information (name, phone, address)
* Opening hours
* Categories
* Attributes
* Description

**Actions:**

* **Refresh** — Pull latest data from Google

### Source Tab (e.g., WordPress)

Configure which plugin fields map to GBP fields:

* Select source for each GBP field
* Preview current values
* Confirm mappings

**Actions:**

* **Refresh All Previews** — Fetch latest values from all sources
* **Confirm** — Save individual field mapping

### Delta Tab

Compare and sync data:

* View differences between source and Google
* Select fields to sync
* Choose sync direction
* Execute sync

**Sync Modes:**

* **Sync All** — Bulk sync all different fields
* **Per Field** — Select individual fields

**Sync Directions:**

* **Source → Google** — Push to Google
* **Google → Source** — Pull from Google

## Status Indicators

| Status    | Icon            | Meaning               |
| --------- | --------------- | --------------------- |
| Match     | <IconCheck />   | Values are identical  |
| Different | <IconWarning /> | Values differ         |
| New       | <IconSync />    | Only exists in source |
| Locked    | <IconX />       | Requires plan upgrade |

## Sync Progress

When syncing, a progress overlay shows:

1. **Syncing** — Sending data to Google
2. **Refreshing** — Updating cached data
3. **Done** — Sync complete

## Related

<Cards>
  <Card title="Sync Quickstart" href="/docs/guides/sync-quickstart" />

  <Card title="Complete Sync Guide" href="/docs/guides/sync-complete-guide" />

  <Card title="Sync Troubleshooting" href="/docs/troubleshooting/sync-failures" />
</Cards>


# GBP Best Practices



Best practices for getting the most out of your Google Business Profile.

## Profile Optimization

### Complete Every Field

* Fill all available fields
* More complete = higher ranking
* Use Synoveo's Profile Optimizer to track

### Accurate Information

* Verify NAP (Name, Address, Phone)
* Match your website exactly
* Update immediately when things change

### Choose Categories Wisely

* Primary category most important
* Add relevant secondary categories
* Don't over-categorize

### Write a Great Description

* First 250 characters most important
* Include keywords naturally
* Describe what makes you unique
* No promotional language

## Visual Content

### Photo Best Practices

* High quality (no blurry images)
* Well lit
* Show real business (no stock photos)
* Update regularly
* Cover all categories

### Minimum Photos

* Logo
* Cover photo
* 3+ interior
* 3+ exterior
* Team photos
* Product photos

## Reviews

### Getting Reviews

* Ask satisfied customers
* Make it easy (direct link)
* Respond to all reviews
* Never buy or fake reviews

### Responding to Reviews

```
Positive: "Thank you [Name] for the kind words!
We're so glad you enjoyed [specific thing].
See you again soon!"

Negative: "Thank you for your feedback [Name].
We're sorry to hear about [issue].
Please contact us at [email] so we can make this right."
```

## Posts

### Posting Schedule

* At least weekly
* More frequent is better
* Consistent timing

### Post Content Ideas

* New products/services
* Behind the scenes
* Tips related to your industry
* Special offers
* Events
* Team spotlights

### Post Format

* Compelling image
* Clear headline
* Brief description
* Strong call-to-action

## Q\&A

### Proactive Q\&A

Add common questions yourself:

* Business hours questions
* Service details
* Policies
* Directions/parking

### Monitor & Respond

* Check weekly
* Answer quickly
* Be helpful and accurate

## Technical

### Google Updates

* Check profile monthly for Google-suggested edits
* Accept or reject promptly
* Dispute incorrect changes

### Duplicate Listings

* Search for duplicates
* Report and request removal
* Maintain one authoritative listing

### Consistency

* Same info everywhere online
* Citations, directories, social
* Inconsistency hurts ranking

## Measuring Success

Track these metrics:

* Search impressions
* Customer actions
* Website clicks
* Direction requests
* Phone calls
* Photo views

<Card title="Performance Insights" href="/docs/dashboard/performance" />


# Content Types



Google Business Profile supports various content types to engage customers.

## Local Posts

Posts appear on your profile and in search results.

### Update (What's New)

General updates about your business:

* News and announcements
* Tips and insights
* Behind-the-scenes
* Lasts 7 days

### Event

Promote upcoming events:

* Event title
* Date and time
* Description
* Call-to-action
* Visible until event ends

### Offer

Special deals and promotions:

* Offer details
* Start/end dates
* Coupon code (optional)
* Terms
* Visible until offer ends

### Product

Highlight specific products:

* Product name
* Description
* Price
* Category
* Stays visible

## Photos & Videos

### Photo Categories

* **Logo** - Square business logo
* **Cover** - Banner image (1080x608)
* **Interior** - Inside photos
* **Exterior** - Outside photos
* **Products** - What you sell
* **Team** - Staff photos
* **At Work** - Action shots

### Video Guidelines

* Max 30 seconds
* Max 75MB
* 720p minimum
* Landscape preferred

## Reviews

Customer reviews include:

* Star rating (1-5)
* Text review
* Photos (customer uploaded)
* Owner response

### Responding to Reviews

* Reply to all reviews
* Thank positive reviewers
* Address negative feedback professionally
* Keep responses brief

## Q\&A

Questions from customers:

* Anyone can ask
* Anyone can answer (including you!)
* Your answers appear first
* Build FAQ proactively

### Proactive Q\&A

Add your own Q\&A:

1. Ask common questions
2. Provide authoritative answers
3. Upvote your answers

## Messaging

Direct messaging with customers:

* Real-time chat
* Requires enabling in GBP
* Quick responses improve ranking

## Booking

Booking integration:

* Book appointments
* Reserve tables
* Purchase tickets
* Requires booking partner integration

<Cards>
  <Card title="Best Practices" href="/docs/gbp/best-practices" />

  <Card title="Local Posts Guide" href="/docs/dashboard/local-posts" />
</Cards>


# Google Business Profile



Learn about Google Business Profile and how to optimize it with Synoveo.

## What is Google Business Profile?

Google Business Profile (GBP) is Google's free tool for managing how your business appears on Google Search and Maps. It includes:

* Business information (name, address, hours)
* Photos and videos
* Customer reviews
* Posts and updates
* Q\&A section
* Performance insights

## How Synoveo Helps

Synoveo automates GBP management by:

* Syncing data from your platforms
* Managing posts and content
* Tracking profile health
* Responding to reviews
* Providing analytics

## Quick Links

<Cards>
  <Card title="Understanding GBP" href="/docs/gbp/understanding-gbp" />

  <Card title="Verification" href="/docs/gbp/verification" />

  <Card title="Profile Fields" href="/docs/gbp/profile-fields" />

  <Card title="Content Types" href="/docs/gbp/content-types" />

  <Card title="Best Practices" href="/docs/gbp/best-practices" />
</Cards>


# Profile Fields



Google Business Profile includes hundreds of fields. Here's what you can manage with Synoveo.

## Basic Information

| Field               | Description      | Plans |
| ------------------- | ---------------- | ----- |
| `title`             | Business name    | All   |
| `storefrontAddress` | Physical address | All   |
| `phoneNumbers`      | Phone numbers    | All   |
| `websiteUri`        | Website URL      | All   |
| `regularHours`      | Standard hours   | All   |
| `specialHours`      | Holiday hours    | Solo+ |

## Profile Details

| Field                 | Description                     | Plans |
| --------------------- | ------------------------------- | ----- |
| `profile.description` | Business description            | Solo+ |
| `categories`          | Primary & additional categories | Solo+ |
| `openInfo`            | Open/closed status              | Solo+ |
| `serviceArea`         | Service area (if applicable)    | Solo+ |

## Attributes

Attributes are category-specific features. Examples:

### General

* Wheelchair accessible
* WiFi available
* Parking options

### Restaurants

* Dine-in, takeout, delivery
* Cuisine type
* Price range

### Hotels

* Pool, spa, fitness center
* Room amenities
* Star rating

<Callout type="info">
  There are 600+ possible attributes. Available attributes depend on your business category.
</Callout>

## Services

| Field          | Description        | Plans |
| -------------- | ------------------ | ----- |
| `serviceItems` | Services offered   | Solo+ |
| `serviceType`  | Service categories | Solo+ |

## Media

| Field        | Description   | Plans |
| ------------ | ------------- | ----- |
| `logo`       | Business logo | Pro+  |
| `coverPhoto` | Cover image   | Pro+  |
| `photos`     | Photo gallery | Pro+  |
| `videos`     | Video content | Pro+  |

## Content

| Field        | Description             | Plans |
| ------------ | ----------------------- | ----- |
| `localPosts` | Updates, events, offers | Pro+  |
| `products`   | Product catalog         | Pro+  |

## Customer Interaction

| Field       | Description      | Plans             |
| ----------- | ---------------- | ----------------- |
| `reviews`   | Customer reviews | Pro+ (read/reply) |
| `questions` | Q\&A section     | Pro+              |

## Insights (Business Plan)

| Field               | Description               |
| ------------------- | ------------------------- |
| `searchViews`       | Profile views from search |
| `mapsViews`         | Profile views from maps   |
| `websiteClicks`     | Clicks to website         |
| `directionRequests` | Direction requests        |
| `phoneCalls`        | Calls from profile        |
| `searchQueries`     | Keywords used to find you |

## Field Categories by Plan

### Lite (9 fields)

Basic business identity and contact info.

### Solo (14 fields)

* Description, categories, services.

### Pro (150+ fields)

* All engagement features, all attributes.

### Business (200+ fields)

* Analytics, insights, batch operations.

<Cards>
  <Card title="Content Types" href="/docs/gbp/content-types" />

  <Card title="Plan Features" href="/docs/billing/plan-features" />
</Cards>


# Understanding GBP



Google Business Profile is essential for local businesses to be found online.

## Why GBP Matters

* **Local Search** - Appear in "near me" searches
* **Google Maps** - Show up on Maps with directions
* **Knowledge Panel** - Display info directly in search results
* **Trust Signals** - Reviews and ratings build credibility
* **Free Marketing** - Posts reach local searchers

## Key Components

### Business Information

* Business name
* Address and service area
* Phone number
* Website URL
* Business hours
* Categories

### Visual Content

* Logo and cover photo
* Interior/exterior photos
* Product photos
* Videos

### Customer Interaction

* Reviews and ratings
* Questions & Answers
* Messaging
* Booking links

### Updates

* Local Posts
* Events
* Offers
* Product highlights

## How Google Uses Your Profile

1. **Search Ranking** - Complete profiles rank higher
2. **Knowledge Panel** - Info displayed in search results
3. **Maps Results** - Location shown on Google Maps
4. **Local Pack** - Featured in top 3 local results
5. **Voice Search** - Info used for voice assistant answers

## Profile Completeness

Google favors complete profiles:

* All basic info filled
* Photos uploaded
* Regular posts
* Review responses
* Q\&A answers

<Callout type="info">
  Synoveo's Profile Optimizer helps you track completeness.
</Callout>

## Access & Permissions

### Owner

Full access to all features and settings.

### Manager

Can edit most information but not manage users.

### Site Manager

Limited access for basic updates.

<Cards>
  <Card title="Verification" href="/docs/gbp/verification" />

  <Card title="Profile Fields" href="/docs/gbp/profile-fields" />
</Cards>


# Verification



Verification proves you're the legitimate owner of a business and unlocks all GBP features.

## Why Verification Matters

Unverified profiles:

* May not appear in search
* Cannot respond to reviews
* Cannot post updates
* Cannot edit certain fields
* Cannot be synced with Synoveo

## Verification Methods

Google offers several verification methods:

### Postcard (Most Common)

1. Request verification
2. Google mails postcard with code
3. Enter code in GBP (arrives in 5-14 days)

### Phone

1. Google calls your business number
2. Enter the code provided
3. Instant verification

### Email

1. Google sends code to business email
2. Enter the code
3. Instant verification

### Video

1. Record video of your business
2. Show signage, location, proof of ownership
3. Google reviews within 5 days

### Live Video Call

1. Schedule call with Google support
2. Show business via video
3. Verified during call

## Checking Verification Status

In Synoveo:

1. Go to **Dashboard → Locations**
2. Look for verification indicator:
   * <IconCheck /> Green = Verified
   * <IconWarning /> Yellow = Pending
   * <IconX /> Red = Not verified

### Refresh Status

Click "Check Verification Status" to query Google for latest status.

## Completing Verification

If not verified:

1. Go to [Google Business Profile Manager](https://business.google.com)
2. Select the location
3. Click "Verify" or "Complete verification"
4. Follow the provided method
5. Return to Synoveo and refresh status

## Troubleshooting

### "Verification postcard not received"

* Wait full 14 days
* Check correct address
* Request new postcard

### "Phone verification not available"

* Not all businesses qualify
* Try another method

### "Verification rejected"

* Ensure business is legitimate
* Provide requested documents
* Contact Google support

## After Verification

Once verified:

1. Sync becomes available in Synoveo
2. Enable sync toggle
3. Start managing your profile

<Cards>
  <Card title="Managing Locations" href="/docs/dashboard/locations" />

  <Card title="Profile Fields" href="/docs/gbp/profile-fields" />
</Cards>


# Choose Your Platform



Synoveo supports multiple platforms. Choose the one that matches your website.

## Platforms

<div className="grid grid-cols-2 md:grid-cols-4 gap-4 my-8">
  <a href="/docs/getting-started/platforms/wordpress" className="flex flex-col items-center p-6 rounded-lg border dark:border-gray-700 hover:border-blue-500 dark:hover:border-blue-400 transition-colors no-underline">
    <VendorIcon name="wordpress" size={48} className="mb-3" />

    <span className="font-medium text-foreground">
      WordPress
    </span>

    <span className="text-xs text-green-600 dark:text-green-400 mt-1">
      <IconCheck />

       Available
    </span>
  </a>

  <a href="/docs/getting-started/platforms/shopify" className="flex flex-col items-center p-6 rounded-lg border dark:border-gray-700 hover:border-blue-500 dark:hover:border-blue-400 transition-colors no-underline">
    <VendorIcon name="shopify" size={48} className="mb-3" />

    <span className="font-medium text-foreground">
      Shopify
    </span>

    <span className="text-xs text-orange-600 dark:text-orange-400 mt-1">
      <IconClock />

       Coming Soon
    </span>
  </a>

  <a href="/docs/getting-started/platforms/webflow" className="flex flex-col items-center p-6 rounded-lg border dark:border-gray-700 hover:border-blue-500 dark:hover:border-blue-400 transition-colors no-underline">
    <VendorIcon name="webflow" size={48} className="mb-3" />

    <span className="font-medium text-foreground">
      Webflow
    </span>

    <span className="text-xs text-orange-600 dark:text-orange-400 mt-1">
      <IconClock />

       Coming Soon
    </span>
  </a>

  <a href="/docs/getting-started/platforms/custom-sdk" className="flex flex-col items-center p-6 rounded-lg border dark:border-gray-700 hover:border-blue-500 dark:hover:border-blue-400 transition-colors no-underline">
    <VendorIcon name="custom" size={48} className="mb-3" />

    <span className="font-medium text-foreground">
      Custom / SDK
    </span>

    <span className="text-xs text-orange-600 dark:text-orange-400 mt-1">
      <IconClock />

       Coming Soon
    </span>
  </a>
</div>

***

## WordPress

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="wordpress" size={40} />

  <span className="text-green-600 dark:text-green-400 font-medium">
    <IconCheck />

     Available Now
  </span>
</div>

The WordPress plugin automatically detects and syncs business data from your WordPress site to Google.

### Features

* Auto-detect data from WooCommerce, Yoast SEO, Rank Math, Amelia, Bookly
* One-click sync to Google Business Profile
* Auto-post WordPress content to Google
* Display Google reviews with shortcodes
* Schema.org structured data (HyperSEO)

<Card title="WordPress Quick Start" href="/docs/getting-started/platforms/wordpress" />

***

## Shopify

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="shopify" size={32} />

  <span className="text-orange-600 dark:text-orange-400 font-medium">
    <IconClock />

     Coming Soon
  </span>
</div>

Sync your Shopify store to Google Business Profile.

### Planned Features

* Auto-sync products to GBP
* Sync store hours and contact info
* Post new products to Google
* Display reviews in your theme

<Card title="Learn More" href="/docs/getting-started/platforms/shopify" />

***

## Webflow

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="webflow" size={32} />

  <span className="text-orange-600 dark:text-orange-400 font-medium">
    <IconClock />

     Coming Soon
  </span>
</div>

Sync your Webflow CMS to Google Business Profile.

### Planned Features

* Sync Webflow CMS collections
* Auto-post CMS items to Google
* Embed Google reviews on your site

<Card title="Learn More" href="/docs/getting-started/platforms/webflow" />

***

## Custom Integration

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="custom" size={32} />

  <span className="text-orange-600 dark:text-orange-400 font-medium">
    <IconClock />

     SDK Coming Soon
  </span>
</div>

Build your own integration with the Synoveo API.

### Features

* Full REST API access (available now)
* TypeScript SDK (coming soon)
* Webhook support for real-time updates

<Card title="API Reference" href="/api-reference" />

***

## Other Options

### Dashboard Only

Don't need a platform integration? Use the Synoveo Hub directly:

* View and edit profile information
* Create and manage local posts
* Respond to customer reviews

<Card title="Dashboard Guide" href="/docs/dashboard" />

***

## Platform Comparison

| Platform       | Status                  | Auto-Sync     | Auto-Post     | Reviews       |
| -------------- | ----------------------- | ------------- | ------------- | ------------- |
| **WordPress**  | <IconCheck /> Available | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Shopify**    | <IconClock /> Coming    | <IconClock /> | <IconClock /> | <IconClock /> |
| **Webflow**    | <IconClock /> Coming    | <IconClock /> | <IconClock /> | <IconClock /> |
| **Custom/SDK** | <IconClock /> Coming    | via API       | via API       | via API       |
| **Dashboard**  | <IconCheck /> Available | Manual        | <IconCheck /> | View only     |

## Can I Use Multiple Platforms?

Yes! You can connect multiple sites to the same Synoveo account:

* **Multiple WordPress sites** - Each connecting to different locations
* **WordPress + Dashboard** - Sync from WordPress, manage via dashboard

<Callout type="warning">
  Each location can only have one sync source at a time to prevent conflicts.
</Callout>


# Connect Google Business Profile



To sync data with your Google Business Profile, you need to authorize Synoveo to access your Google account.

## Prerequisites

Before connecting, ensure you have:

* A Google account with access to your business locations
* Owner or Manager permissions on the Google Business Profiles you want to manage
* Verified locations (unverified locations can be connected but won't sync)

## Connect Your Google Account

<Steps>
  <Step>
    ### Open Dashboard

    Go to your [Synoveo Dashboard](https://app.synoveo.com/dashboard/locations)
  </Step>

  <Step>
    ### Click Connect

    Click the "Connect Google Account" button
  </Step>

  <Step>
    ### Sign in to Google

    Select your Google account or sign in
  </Step>

  <Step>
    ### Grant Permissions

    Review and approve the requested permissions:

    * View and manage your Google Business Profile
    * View your basic profile info
  </Step>

  <Step>
    ### Return to Dashboard

    You'll be redirected back to Synoveo with your locations visible
  </Step>
</Steps>

## What Permissions Does Synoveo Request?

Synoveo requests the minimum permissions needed:

| Permission         | Purpose                               |
| ------------------ | ------------------------------------- |
| `business.manage`  | Read and update your business profile |
| `userinfo.profile` | Identify your account                 |

<Callout type="info">
  Synoveo never has access to your Google password or other Google services.
</Callout>

## Viewing Your Locations

After connecting, you'll see all your Google Business Profile locations:

* **Verified locations** - Ready to sync (green indicator)
* **Unverified locations** - Need verification first (yellow indicator)
* **Location groups** - Organized as in Google Business Profile

## Assigning Locations

Before syncing, you need to assign locations to a Synoveo business:

1. Click on an unassigned location
2. Select "Assign to Business"
3. Choose an existing business or create a new one
4. The location is now ready for sync

## Enable Sync

For each assigned location:

1. Ensure the location is **verified** in Google
2. Toggle the "Sync Enabled" switch to ON
3. The location will now accept sync requests

<Callout type="warning">
  Only verified Google Business Profile locations can have sync enabled. If your location is not verified, complete verification in Google first.
</Callout>

## Reconnecting

If your connection expires or has issues:

1. Click "Reconnect" on the locations page
2. Complete the Google authorization again
3. A new refresh token is obtained

## Troubleshooting

### "Location not showing"

* Ensure you have Owner/Manager access in Google Business Profile
* Try refreshing the locations list
* Check if the location was recently added (may take a few minutes)

### "Can't enable sync"

* The location must be verified in Google first
* Check verification status in Google Business Profile Manager

### "Authorization expired"

* Google tokens expire periodically
* Click "Reconnect" to re-authorize

## Next Steps

<Cards>
  <Card title="Choose Your Integration Path" href="/docs/getting-started/choose-your-path" />

  <Card title="WordPress Plugin Setup" href="/docs/wordpress" />
</Cards>


# Create Your Account



Getting started with Synoveo takes just a few minutes. Follow this guide to create your account.

## Sign Up

1. Go to [app.synoveo.com](https://app.synoveo.com)
2. Enter your email address
3. Check your email for a verification code
4. Enter the code to verify your account

<Callout type="info">
  Synoveo uses passwordless authentication. You'll receive a code via email each time you log in.
</Callout>

## Select Your Plan

After verification, choose the plan that fits your needs:

| Plan         | Price  | Locations | Best For                   |
| ------------ | ------ | --------- | -------------------------- |
| **Lite**     | Free   | 1         | Trying Synoveo, basic sync |
| **Solo**     | $12/mo | 1         | Single location businesses |
| **Pro**      | $29/mo | 3         | Growing businesses         |
| **Business** | $79/mo | 10        | Agencies, multi-location   |

### What's Included

* **Lite**: Basic business info sync (9 fields)
* **Solo**: Complete profile management (14 fields)
* **Pro**: Full engagement tools + posts, reviews, Q\&A (150+ fields)
* **Business**: Everything + analytics, insights, batch operations

<Callout type="tip">
  Need more locations? Add extra locations for $5/month each on any paid plan.
</Callout>

## Payment

For paid plans, you'll be redirected to Stripe for secure payment:

1. Enter your card details
2. Complete the subscription
3. Return to your dashboard

Synoveo supports:

* All major credit cards
* Secure checkout via Stripe
* Monthly billing
* Cancel anytime

## After Sign Up

Once your account is created:

1. **Connect Google** - Link your Google Business Profile
2. **Add a Business** - Create your first Synoveo business
3. **Assign Locations** - Map Google locations to your business
4. **Start Syncing** - Connect WordPress or use the dashboard

## Next Steps

<Cards>
  <Card title="Connect Google Business Profile" href="/docs/getting-started/connect-google" />

  <Card title="Plans & Pricing Details" href="/docs/billing/plans-overview" />
</Cards>


# How Synoveo Works



Synoveo acts as an intelligent bridge between your business platforms and Google Business Profile. Here's how the system works.

## Architecture Overview

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Your Source   │     │     Synoveo     │     │     Google      │
│   Platform      │────▶│   API Server    │────▶│ Business Profile│
│                 │     │                 │     │                 │
│ • WordPress     │     │ • Auth/Security │     │ • Profile Data  │
│ • WooCommerce   │     │ • Sync Engine   │     │ • Posts         │
│ • Custom App    │     │ • Plan Limits   │     │ • Reviews       │
└─────────────────┘     └─────────────────┘     └─────────────────┘
```

## Key Concepts

### GBP Format Requirement

Synoveo API accepts data in **Google Business Profile API format only**. This means:

* Your platform transforms data to GBP format before sending
* Synoveo validates, filters, and forwards to Google
* No proprietary data models to learn

### Plan-Based Field Filtering

Different plans have access to different GBP fields:

* **Lite** - Basic info: name, address, phone, hours (9 fields)
* **Solo** - Complete profile: + description, categories, attributes (14 fields)
* **Pro** - Full engagement: + posts, reviews, Q\&A, media (150+ fields)
* **Business** - Everything: + analytics, insights, batch operations (200+ fields)

### Location-Based Billing

You pay per location you sync, not per domain or user:

* Each plan includes a set number of locations
* Add more locations with add-ons ($5/month each)
* Unlimited WordPress sites can connect to your locations

## The Sync Process

<Steps>
  <Step>
    ### Data Collection

    Your source platform (WordPress, etc.) collects business data from your site.
  </Step>

  <Step>
    ### Transformation

    Data is transformed to Google Business Profile API format.
  </Step>

  <Step>
    ### Sync Request

    Request sent to Synoveo API with authentication.
  </Step>

  <Step>
    ### Validation & Filtering

    Synoveo validates data and filters fields based on your plan.
  </Step>

  <Step>
    ### Google Sync

    Validated data is sent to Google Business Profile API.
  </Step>

  <Step>
    ### Confirmation

    Sync result returned with success/error details.
  </Step>
</Steps>

## 3-Way Sync Comparison

Synoveo provides a powerful 3-way comparison:

1. **Your Source** - Current data from your platform
2. **Google** - Current data on GBP
3. **Last Sync** - What was synced previously

This helps identify:

* Changes made locally that need to sync
* Changes made on Google that need to sync back
* Conflicts that need manual resolution

## Security Model

* **OAuth 2.0** for Google authorization
* **API Keys** for platform authentication (WordPress)
* **JWT Tokens** for user sessions (Dashboard)
* **AES-256 Encryption** for stored tokens

## Next Steps

<Cards>
  <Card title="Create Your Account" href="/docs/getting-started/create-account" />

  <Card title="Connect Google" href="/docs/getting-started/connect-google" />
</Cards>


# Getting Started



Welcome to Synoveo! This guide will help you get started with automating your Google Business Profile.

## What You'll Learn

1. **What is Synoveo** - Understand what Synoveo does and how it helps your business
2. **How it Works** - Learn the architecture and data flow
3. **Create Your Account** - Sign up and select your plan
4. **Connect Google** - Link your Google Business Profile
5. **Choose Your Path** - WordPress plugin, dashboard, or API integration

## Quick Start

<Steps>
  <Step>
    ### Create an Account

    Sign up at [app.synoveo.com](https://app.synoveo.com) and select a plan that fits your needs.
  </Step>

  <Step>
    ### Connect Google Business Profile

    Authorize Synoveo to access your Google Business Profile locations.
  </Step>

  <Step>
    ### Choose Your Integration

    * **WordPress Users**: Install the plugin from wordpress.org
    * **Dashboard Users**: Use the web dashboard directly
    * **Developers**: Integrate via our REST API
  </Step>
</Steps>

## Next Steps

<Cards>
  <Card title="What is Synoveo?" href="/docs/getting-started/what-is-synoveo" />

  <Card title="Create Your Account" href="/docs/getting-started/create-account" />
</Cards>


# Plans & Pricing



Synoveo offers flexible, location-based pricing to fit businesses of all sizes.

<Callout type="info">
  Pricing data is fetched from our [public API endpoint](/api-reference/endpoints/config#pricing). All prices are in USD.
</Callout>

## Pricing Model

Synoveo charges by **location count**, not by domain or user:

* Each plan includes a set number of Google Business Profile locations
* Add more locations with the Extra Location add-on ($5/month each)
* Unlimited WordPress sites can connect to your locations

## Plans

### Lite - Free

**$0/month** · 1 location included

Start managing your Google presence for free.

**Capabilities:**

* Basic business info sync

***

### Solo - $12/month

**$12/month** · 1 location included

Automation for busy solopreneurs - Daily automated sync, never worry about outdated business info again.

**Capabilities:**

* Basic sync
* Simple hours management
* Google connection
* Analytics dashboard
* Reviews display

**Available Add-ons:**

| Add-on     | Price    | Description                                 |
| ---------- | -------- | ------------------------------------------- |
| Engagement | $7/month | Posts, photos, and social media integration |
| Reputation | $7/month | Respond to customer reviews                 |

***

### Pro - $29/month

**$29/month** · 3 locations included

Grow across multiple locations - Manage up to 3 locations with engagement features included.

**Capabilities:**

* Everything in Solo, plus:
* Advanced posts
* Multi-source sync
* All attributes (600+)
* HyperSEO (Schema.org)
* Engagement features
* Lodging support

**Available Add-ons:**

| Add-on     | Price     | Description                         |
| ---------- | --------- | ----------------------------------- |
| Reputation | $10/month | Manage reviews across all locations |

***

### Business - $79/month

**$79/month** · 10 locations included

Built for agencies and enterprises - Unlimited businesses, API access, white-label capabilities.

**Capabilities:**

* Everything in Pro, plus:
* Advanced analytics
* API access with authentication
* White-label capabilities

**Available Bundles:**

| Bundle     | Price     | Description                            |
| ---------- | --------- | -------------------------------------- |
| Basic      | Included  | Base plan features                     |
| Engagement | $40/month | Posts, media, attributes (tenant-wide) |
| Reputation | $40/month | Review management (tenant-wide)        |
| All-In     | $70/month | Everything (tenant-wide)               |

***

## Extra Locations

Need more locations than your plan includes?

**$5/month per additional location**

Available on Solo, Pro, and Business plans. Add as many as you need.

## Feature Comparison

| Feature               | Lite          | Solo          | Pro           | Business      |
| --------------------- | ------------- | ------------- | ------------- | ------------- |
| **Locations**         | 1             | 1             | 3             | 10            |
| **Basic Info**        | <IconCheck /> | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Simple Hours**      | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Google Connection** | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Analytics**         | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Reviews Display**   | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |
| **Advanced Posts**    | <IconX />     | Add-on        | <IconCheck /> | <IconCheck /> |
| **All Attributes**    | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| **HyperSEO**          | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| **Engagement**        | <IconX />     | Add-on        | <IconCheck /> | <IconCheck /> |
| **Lodging Support**   | <IconX />     | <IconX />     | <IconCheck /> | <IconCheck /> |
| **Extra Locations**   | <IconX />     | <IconCheck /> | <IconCheck /> | <IconCheck /> |

## Capabilities Explained

| Capability          | Description                                       |
| ------------------- | ------------------------------------------------- |
| `basic_sync`        | Core business info: name, address, phone, website |
| `simple_hours`      | Opening hours management                          |
| `google_connection` | Connect to Google Business Profile                |
| `analytics`         | View performance metrics                          |
| `reviews_display`   | Show Google reviews on your site                  |
| `advanced_posts`    | Create local posts (updates, events, offers)      |
| `multi_source`      | Sync from multiple WordPress plugins              |
| `attributes`        | Access all 600+ GBP attributes                    |
| `hyper_seo`         | Schema.org structured data generation             |
| `engagement`        | Posts, photos, Q\&A management                    |
| `lodging`           | Hotel-specific features                           |

## API Access

Fetch current pricing programmatically:

```bash
curl https://api.synoveo.com/api/v1/config/pricing
```

Response includes:

* All plan details with prices in cents
* Available add-ons per plan
* Extra location pricing
* Current capabilities per plan

## FAQ

### Can I switch plans?

Yes, upgrade or downgrade anytime. Changes are prorated.

### What happens if I downgrade?

Features not included in your new plan won't be available, but your data remains on Google.

### Is there a free trial?

The Lite plan is free forever. Try Synoveo risk-free!

### Do you offer annual billing?

Coming soon. Contact us for enterprise pricing.

### How are prices calculated?

All prices are stored in cents in our database to avoid floating-point precision issues. The API returns prices in cents; frontends convert to dollars for display.

## Next Steps

<Cards>
  <Card title="Create Your Account" href="/docs/getting-started/create-account" />

  <Card title="Billing Management" href="/docs/billing" />
</Cards>


# What is Synoveo?



Synoveo is a SaaS platform that automates and optimizes your Google Business Profile (GBP). It syncs your business data from various sources to Google, keeping your profile accurate, complete, and up-to-date.

## The Problem

Managing your Google Business Profile manually is time-consuming:

* Updating hours, services, and contact information
* Publishing posts and responding to reviews
* Keeping information consistent across platforms
* Tracking performance and making improvements

## The Solution

Synoveo automates these tasks by:

* **Syncing data automatically** from your WordPress site, e-commerce store, or booking system
* **Publishing posts** to Google from your existing content
* **Managing reviews** with easy reply workflows
* **Tracking performance** with insights and recommendations

## Key Features

### For Business Owners

* One-click sync from WordPress to Google
* Automatic posting of WordPress content to GBP
* Display Google reviews on your website
* Profile health scoring and recommendations

### For Agencies

* Manage multiple locations from one dashboard
* Bulk operations for efficiency
* Location grouping and organization
* Team access controls (coming soon)

### For Developers

* REST API for custom integrations
* Webhook support for real-time updates
* SDK for TypeScript/JavaScript
* Platform-agnostic design

## How It Works

```
Your Platform          Synoveo              Google
(WordPress, etc.)  →   API + Dashboard  →   Business Profile
     ↓                      ↓                     ↓
  Business Data        Sync Engine          Profile Updates
  Products/Services    Field Filtering      Posts & Media
  Posts/Content        Plan Enforcement     Reviews & Q&A
```

## Supported Platforms

* **WordPress** - Full-featured plugin with auto-detection
* **WooCommerce** - Product and service sync
* **Booking Systems** - Amelia, Bookly integration
* **SEO Plugins** - Yoast, Rank Math, AIOSEO
* **Custom** - REST API for any platform

## Next Steps

<Cards>
  <Card title="How Synoveo Works" href="/docs/getting-started/how-it-works" />

  <Card title="Create Your Account" href="/docs/getting-started/create-account" />
</Cards>


# Complete Sync Guide















import { Callout } from 'fumadocs-ui/components/callout'
import { Steps, Step } from 'fumadocs-ui/components/steps'
import { Cards, Card } from 'fumadocs-ui/components/card'
import { Tabs, Tab } from 'fumadocs-ui/components/tabs'

This guide covers everything about syncing data between WordPress and Google Business Profile.

<Callout type="info">
  **New to syncing?** Start with the [Sync Quickstart](/docs/guides/sync-quickstart) for a 5-minute introduction.
</Callout>

## Prerequisites

* <IconCheck /> **Verified Google location** — [Verification Guide](/docs/gbp/verification)
* <IconCheck /> **API key created** — [API Keys Guide](/docs/dashboard/api-keys)
* <IconCheck /> **WordPress plugin installed & connected** — [Plugin Installation](/docs/wordpress/installation)

***

## Understanding Sync Center

The Sync Center is your control panel for managing data synchronization. Access it via **Sync Center** in the dashboard sidebar.

<img alt="Sync Center overview" src={__img0} placeholder="blur" />

### The Three Tabs

| Tab                              | Purpose                                         |
| -------------------------------- | ----------------------------------------------- |
| **Google Business Profile**      | View current data on Google (read-only)         |
| **WordPress** (or your platform) | Configure which plugin fields map to GBP fields |
| **Delta**                        | Compare differences and execute sync            |

***

## Tab 1: Google Business Profile View

The GBP tab shows what's currently live on your Google Business Profile.

<img alt="GBP profile view" src={__img1} placeholder="blur" />

**What you'll see:**

* Business name, address, phone
* Opening hours
* Categories
* Attributes (WiFi, parking, etc.)
* Description

<Callout type="warning">
  This is cached data. Click **Refresh** to pull the latest from Google.
</Callout>

***

## Tab 2: Field Configuration (Source Tab)

The Source tab is where you tell Synoveo which WordPress plugin provides each GBP field.

<img alt="Field configurator" src={__img2} placeholder="blur" />

### How Field Mapping Works

1. **GBP Field** — The Google Business Profile field (e.g., "Business Name")
2. **Available Sources** — WordPress plugins that can provide this data
3. **Confirmed Source** — The source you've selected and confirmed

### Configuring a Field

<Steps>
  <Step>
    ### Expand a Category

    Click on a category header (e.g., "Basic Business Information") to see its fields.
  </Step>

  <Step>
    ### Select a Source

    For each field, choose which WordPress plugin provides this data:

    | Field         | Common Sources                     |
    | ------------- | ---------------------------------- |
    | Business Name | Yoast SEO, WooCommerce, Site Title |
    | Phone         | Contact Form 7, ACF, Theme Options |
    | Hours         | Business Hours plugin, ACF         |
    | Description   | Yoast SEO, Theme Options           |
  </Step>

  <Step>
    ### Preview the Value

    After selecting a source, you'll see a preview of the actual data from WordPress.
  </Step>

  <Step>
    ### Confirm the Mapping

    Click **Confirm** to save this field mapping. Confirmed fields appear in the Delta tab.
  </Step>
</Steps>

### Batch Preview

Click **Refresh All Previews** to fetch the latest values from all configured sources at once.

***

## Tab 3: Delta View (Comparison & Sync)

The Delta tab shows differences between your WordPress data and Google data.

<img alt="Delta comparison" src={__img3} placeholder="blur" />

### Understanding Status Badges

| Badge                  | Meaning                                     |
| ---------------------- | ------------------------------------------- |
| **Match** (green)      | WordPress and Google have the same value    |
| **Different** (orange) | Values differ — sync to update              |
| **New** (blue)         | Field exists in WordPress but not on Google |

### Sync Modes

<Tabs items={['Sync All', 'Per Field']}>
  <Tab value="Sync All">
    **Sync All Mode** — Quick bulk sync

    1. Select a direction (WordPress → Google)
    2. All different fields are auto-selected
    3. Click **Sync** to update everything at once

    Best for: Initial sync, after major WordPress updates
  </Tab>

  <Tab value="Per Field">
    **Per Field Mode** — Granular control

    1. Check individual fields you want to sync
    2. Set direction for each field (can differ per field)
    3. Click **Sync Selected**

    Best for: Selective updates, testing individual fields
  </Tab>
</Tabs>

### Sync Directions

| Direction              | When to Use                                             |
| ---------------------- | ------------------------------------------------------- |
| **WordPress → Google** | Push your WordPress data to update Google (most common) |
| **Google → WordPress** | Pull Google data back to WordPress (rare, for recovery) |

***

## Executing a Sync

<Steps>
  <Step>
    ### Select Fields

    In the Delta tab, check the fields you want to sync.
  </Step>

  <Step>
    ### Choose Direction

    Select **WordPress → Google** (or reverse if needed).
  </Step>

  <Step>
    ### Click Sync

    Review the confirmation dialog showing all selected fields.

        <img alt="Sync confirmation" src={__img4} placeholder="blur" />
  </Step>

  <Step>
    ### Wait for Completion

    The progress overlay shows three phases:

    1. **Syncing** — Sending data to Google
    2. **Refreshing** — Updating cached data
    3. **Done** — Sync complete

        <img alt="Sync progress" src={__img5} placeholder="blur" />
  </Step>
</Steps>

<Callout type="warning">
  **Don't navigate away** during sync. Wait for the "Done" confirmation.
</Callout>

***

## Field Categories Reference

Each category has specific fields and behaviors:

| Category                       | Fields                                 | Notes                       |
| ------------------------------ | -------------------------------------- | --------------------------- |
| **Basic Business Information** | Name, phone, website, address, hours   | Available on all plans      |
| **Profile Description**        | Business description (750 char max)    | Solo+ plans                 |
| **Categories**                 | Primary + additional categories        | Pro+ plans                  |
| **Social Media**               | Facebook, Instagram, Twitter, etc.     | Pro+ plans                  |
| **Attributes**                 | WiFi, parking, payments, accessibility | Pro+ plans, GBP-native only |
| **Service Lists**              | Services with descriptions and pricing | Pro+ plans                  |
| **Service Area**               | Geographic regions served              | Pro+ plans                  |
| **Place Actions**              | Booking, ordering, shopping links      | Pro+ plans                  |
| **Lodging Amenities**          | Hotel-specific features                | Business plan, hotels only  |

<Callout type="info">
  **Locked fields?** Some categories require a higher plan. See [Compare Plans](/docs/billing/plans-overview).
</Callout>

***

## Best Practices

1. **Start with Basic Info** — Sync name, phone, address first
2. **Verify before bulk sync** — Use Per Field mode to test a few fields
3. **Check Google after sync** — Confirm changes appear (1-2 min delay)
4. **Keep WordPress updated** — Sync pulls from your live WordPress data
5. **Use Batch Preview** — Refresh all previews before syncing to ensure data is current

***

## Troubleshooting

### "No Source Data"

The Source tab shows "No Source Data Yet":

* WordPress plugin may not be sending data
* API key may not be configured correctly
* Click **Refresh from Source** to retry

### "Sync Failed"

Check the error message:

* **RATE\_LIMITED** — Wait 1 hour and retry
* **INVALID\_FIELD** — Data format issue, check the value
* **PERMISSION\_DENIED** — Field not in your plan

See [Sync Troubleshooting](/docs/troubleshooting/sync-failures) for more.

### Fields Not Appearing in Delta

* Field source not confirmed in Source tab
* Field may already match (check "Match" status)
* Category may be locked (upgrade required)

***

## Next Steps

<Cards>
  <Card title="Sync Center Reference" href="/docs/dashboard/sync-center" />

  <Card title="GBP Profile Fields" href="/docs/gbp/profile-fields" />

  <Card title="Troubleshooting" href="/docs/troubleshooting/sync-failures" />

  <Card title="Compare Plans" href="/docs/billing/plans-overview" />
</Cards>


# Sync Your First Field













import { Callout } from 'fumadocs-ui/components/callout'
import { Steps, Step } from 'fumadocs-ui/components/steps'
import { Cards, Card } from 'fumadocs-ui/components/card'

Sync your WordPress data to Google Business Profile. This guide assumes you have the prerequisites in place.

## Prerequisites

Before you begin, ensure you have:

* <IconCheck /> **Verified Google location** — [Verification Guide](/docs/gbp/verification)
* <IconCheck /> **API key created** — [API Keys Guide](/docs/dashboard/api-keys)
* <IconCheck /> **WordPress plugin installed & connected** — [Plugin Installation](/docs/wordpress/installation)

<Callout type="info">
  Don't have these set up? Complete the prerequisites first, then return here.
</Callout>

***

## Step 1: Open Sync Center

<Steps>
  <Step>
    ### Navigate to Sync Center

    Go to **Sync Center** in the dashboard sidebar.
  </Step>

  <Step>
    ### Select Your Location

    Use the dropdown at the top to select the location you want to sync.

        <img alt="Sync Center with location selector" src={__img0} placeholder="blur" />
  </Step>
</Steps>

***

## Step 2: Configure a Field Source

<Steps>
  <Step>
    ### Open the Source Tab

    Click the **WordPress** tab (or your platform name) to see the field configurator.
  </Step>

  <Step>
    ### Find a Field to Configure

    Expand a category (e.g., **Basic Business Information**) and find "Business Name".
  </Step>

  <Step>
    ### Select the Source

    Click the dropdown next to "Business Name" and select where this data comes from:

    * **Yoast SEO → Site Title**
    * **WooCommerce → Store Name**
    * **WordPress → Site Title**

        <img alt="Field source configuration" src={__img1} placeholder="blur" />
  </Step>

  <Step>
    ### Confirm Your Selection

    Click **Confirm** to save this mapping.
  </Step>
</Steps>

***

## Step 3: Review & Sync

<Steps>
  <Step>
    ### Open the Delta Tab

    Click the **Delta** tab to see differences between WordPress and Google.

        <img alt="Delta comparison view" src={__img2} placeholder="blur" />
  </Step>

  <Step>
    ### Choose Sync Mode

    Select one of the two sync modes:

    | Mode          | Description                    | Best For                    |
    | ------------- | ------------------------------ | --------------------------- |
    | **Sync All**  | Quick sync all fields at once  | Initial setup, bulk updates |
    | **Per Field** | Choose specific fields to sync | Selective updates, testing  |
  </Step>

  <Step>
    ### Select Sync Direction

    Choose which direction to sync:

    | Direction              | Action                                           |
    | ---------------------- | ------------------------------------------------ |
    | **WordPress → Google** | Push your WordPress data to Google (most common) |
    | **Google → WordPress** | Pull Google data back to WordPress               |
  </Step>

  <Step>
    ### Confirm and Sync

    Click **Sync** and review the confirmation dialog showing selected fields and direction.

        <img alt="Sync confirmation dialog" src={__img3} placeholder="blur" />
  </Step>

  <Step>
    ### Wait for Completion

    The sync progress overlay shows the status. Don't navigate away until complete.

        <img alt="Sync progress overlay" src={__img4} placeholder="blur" />
  </Step>
</Steps>

***

## Done!

Your data is now synced to Google Business Profile. Changes typically appear within 1-2 minutes.

<Callout type="success">
  **Next steps:** Configure more fields in the Source tab, then sync them using the Delta tab.
</Callout>

<Cards>
  <Card title="Complete Sync Guide" href="/docs/guides/sync-complete-guide" />

  <Card title="Troubleshooting Sync" href="/docs/troubleshooting/sync-failures" />

  <Card title="Field Categories" href="/docs/gbp/profile-fields" />
</Cards>


# Local SEO Guide



Welcome to the Local SEO Guide. This section explains the concepts behind local search optimization and how to maximize your visibility on Google.

## Why Local SEO Matters

93% of consumers use online searches to find local businesses. Appearing in Google's Local Pack (the map results) can dramatically increase foot traffic, calls, and revenue.

## What You'll Learn

This guide covers everything from foundational concepts to advanced strategies:

* **How local search works** and what factors influence rankings
* **Google Business Profile** setup, optimization, and management
* **Reviews and reputation** management strategies
* **NAP consistency** and citation building
* **Schema markup** for enhanced search visibility
* **Multi-location management** for franchises and agencies
* **Troubleshooting** common issues

## Getting Started

<Cards>
  <Card title="Fundamentals" href="/docs/local-seo-guide/fundamentals" description="Start here to understand local search basics" />

  <Card title="Google Business Profile" href="/docs/local-seo-guide/google-business-profile" description="Deep dive into GBP setup and optimization" />

  <Card title="Reviews" href="/docs/local-seo-guide/reviews" description="Master review generation and response" />

  <Card title="Troubleshooting" href="/docs/local-seo-guide/troubleshooting" description="Fix common GBP problems" />
</Cards>

## How This Relates to Synoveo

This guide provides the educational foundation. To see how Synoveo automates these tasks, visit the [Dashboard documentation](/docs/dashboard) or [WordPress plugin guide](/docs/wordpress).


# API Key Security



Protect your Synoveo API keys to prevent unauthorized access.

## API Key Structure

Each API key consists of:

* **Client ID** - Public identifier
* **Client Secret** - Private key (shown once)

## Security Features

### Domain Binding

API keys are bound to specific domains:

* Only requests from configured domain work
* Prevents stolen keys from working elsewhere
* Configure domain during key creation

### Location Scoping

Keys can be restricted to specific locations:

* One key = one location
* Prevents accidental cross-location changes
* Limits blast radius if compromised

### Rate Limiting

Built-in rate limits prevent abuse:

* Per-key limits
* Per-plan limits
* Automatic blocking on abuse

## Best Practices

### 1. Keep Secrets Secret

* Never commit to version control
* Don't share via email/chat
* Use environment variables

```php
// Good - environment variable
define('SYNOVEO_SECRET', getenv('SYNOVEO_CLIENT_SECRET'));

// Bad - hardcoded
define('SYNOVEO_SECRET', 'sk_live_xxx'); // NEVER DO THIS
```

### 2. Use Environment Variables

```bash
# .env file (never commit)
SYNOVEO_CLIENT_ID=your_client_id
SYNOVEO_CLIENT_SECRET=your_secret
```

### 3. Rotate Keys Regularly

* Generate new key
* Update applications
* Revoke old key
* Recommended: Every 90 days

### 4. Monitor Usage

* Review key usage in dashboard
* Set up alerts for unusual activity
* Check for unauthorized access

### 5. Revoke Compromised Keys

If a key is exposed:

1. **Immediately revoke** in dashboard
2. Generate new key
3. Update applications
4. Review access logs

## Key Management

### Creating Keys

1. Go to **API Keys** in dashboard
2. Click "Create API Key"
3. Configure domain and location
4. Copy and save secret immediately

### Viewing Keys

* Client ID always visible
* Secret only shown once at creation
* Last used timestamp available

### Revoking Keys

1. Find key in dashboard
2. Click "Revoke"
3. Confirm revocation
4. Key immediately invalidated

## WordPress Plugin

The WordPress plugin handles keys automatically:

* Stored encrypted in WordPress options
* Never exposed in frontend
* Protected by WordPress security

Configure via **Settings → Synoveo** in WordPress admin.

<Cards>
  <Card title="API Authentication" href="/api-reference/authentication" />

  <Card title="Data Security" href="/docs/security/data-security" />
</Cards>


# Data Security



Synoveo implements comprehensive security measures to protect your data.

## Encryption

### In Transit

* All connections use TLS 1.3
* HTTPS enforced everywhere
* Certificate pinning for API calls

### At Rest

* Database encryption (AES-256)
* Google OAuth tokens encrypted with AES-256-GCM
* Encryption keys managed securely

## Authentication

### User Authentication

* Passwordless email verification
* JWT tokens with short expiration
* Automatic token refresh
* Session management

### API Authentication

* API keys with domain binding
* Location-scoped access
* Key rotation support
* Revocation capability

## Infrastructure

### Hosting

* Railway cloud platform
* Automated backups
* Geographic redundancy
* DDoS protection

### Database

* PostgreSQL with encryption
* Regular backups
* Point-in-time recovery
* Access logging

## Access Control

### Principle of Least Privilege

* API keys only access assigned locations
* Users only see their businesses
* Role-based permissions

### Multi-Tenant Isolation

* Complete data isolation between users
* No cross-tenant data access
* Tenant context on every request

## Monitoring

### Security Monitoring

* Real-time threat detection
* Anomaly alerts
* Access logging
* Audit trails

### Incident Response

* 24/7 monitoring
* Defined response procedures
* User notification policy

## Compliance

* SOC 2 Type II (in progress)
* GDPR compliant
* CCPA compliant
* PCI DSS (via Stripe)

<Cards>
  <Card title="OAuth & Permissions" href="/docs/security/oauth-permissions" />

  <Card title="GDPR" href="/docs/security/gdpr" />
</Cards>


# GDPR Compliance



Synoveo is committed to GDPR compliance for our EU users.

## Your Rights

Under GDPR, you have the right to:

* **Access** - Request a copy of your data
* **Rectification** - Correct inaccurate data
* **Erasure** - Delete your data ("right to be forgotten")
* **Portability** - Export your data in standard format
* **Restriction** - Limit how we process your data
* **Object** - Object to certain processing

## Exercising Your Rights

### Export Your Data

<Steps>
  <Step>
    Go to **Settings → Data & Privacy**
  </Step>

  <Step>
    Click "Export My Data"
  </Step>

  <Step>
    Receive email with download link
  </Step>

  <Step>
    Download ZIP with your data
  </Step>
</Steps>

Export includes:

* Account information
* Business configurations
* Sync history
* API key records (not secrets)

### Delete Your Account

<Steps>
  <Step>
    Go to **Settings → Data & Privacy**
  </Step>

  <Step>
    Click "Delete Account"
  </Step>

  <Step>
    Confirm via email
  </Step>

  <Step>
    Account deleted within 30 days
  </Step>
</Steps>

<Callout type="warning">
  Account deletion is permanent. All data is removed and cannot be recovered.
</Callout>

## Data We Collect

### Account Data

* Email address
* Name (if provided)
* Billing information

### Business Data

* Business configurations
* Google location data (cached)
* Sync history

### Usage Data

* Feature usage analytics
* Error logs
* Performance metrics

### What We Don't Collect

* Credit card numbers (Stripe handles)
* Google password
* Data from other Google services

## Data Retention

| Data Type    | Retention      |
| ------------ | -------------- |
| Account data | Until deletion |
| Sync history | 90 days        |
| Error logs   | 30 days        |
| Analytics    | 24 months      |

## Data Processing

### Legal Basis

* **Contract** - To provide the service
* **Legitimate Interest** - To improve the service
* **Consent** - For marketing (opt-in)

### Sub-processors

* **Railway** - Hosting
* **Stripe** - Payments
* **Resend** - Email
* **Google** - Authentication

## Contact

For GDPR requests:

* Email: [privacy@synoveo.com](mailto:privacy@synoveo.com)
* Response within 30 days

<Card title="Data Security" href="/docs/security/data-security" />


# Security & Privacy



Learn about Synoveo's security practices and privacy policies.

## Overview

Synoveo takes security seriously. We implement industry-standard practices to protect your data and your customers' information.

<Cards>
  <Card title="Data Security" href="/docs/security/data-security" />

  <Card title="OAuth & Permissions" href="/docs/security/oauth-permissions" />

  <Card title="GDPR Compliance" href="/docs/security/gdpr" />

  <Card title="API Key Security" href="/docs/security/api-key-security" />
</Cards>


# OAuth & Permissions



Synoveo uses Google OAuth to securely access your Google Business Profile.

## OAuth Flow

When you connect your Google account:

1. You're redirected to Google
2. Google shows requested permissions
3. You approve or deny
4. Google sends tokens to Synoveo
5. Synoveo uses tokens to access your GBP

## Permissions Requested

Synoveo requests minimal permissions:

| Scope              | Purpose                  |
| ------------------ | ------------------------ |
| `business.manage`  | Read and update your GBP |
| `userinfo.profile` | Identify your account    |

### What We CAN Do

* Read your business profiles
* Update profile information
* Create and manage posts
* Reply to reviews
* Upload photos

### What We CAN'T Do

* Access your Gmail
* Access Google Drive
* Access other Google services
* Change your Google password
* Access your Google Ads

## Token Management

### Access Tokens

* Short-lived (1 hour)
* Used for API calls
* Automatically refreshed

### Refresh Tokens

* Long-lived (6 months)
* Used to get new access tokens
* Encrypted at rest

### Token Refresh

* Automatic before expiration
* Background refresh (no interruption)
* Re-auth prompt if refresh fails

## Revoking Access

You can revoke Synoveo's access anytime:

### In Synoveo

1. Go to **Settings → Connected Accounts**
2. Click "Disconnect Google"
3. Confirm disconnection

### In Google

1. Go to [Google Security Settings](https://myaccount.google.com/security)
2. Find "Third-party apps with account access"
3. Remove Synoveo

## Cross-Account Protection

Synoveo supports Google's Cross-Account Protection:

* Security events from Google
* Automatic token invalidation if suspicious activity
* Re-authentication required after security events

## Security Best Practices

1. **Connect only needed accounts** - Don't connect personal accounts
2. **Review permissions** - Understand what you're granting
3. **Monitor activity** - Check sync history regularly
4. **Disconnect if unused** - Remove access when not needed

<Cards>
  <Card title="API Key Security" href="/docs/security/api-key-security" />

  <Card title="Data Security" href="/docs/security/data-security" />
</Cards>


# Common Issues



Solutions to the most common Synoveo issues.

## Can't Connect Google Account

**Symptoms:** OAuth fails, redirect error, no locations appear

**Solutions:**

1. Clear browser cookies and try again
2. Try incognito/private browsing
3. Ensure pop-ups are allowed
4. Check you're signing into correct Google account
5. Verify you have GBP access

## Locations Not Showing

**Symptoms:** Connected but no locations visible

**Solutions:**

1. Verify you have Owner/Manager access in GBP
2. Click "Refresh Locations" button
3. Wait 5 minutes for cache to update
4. Check if location was recently added to Google

## Can't Enable Sync

**Symptoms:** Sync toggle won't turn on

**Solutions:**

1. Location must be verified in Google first
2. Click "Check Verification Status"
3. Complete verification in Google if needed
4. Assign location to a business first

## Sync Failed

**Symptoms:** Sync attempts but fails

**Solutions:**

1. Check error details in sync history
2. Verify plan supports the fields being synced
3. Check quota hasn't been exceeded
4. Ensure OAuth connection is still valid

## Reviews Not Loading

**Symptoms:** Reviews page empty or error

**Solutions:**

1. Verify Pro plan or higher
2. Check location has reviews in Google
3. Refresh the page
4. Check API connection status

## Posts Not Publishing

**Symptoms:** Post created but not on Google

**Solutions:**

1. Verify Pro plan or higher
2. Check location is verified
3. Ensure image meets requirements
4. Check for content policy violations

## WordPress Plugin Issues

**Symptoms:** Plugin not connecting

**Solutions:**

1. Verify credentials are correct
2. Check domain matches API key
3. Ensure server can reach api.synoveo.com
4. Check for plugin conflicts

## Slow Performance

**Symptoms:** Dashboard loading slowly

**Solutions:**

1. Clear browser cache
2. Try a different browser
3. Check internet connection
4. Large location counts may take longer

<Card title="Still stuck? Contact Support" href="/docs/troubleshooting/contact-support" />


# Connection Problems



Solutions for connection and authentication problems.

## Google OAuth Issues

### "Authorization Failed"

1. Clear browser cookies
2. Try incognito mode
3. Check pop-up blocker
4. Verify correct Google account

### "Access Denied"

1. Ensure you have GBP access
2. Check Owner/Manager permissions
3. Try different Google account

### "Token Expired"

1. Click "Reconnect Google"
2. Re-authorize access
3. Tokens refresh automatically

## API Connection Issues

### "Connection Refused"

1. Check internet connection
2. Verify firewall isn't blocking
3. Try: `curl https://api.synoveo.com/health`

### "Timeout"

1. Check server status
2. Try again in a few minutes
3. Large operations may take longer

### "SSL Error"

1. Update browser/OS
2. Check date/time settings
3. Disable VPN temporarily

## WordPress Plugin Connection

### "Invalid Credentials"

1. Re-copy Client ID and Secret
2. Remove extra spaces
3. Regenerate credentials if needed

### "Domain Mismatch"

1. API key domain must match site URL
2. Include or exclude www consistently
3. Check for trailing slashes

### "Can't Reach API"

```php
// Test connectivity
$response = wp_remote_get('https://api.synoveo.com/health');
if (is_wp_error($response)) {
  echo $response->get_error_message();
}
```

## Dashboard Issues

### "Page Won't Load"

1. Clear browser cache
2. Disable browser extensions
3. Try different browser
4. Check console for errors

### "Session Expired"

1. Log in again
2. Check if logged in elsewhere
3. Clear cookies

## Network Debugging

### Check API Status

Visit: [https://api.synoveo.com/health](https://api.synoveo.com/health)

### Check DNS

```bash
nslookup api.synoveo.com
```

### Check Connectivity

```bash
curl -I https://api.synoveo.com/health
```

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Contact Support



Can't find a solution? Our support team is here to help.

## Before Contacting Support

Please gather:

1. **Error message** - Exact text or screenshot
2. **Steps to reproduce** - What you did before the error
3. **Account email** - So we can find your account
4. **Location/Business ID** - If relevant
5. **Browser and OS** - For dashboard issues

## Contact Methods

### Email Support

**[support@synoveo.com](mailto:support@synoveo.com)**

Response time:

* Free plans: 48 hours
* Paid plans: 24 hours
* Business plan: 4 hours

### In-App Support

1. Click the help icon in dashboard
2. Select "Contact Support"
3. Describe your issue
4. We'll respond via email

## What to Include

### Good Support Request

```
Subject: Sync failing for location

Hi,

I'm getting a "SYNC_FAILED" error when trying to sync
location ID: locations/123456789.

Error message: "Field 'phoneNumber' format invalid"

Steps to reproduce:
1. Go to Sync Center
2. Click "Sync Now" for my location
3. Error appears after ~5 seconds

Account: user@example.com
Plan: Pro
Browser: Chrome 119, macOS

I've tried:
- Checking the phone number format
- Refreshing the page

Thanks!
```

### Include Screenshots

Screenshots help us understand:

* Error messages
* UI state
* Console errors (if technical)

## Response Times

| Plan     | Response Time |
| -------- | ------------- |
| Lite     | 48 hours      |
| Solo     | 24 hours      |
| Pro      | 24 hours      |
| Business | 4 hours       |

## Urgent Issues

For critical issues (service down, security concerns):

* Email: [urgent@synoveo.com](mailto:urgent@synoveo.com)
* Include "URGENT" in subject
* Describe impact

## Self-Service Resources

* [Documentation](/docs) - Guides and tutorials
* [API Reference](/api-reference) - Technical docs
* [Status Page](https://status.synoveo.com) - Service status

## Feature Requests

Have an idea for Synoveo?

* Email: [feedback@synoveo.com](mailto:feedback@synoveo.com)
* We review all suggestions
* Popular requests get prioritized


# Error Codes



Understanding Synoveo error codes helps diagnose issues quickly.

## HTTP Status Codes

| Code | Meaning                          |
| ---- | -------------------------------- |
| 200  | Success                          |
| 201  | Created                          |
| 400  | Bad Request - Invalid input      |
| 401  | Unauthorized - Auth required     |
| 403  | Forbidden - No permission        |
| 404  | Not Found                        |
| 429  | Too Many Requests - Rate limited |
| 500  | Server Error                     |

## Synoveo Error Codes

### Authentication Errors

| Code                  | Message                      | Solution                  |
| --------------------- | ---------------------------- | ------------------------- |
| `AUTH_REQUIRED`       | Authentication required      | Log in or provide API key |
| `TOKEN_EXPIRED`       | JWT token expired            | Refresh token or re-login |
| `INVALID_CREDENTIALS` | Invalid API credentials      | Check Client ID/Secret    |
| `GOOGLE_AUTH_EXPIRED` | Google authorization expired | Reconnect Google account  |

### Permission Errors

| Code                     | Message               | Solution                     |
| ------------------------ | --------------------- | ---------------------------- |
| `PLAN_LIMIT_EXCEEDED`    | Plan limit reached    | Upgrade plan or remove items |
| `FEATURE_NOT_AVAILABLE`  | Feature not in plan   | Upgrade to access feature    |
| `LOCATION_ACCESS_DENIED` | No access to location | Check API key scope          |
| `FIELD_NOT_ALLOWED`      | Field not in plan     | Upgrade for field access     |

### Resource Errors

| Code                    | Message                | Solution               |
| ----------------------- | ---------------------- | ---------------------- |
| `LOCATION_NOT_FOUND`    | Location doesn't exist | Check location ID      |
| `BUSINESS_NOT_FOUND`    | Business doesn't exist | Check business ID      |
| `LOCATION_NOT_VERIFIED` | Location not verified  | Verify in Google first |

### Sync Errors

| Code              | Message               | Solution                  |
| ----------------- | --------------------- | ------------------------- |
| `SYNC_FAILED`     | Sync operation failed | Check details, retry      |
| `QUOTA_EXCEEDED`  | Sync quota exceeded   | Wait for reset or upgrade |
| `RATE_LIMITED`    | Too many requests     | Wait and retry            |
| `INVALID_PAYLOAD` | Invalid sync data     | Check data format         |

### Validation Errors

| Code             | Message                 | Solution              |
| ---------------- | ----------------------- | --------------------- |
| `INVALID_INPUT`  | Input validation failed | Check request format  |
| `MISSING_FIELD`  | Required field missing  | Provide required data |
| `INVALID_FORMAT` | Data format incorrect   | Fix data format       |

## Error Response Format

```json
{
  "status": "error",
  "error": {
    "code": "SYNC_FAILED",
    "message": "Failed to sync location",
    "details": "Field 'phoneNumber' format invalid"
  }
}
```

## Getting Help

When contacting support, include:

1. Error code
2. Full error message
3. What you were doing
4. Timestamp
5. Location/business ID if applicable

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Troubleshooting



Find solutions to common problems with Synoveo.

<Cards>
  <Card title="Common Issues" href="/docs/troubleshooting/common-issues" />

  <Card title="Error Codes" href="/docs/troubleshooting/error-codes" />

  <Card title="Connection Problems" href="/docs/troubleshooting/connection-problems" />

  <Card title="Sync Failures" href="/docs/troubleshooting/sync-failures" />

  <Card title="Contact Support" href="/docs/troubleshooting/contact-support" />
</Cards>


# Sync Failures



Solutions for when sync operations don't work as expected.

## Common Sync Errors

### "LOCATION\_NOT\_VERIFIED"

**Cause:** Google location isn't verified

**Solution:**

1. Go to Google Business Profile Manager
2. Complete verification for the location
3. Return to Synoveo
4. Click "Check Verification Status"
5. Enable sync

### "QUOTA\_EXCEEDED"

**Cause:** You've used all sync quota for the period

**Solution:**

1. Wait for quota reset (check dashboard for date)
2. Upgrade plan for higher quota
3. Reduce sync frequency

### "FIELD\_NOT\_ALLOWED"

**Cause:** Plan doesn't include the field being synced

**Solution:**

1. Check which fields your plan includes
2. Upgrade plan for more fields
3. Disable fields not in your plan

### "INVALID\_PAYLOAD"

**Cause:** Data format doesn't match GBP requirements

**Solution:**

1. Check error details for specific field
2. Verify data format matches GBP API
3. Remove or fix invalid data

### "RATE\_LIMITED"

**Cause:** Too many requests in short time

**Solution:**

1. Wait 1 hour for rate limit reset
2. Reduce sync frequency
3. Use batch operations if available

## Partial Sync

### Some Fields Failed

When sync is partial:

1. Check sync history for details
2. Individual field errors shown
3. Successful fields still synced
4. Fix failed fields and retry

### Fields Not Syncing

If fields don't sync:

1. Verify field is in your plan
2. Check field is enabled in settings
3. Ensure source has data for field
4. Check for validation errors

## Debug Sync

### View Sync Details

1. Go to **Sync Center** in the sidebar
2. Find the sync operation
3. Click to expand details
4. Review field-by-field status

### Preview Before Sync

1. Click "Preview Sync"
2. Review changes before applying
3. Identify potential issues

### Check Source Data

1. Verify source has correct data
2. Compare source vs Google
3. Identify discrepancies

## Recovery

### After Failed Sync

1. Review error details
2. Fix underlying issue
3. Retry sync
4. Monitor success

### Rollback

Synoveo doesn't automatically rollback, but:

1. Check sync history for previous state
2. Manually restore if needed
3. Contact support for assistance

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Auto-Post to Google































Turn your WordPress content into Google Business Profile posts automatically. Write once, reach customers on both your website and Google Search.

## What is Auto-Post?

Auto-Post bridges WordPress and Google Business Profile. When you publish a blog post, product update, or promotion in WordPress, Synoveo automatically creates a matching post on your Google Business Profile.

```
WordPress Post  →  Synoveo  →  Google Business Profile Post
   (Your blog)      (Bridge)      (Appears in Google Search)
```

### Why Use Auto-Post?

| Benefit              | Description                                  |
| -------------------- | -------------------------------------------- |
| Save time            | No manual copy-paste between platforms       |
| Stay visible         | Keep your GBP profile active and fresh       |
| Reach more customers | Your content appears in Google Search & Maps |
| Consistent branding  | Templates ensure uniform formatting          |

## How Google Business Profile Posts Work

Before setting up Auto-Post, understand what Google expects.

### Post Types

Google supports three post types. Choose based on your content:

| Type       | Use For                    | Duration       | Special Fields     |
| ---------- | -------------------------- | -------------- | ------------------ |
| **Update** | News, tips, announcements  | 7 days         | None               |
| **Event**  | Workshops, webinars, sales | Until end date | Duration, times    |
| **Offer**  | Discounts, promotions      | Until end date | Coupon code, terms |

### Content Limits

Google enforces strict limits:

| Field              | Limit            |
| ------------------ | ---------------- |
| Post text          | 1,500 characters |
| Event title        | 58 characters    |
| Coupon code        | 50 characters    |
| Terms & conditions | 500 characters   |

### Required Elements

Every GBP post needs:

* **Text content** - Your message to customers
* **Post type** - Update, Event, or Offer

Optional but recommended:

* **Image** - Posts with images get 2x more engagement
* **Call-to-action button** - Learn More, Book, Shop, etc.

## Requirements

Before using Auto-Post:

<Callout type="info">
  Auto-Post requires the **Engagement Bundle** add-on or higher plan.
</Callout>

* Active Synoveo subscription with Engagement Bundle
* Verified Google Business Profile location
* Sync enabled for the location
* WordPress API key created and assigned to the location

## Setup Overview

Auto-Post has two configuration layers:

| Layer         | Where             | Who                | What               |
| ------------- | ----------------- | ------------------ | ------------------ |
| **Templates** | Synoveo Dashboard | Admin (once)       | How posts look     |
| **Per-post**  | WordPress Editor  | Editor (each post) | What posts contain |

This separation lets admins control branding while editors focus on content.

***

## Step 1: Dashboard Setup

Configure templates and enable Auto-Post in your Synoveo dashboard.

### 1.1 Navigate to Marketing Hub

1. Log in to [app.synoveo.com](https://app.synoveo.com)
2. Go to **Posts** in the sidebar (opens the Marketing Hub)
3. Select the **Posts** tab
4. Choose your location from the dropdown

<img alt="Marketing Hub with location selector" src={__img0} placeholder="blur" />

### 1.2 Find the Auto-Post Card

Look for the "Auto-Post from WordPress" card. It shows:

* Current status (Active/Inactive)
* Connected WordPress domain
* Current template settings

<img alt="Auto-Post card in dashboard" src={__img1} placeholder="blur" />

<Callout type="warning">
  If you see "Not Available", you need to create a WordPress API key first. Go to **API Keys** in the Integrations section of the sidebar and create one assigned to this location.
</Callout>

### 1.3 Configure Templates

Click the **Configure** button to open the settings dialog.

<img alt="Auto-Post settings dialog" src={__img2} placeholder="blur" />

#### General Settings

| Setting                    | Description                                 |
| -------------------------- | ------------------------------------------- |
| **Default Post Type**      | Used when WordPress doesn't specify a type  |
| **Include Featured Image** | Attach WordPress featured image to GBP post |

#### Per-Type Templates

Each post type has its own template. Click the tabs to configure:

<img alt="Template tabs for each post type" src={__img3} placeholder="blur" />

##### Template Placeholders

Use placeholders that get replaced with your WordPress content:

| Placeholder    | Replaced With                   | Example                                                              |
| -------------- | ------------------------------- | -------------------------------------------------------------------- |
| `{{title}}`    | Post title                      | "Summer Sale Announcement"                                           |
| `{{excerpt}}`  | Post excerpt                    | "Don't miss our biggest sale..."                                     |
| `{{content}}`  | Post content (first 1000 chars) | Full article text                                                    |
| `{{post_url}}` | Post permalink                  | [https://yoursite.com/summer-sale](https://yoursite.com/summer-sale) |
| `{{author}}`   | Author name                     | "John Smith"                                                         |

##### Example Templates

**Update template:**

```
{{title}}

{{excerpt}}

Read more on our website →
```

**Event template:**

```
Join us: {{title}}

{{excerpt}}

Don't miss this opportunity!
```

**Offer template:**

```
Special offer: {{title}}

{{excerpt}}

Limited time only. Terms apply.
```

#### Call-to-Action Buttons

Configure CTA buttons for each post type:

<img alt="CTA button configuration" src={__img4} placeholder="blur" />

| CTA Type     | Best For               |
| ------------ | ---------------------- |
| Learn More   | Blog posts, news       |
| Book         | Services, appointments |
| Order Online | Food, delivery         |
| Shop         | Products, e-commerce   |
| Sign Up      | Events, newsletters    |
| Call         | Service businesses     |

### 1.4 Enable Auto-Post

After configuring templates, toggle the switch to enable Auto-Post:

<img alt="Enable Auto-Post toggle" src={__img5} placeholder="blur" />

***

## Step 2: WordPress Configuration

With templates configured in the dashboard, now set up per-post details in WordPress.

### 2.1 Gutenberg (Block Editor)

The Synoveo panel appears in the WordPress editor sidebar.

#### Finding the Panel

1. Edit any post or page
2. Open the right sidebar (Settings panel)
3. Look for the **Synoveo** panel below the post settings

<img alt="Gutenberg sidebar with Synoveo panel collapsed" src={__img6} placeholder="blur" />

Click on the panel to expand it:

<img alt="Gutenberg sidebar with Synoveo panel open" src={__img7} placeholder="blur" />

#### Enabling Auto-Post

Check the "Publish to Google Business Profile" checkbox:

<img alt="Enabling Auto-Post checkbox" src={__img8} />

#### Selecting Post Type

Choose the type that matches your content:

**Update Post** - For news, announcements, and general updates:

<img alt="Update post type selected" src={__img9} placeholder="blur" />

**Event Post** - For time-based content with schedule:

<img alt="Event post type with settings" src={__img10} placeholder="blur" />

| Field         | Description                                       |
| ------------- | ------------------------------------------------- |
| Duration      | How many days the event runs (1, 3, 7, 14, or 30) |
| All-day event | Toggle for events without specific times          |
| Start time    | Daily start time (for non-all-day events)         |
| End time      | Daily end time (for non-all-day events)           |

<Callout type="info">
  The event starts on your WordPress publish date and runs for the specified duration.
</Callout>

**Offer Post** - For promotions and discounts:

<img alt="Offer post type with settings" src={__img11} placeholder="blur" />

| Field              | Description                                      | Limit          |
| ------------------ | ------------------------------------------------ | -------------- |
| Coupon Code        | Optional discount code                           | 50 characters  |
| Redeem URL         | Where customers redeem (supports `{{post_url}}`) | -              |
| Terms & Conditions | Legal terms for the offer                        | 500 characters |

### 2.2 Elementor

Synoveo adds a custom tab to the Elementor editor.

1. Edit your page with Elementor
2. Look for the **Synoveo** tab in the left panel

<img alt="Elementor Synoveo panel" src={__img12} placeholder="blur" />

The Elementor panel provides the same options as Gutenberg:

* Toggle to enable/disable
* Post type selection
* Event or Offer specific fields

***

## How It All Works Together

Understanding the complete flow helps troubleshoot issues.

### The Publishing Flow

```
┌─────────────────────────────────────────────────────────────┐
│  1. WORDPRESS (You write content)                           │
│     - Post title, content, excerpt                          │
│     - Featured image                                        │
│     - Select post type (Update/Event/Offer)                 │
│     - Fill in offer coupon or event times                   │
└─────────────────────────┬───────────────────────────────────┘
                          │ Publish
                          ▼
┌─────────────────────────────────────────────────────────────┐
│  2. SYNOVEO API (Merges everything)                         │
│     - Fetches your dashboard TEMPLATE                       │
│     - Applies WordPress CONTENT to placeholders             │
│     - Adds offer/event DETAILS from WordPress               │
│     - Attaches featured IMAGE if enabled                    │
└─────────────────────────┬───────────────────────────────────┘
                          │ Creates post
                          ▼
┌─────────────────────────────────────────────────────────────┐
│  3. GOOGLE BUSINESS PROFILE                                 │
│     - Post appears on your profile                          │
│     - Visible in Google Search & Maps                       │
│     - Stays for 7 days (Update) or until end date           │
└─────────────────────────────────────────────────────────────┘
```

### What Comes From Where

| Element          | Source                           | Example                    |
| ---------------- | -------------------------------- | -------------------------- |
| Post text format | Dashboard template               | `Special offer: {{title}}` |
| Actual title     | WordPress post                   | Summer Sale                |
| Actual excerpt   | WordPress post                   | 50% off all items          |
| Post type        | WordPress (or dashboard default) | Offer                      |
| CTA button type  | Dashboard settings               | Shop                       |
| CTA button URL   | WordPress post URL               | yoursite.com/sale          |
| Coupon code      | WordPress per-post               | SUMMER50                   |
| Event times      | WordPress per-post               | 9:00 AM - 5:00 PM          |
| Featured image   | WordPress post                   | sale-banner.jpg            |

### Example: Publishing an Offer

**Dashboard template (set once):**

```
Special offer: {{title}}

{{excerpt}}

Visit our website to redeem!
```

**WordPress post (set per-post):**

* Title: "Summer Clearance Sale"
* Excerpt: "Everything must go! Up to 70% off all summer items."
* Post type: Offer
* Coupon code: CLEAR70
* Terms: "Valid in-store only. While supplies last."

**Final GBP post (created automatically):**

```
Special offer: Summer Clearance Sale

Everything must go! Up to 70% off all summer items.

Visit our website to redeem!

[Shop Now button]
Coupon: CLEAR70
Terms: Valid in-store only. While supplies last.
```

***

## Viewing Post Status

After publishing, check the status in WordPress.

### Status Indicators

The Synoveo panel shows real-time status:

<img alt="Published status indicator" src={__img13} placeholder="blur" />

| Status           | Meaning                    | Action              |
| ---------------- | -------------------------- | ------------------- |
| **Published**    | Successfully posted to GBP | None needed         |
| **Pending**      | Processing or scheduled    | Wait                |
| **Failed**       | Error occurred             | Check error message |
| **Never Posted** | Auto-post not enabled      | Enable if desired   |

### Retrying Failed Posts

If a post fails:

1. Check the error message (hover over the status)
2. Fix the issue (often quota or connection)
3. Click **Retry** to attempt again

***

## Updating Existing Posts

When you update a WordPress post that was already auto-posted:

1. Make your changes in WordPress
2. Click Update/Publish
3. Synoveo will:
   * Delete the old GBP post
   * Create a new one with updated content

<Callout type="info">
  GBP doesn't support editing posts, so Synoveo recreates them. This resets engagement metrics.
</Callout>

***

## Monthly Quota

Auto-posts count toward your monthly GBP post quota:

| Plan              | Monthly Posts |
| ----------------- | ------------- |
| Solo + Engagement | 5             |
| Pro               | 50            |
| Business          | Unlimited     |

Posts are counted when successfully published. Failed posts don't consume quota.

***

## Troubleshooting

### "Auto-Post Not Available"

**Cause:** No WordPress API key assigned to this location.

**Fix:**

1. Go to **API Keys** in the Integrations section of the sidebar
2. Create a new WordPress API key
3. Assign it to your location

### "Post Failed to Publish"

**Common causes:**

| Error                 | Solution                            |
| --------------------- | ----------------------------------- |
| Quota exceeded        | Upgrade plan or wait for next month |
| Google not connected  | Reconnect Google in Settings        |
| Location not verified | Verify location in Google Business  |
| Sync disabled         | Enable sync for this location       |

### "Image Not Included"

**Requirements for images:**

* Featured image must be set in WordPress
* Format: JPEG or PNG only
* Minimum size: 400x300 pixels
* Must be publicly accessible URL
* "Include Featured Image" enabled in dashboard

### "Content Truncated"

GBP has limits. If content is cut off:

* Use shorter excerpts in WordPress
* Template + content must be under 1,500 characters
* Event titles limited to 58 characters

### "Wrong Post Type"

Posts appearing as wrong type:

1. Check WordPress post type selection
2. If not set, dashboard default is used
3. Update WordPress post and republish

***

## Best Practices

### For Admins (Dashboard)

1. **Keep templates simple** - Let WordPress content speak
2. **Use placeholders** - Don't hardcode content in templates
3. **Test with one post** - Verify templates before going live
4. **Set sensible defaults** - Most posts will be Updates

### For Editors (WordPress)

1. **Write good excerpts** - These become your GBP post text
2. **Always set featured image** - 2x more engagement
3. **Choose correct post type** - Offers need coupon fields
4. **Keep titles short** - Google truncates long titles
5. **Check status after publish** - Catch failures early

### Content Tips

| Do                             | Don't                            |
| ------------------------------ | -------------------------------- |
| Use clear, actionable language | Use vague descriptions           |
| Include a call-to-action       | Forget to tell people what to do |
| Add relevant images            | Use generic stock photos         |
| Keep it timely                 | Promote expired offers           |
| Write for local customers      | Use jargon or technical terms    |

***

## FAQ

### Can I disable Auto-Post for specific posts?

Yes. In the WordPress editor, uncheck "Publish to Google Business Profile" for that post.

### What happens when my WordPress post expires?

GBP posts are independent. You'll need to delete them separately from the dashboard or let them expire naturally.

### Can I auto-post to multiple locations?

Yes. Enable Auto-Post for each location separately. Each can have different templates.

### Do drafts get auto-posted?

No. Only posts with "Published" status trigger Auto-Post.

### Can I schedule auto-posts?

Yes. Schedule your WordPress post for a future date. When it publishes, Auto-Post triggers automatically.

### What if I don't have an excerpt?

Synoveo uses the first 1,000 characters of your post content as a fallback.

***

## Next Steps

<Cards>
  <Card title="Schema.org SEO" href="/docs/wordpress/schema-seo" />

  <Card title="Reviews Shortcode" href="/docs/wordpress/reviews-shortcode" />

  <Card title="Local Posts Guide" href="/docs/dashboard/local-posts" />
</Cards>


# WordPress Plugin





The Synoveo WordPress plugin automatically syncs your business data to Google Business Profile, with zero manual work.

<img alt="Synoveo Getting Started page in WordPress" src={__img0} placeholder="blur" />

## Core Features

### Auto-Sync to GBP

Automatically sync your WordPress business data to Google Business Profile:

* Business name, address, phone
* Hours of operation
* Services and products
* Categories and attributes

### Auto-Post

Publish WordPress posts directly to Google as Local Posts:

* **Update posts** - News and announcements
* **Event posts** - Time-based content with dates
* **Offer posts** - Promotions and sales

Works with both Gutenberg and Elementor.

### Schema.org SEO (HyperSEO)

Generate fully valid Schema.org JSON-LD structured data:

* LocalBusiness schema
* Opening hours
* Contact information
* Social profiles

Test and validate with Google's Rich Results Test.

### Reviews Display

Show your Google reviews on your WordPress site:

* `[synoveo_reviews]` - Individual reviews
* `[synoveo_rating_summary]` - Aggregate rating
* Multiple layout options (vertical, horizontal, grid)

## Quick Start

<Steps>
  <Step>
    ### Install the Plugin

    Download from [wordpress.org](https://wordpress.org/plugins/synoveo) or search "Synoveo" in WordPress Plugins
  </Step>

  <Step>
    ### Sign in to Synoveo Hub

    Go to [app.synoveo.com](https://app.synoveo.com) and sign in with Google
  </Step>

  <Step>
    ### Generate API Credentials

    Create an API key in the Hub with your WordPress domain and location
  </Step>

  <Step>
    ### Connect

    Enter your Client ID and Secret in WordPress **Synoveo → Dashboard**
  </Step>

  <Step>
    ### Sync

    Click "Sync Now" to send your data to Google!
  </Step>
</Steps>

## Plugin Integrations

Synoveo auto-detects and extracts data from popular plugins:

| Plugin              | Data Extracted                          |
| ------------------- | --------------------------------------- |
| **WooCommerce**     | Products, categories, business hours    |
| **Yoast SEO**       | Business name, address, social profiles |
| **Rank Math**       | Business schema, local SEO data         |
| **AIOSEO**          | Local business info                     |
| **Amelia**          | Services, booking info                  |
| **Bookly**          | Services, pricing                       |
| **Events Calendar** | Events for Google Posts                 |

## System Requirements

| Requirement | Minimum | Recommended |
| ----------- | ------- | ----------- |
| WordPress   | 5.8+    | 6.0+        |
| PHP         | 7.4+    | 8.0+        |
| MySQL       | 5.7+    | 8.0+        |

## Documentation

<Cards>
  <Card title="Installation" href="/docs/wordpress/installation">
    Step-by-step installation guide
  </Card>

  <Card title="Setup & Configuration" href="/docs/wordpress/setup-configuration">
    Connect your API credentials
  </Card>

  <Card title="Auto-Post" href="/docs/wordpress/auto-post">
    Publish to Google automatically
  </Card>

  <Card title="Schema.org SEO" href="/docs/wordpress/schema-seo">
    Generate structured data
  </Card>

  <Card title="Reviews Shortcode" href="/docs/wordpress/reviews-shortcode">
    Display Google reviews
  </Card>

  <Card title="Plugin Integrations" href="/docs/wordpress/plugin-integrations">
    Supported WordPress plugins
  </Card>

  <Card title="Sync Operations" href="/docs/wordpress/sync-operations">
    Manual and automatic sync
  </Card>

  <Card title="Troubleshooting" href="/docs/wordpress/troubleshooting">
    Common issues and solutions
  </Card>
</Cards>

## Other Platforms

Synoveo supports multiple platforms beyond WordPress:

| Platform       | Status      |
| -------------- | ----------- |
| **WordPress**  | Available   |
| **Shopify**    | Coming Soon |
| **Webflow**    | Coming Soon |
| **Custom/SDK** | Coming Soon |


# Installation













Install the Synoveo plugin to start syncing your WordPress data to Google Business Profile.

## Method 1: WordPress Plugin Directory (Recommended)

<Steps>
  <Step>
    ### Search for Synoveo

    In your WordPress admin, navigate to **Plugins → Add New** and type "Synoveo" in the search box.

        <img alt="Search for Synoveo plugin" src={__img0} placeholder="blur" />
  </Step>

  <Step>
    ### Install the Plugin

    Click **Install Now** on the Synoveo plugin card.

        <img alt="Install Synoveo plugin" src={__img1} placeholder="blur" />
  </Step>

  <Step>
    ### Activate

    Click **Activate** to enable the plugin.

        <img alt="Activate Synoveo plugin" src={__img2} placeholder="blur" />
  </Step>
</Steps>

## Method 2: Manual Upload

If you have a ZIP file:

<Steps>
  <Step>
    ### Go to Plugins

    Navigate to **Plugins → Add New → Upload Plugin**
  </Step>

  <Step>
    ### Upload

    Choose the `synoveo.zip` file and click **Install Now**
  </Step>

  <Step>
    ### Activate

    Click **Activate Plugin**
  </Step>
</Steps>

## Method 3: FTP/SFTP

For advanced users:

1. Extract `synoveo.zip` to your computer
2. Connect to your server via FTP/SFTP
3. Upload the `synoveo` folder to `/wp-content/plugins/`
4. Go to **Plugins** in WordPress admin
5. Click **Activate** on Synoveo

## System Requirements

| Requirement | Minimum | Recommended |
| ----------- | ------- | ----------- |
| WordPress   | 5.8+    | 6.0+        |
| PHP         | 7.4+    | 8.0+        |
| MySQL       | 5.7+    | 8.0+        |

## Verify Installation

After activation, you should see the **Synoveo** menu item in your WordPress admin sidebar.

<img alt="Synoveo menu in WordPress admin" src={__img3} placeholder="blur" />

Clicking on Synoveo will take you to the Getting Started page where you can learn about features and begin setup.

<img alt="Synoveo Getting Started page" src={__img4} placeholder="blur" />

<Callout type="warning">
  If you don't see the Synoveo menu, try deactivating and reactivating the plugin, or check for PHP errors in your server logs.
</Callout>

## Next Steps

<Cards>
  <Card title="Setup & Configuration" href="/docs/wordpress/setup-configuration" />
</Cards>


# Plugin Integrations





Synoveo automatically detects popular WordPress plugins and extracts relevant business data to keep your Google Business Profile in sync.

## How It Works

When you connect Synoveo to WordPress:

1. Synoveo scans your installed plugins
2. Detects supported plugins automatically
3. Extracts business data (hours, services, products, etc.)
4. Uses this data to keep your GBP profile accurate

No configuration needed - if you have a supported plugin, Synoveo uses it.

***

## Supported Plugins

### SEO Plugins

These plugins often contain your business information (name, address, hours).

#### Yoast SEO

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="yoast" size={32} />
</div>

**What Synoveo extracts:**

* Business name and type
* Address and phone number
* Opening hours
* Social profiles (Facebook, Twitter, etc.)

**Requirements:** Yoast SEO 18.0+ with Local SEO data configured

#### Rank Math

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="rankmath" size={32} />
</div>

**What Synoveo extracts:**

* Local business schema data
* Business name and type
* Address and contact info
* Opening hours

**Requirements:** Rank Math 1.0+ with Local SEO module enabled

#### All in One SEO (AIOSEO)

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="aioseo" size={32} />
</div>

**What Synoveo extracts:**

* Local business information
* Address
* Phone number

**Requirements:** AIOSEO 4.0+ with Local Business schema configured

***

### E-Commerce

#### WooCommerce

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="woocommerce" size={32} />
</div>

**What Synoveo extracts:**

* Products and services (for GBP Products)
* Product categories
* Store address
* Business hours (if configured)

**Requirements:** WooCommerce 5.0+ with at least one published product

***

### Booking & Appointments

#### Amelia

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="amelia" size={32} />
</div>

**What Synoveo extracts:**

* Services with descriptions
* Service duration and pricing
* Staff/provider information

**Requirements:** Amelia 1.0+ with at least one service configured

#### Bookly

<div className="flex items-center gap-3 mb-4">
  <VendorIcon name="bookly" size={32} />
</div>

**What Synoveo extracts:**

* Services
* Service pricing
* Duration

**Requirements:** Bookly 20.0+

***

### Events

#### The Events Calendar

**What Synoveo extracts:**

* Event titles and descriptions
* Event dates and times
* Venue information

**Use case:** Events can be converted to Google Posts via Auto-Post.

**Requirements:** The Events Calendar 5.0+

***

## Data Priority

When multiple plugins provide the same information, Synoveo uses this priority:

| Priority | Source                                          |
| -------- | ----------------------------------------------- |
| 1        | Manual override (set in Synoveo dashboard)      |
| 2        | Primary SEO plugin (Yoast > Rank Math > AIOSEO) |
| 3        | WooCommerce                                     |
| 4        | Booking plugins                                 |
| 5        | WordPress core settings                         |

You can customize this in **Synoveo → Settings → Data Sources**.

***

## Viewing Detected Plugins

To see which plugins Synoveo detected:

1. Go to **Synoveo → Dashboard** in WordPress admin
2. Look for the "Detected Plugins" section
3. Green checkmarks indicate active integrations

<img alt="Detected plugins panel" src={__img0} placeholder="blur" />

***

## Request a New Integration

Don't see your plugin listed? We're always adding new integrations.

<Callout type="info">
  **Request a plugin integration** by emailing [support@synoveo.com](mailto:support@synoveo.com) with:

  * Plugin name and link
  * What data you'd like Synoveo to extract
  * Your use case
</Callout>

Popular requests are prioritized for future releases.

***

## Next Steps

<Cards>
  <Card title="Auto-Post Setup" href="/docs/wordpress/auto-post" />

  <Card title="Sync Operations" href="/docs/wordpress/sync-operations" />
</Cards>


# Reviews Shortcode













Show your Google Business Profile reviews directly on your WordPress site using the Synoveo reviews shortcodes.

## Overview

Synoveo provides two shortcodes for displaying Google reviews:

* `[synoveo_reviews]` - Display individual reviews
* `[synoveo_rating_summary]` - Display an aggregate rating summary

## Admin Configuration

Navigate to **Synoveo → Reviews & Ratings** to configure the display options:

<img alt="Reviews admin configuration page" src={__img0} placeholder="blur" />

From this page you can:

* Preview how reviews will appear
* Configure default display settings
* Copy shortcodes to clipboard

## Basic Usage

### Reviews Shortcode

Add this shortcode to any post, page, or widget to display reviews:

```
[synoveo_reviews]
```

### Rating Summary Shortcode

Display an aggregate rating with star visualization:

```
[synoveo_rating_summary]
```

## Shortcode Example

Here's an example of the shortcode configuration in the WordPress editor:

<img alt="Shortcode configuration example" src={__img1} placeholder="blur" />

## Layout Options

### Vertical Layout

Reviews stacked vertically, ideal for sidebars and narrow columns:

<img alt="Reviews displayed in vertical layout" src={__img2} placeholder="blur" />

```
[synoveo_reviews layout="vertical"]
```

### Horizontal Layout

Reviews displayed in a row, great for full-width sections:

<img alt="Reviews displayed in horizontal layout" src={__img3} placeholder="blur" />

```
[synoveo_reviews layout="horizontal"]
```

## Rating Summary Display

The rating summary shortcode shows an aggregate view of your reviews:

<img alt="Rating summary display on frontend" src={__img4} placeholder="blur" />

```
[synoveo_rating_summary]
```

This displays:

* Overall star rating (e.g., 4.8 out of 5)
* Total number of reviews
* Star visualization
* Link to view all reviews on Google

## Shortcode Attributes

### Reviews Attributes

Customize the display with these attributes:

```
[synoveo_reviews limit="5" layout="vertical" min_rating="4"]
```

| Attribute     | Default  | Options                  | Description                 |
| ------------- | -------- | ------------------------ | --------------------------- |
| `limit`       | 5        | 1-20                     | Number of reviews to show   |
| `layout`      | vertical | vertical/horizontal/grid | Display layout              |
| `min_rating`  | 1        | 1-5                      | Minimum star rating to show |
| `show_rating` | true     | true/false               | Show star rating            |
| `show_date`   | true     | true/false               | Show review date            |
| `show_avatar` | true     | true/false               | Show reviewer avatar        |
| `order`       | newest   | newest/highest/lowest    | Sort order                  |

### Rating Summary Attributes

```
[synoveo_rating_summary show_count="true" style="compact"]
```

| Attribute        | Default | Options         | Description             |
| ---------------- | ------- | --------------- | ----------------------- |
| `show_count`     | true    | true/false      | Show review count       |
| `show_stars`     | true    | true/false      | Show star visualization |
| `style`          | default | default/compact | Display style           |
| `link_to_google` | true    | true/false      | Link to Google reviews  |

## Styling

### CSS Classes

The shortcode outputs semantic HTML with classes for styling:

```css
/* Reviews container */
.synoveo-reviews { }

/* Individual review */
.synoveo-review { }
.synoveo-review-rating { }
.synoveo-review-author { }
.synoveo-review-text { }
.synoveo-review-date { }

/* Rating summary */
.synoveo-rating-summary { }
.synoveo-rating-stars { }
.synoveo-rating-count { }
```

### Custom CSS Example

```css
.synoveo-reviews {
  max-width: 800px;
  margin: 0 auto;
}

.synoveo-review {
  background: #f9f9f9;
  padding: 20px;
  border-radius: 8px;
  margin-bottom: 15px;
}

.synoveo-review-rating {
  color: #ffc107;
}

.synoveo-rating-summary {
  text-align: center;
  padding: 30px;
  background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
  border-radius: 12px;
}
```

## Widget Support

Add reviews to sidebars:

1. Go to **Appearance → Widgets**
2. Add a **Text** or **Shortcode** widget
3. Enter the shortcode

## Page Builder Support

### Elementor

1. Add a **Shortcode** widget
2. Enter `[synoveo_reviews]`
3. Customize with attributes

### Gutenberg

1. Add a **Shortcode** block
2. Enter the shortcode
3. Preview in the editor

### Divi

1. Add a **Code** module
2. Enter the shortcode
3. Save and preview

## Caching

Reviews are cached for 12 hours to improve performance. To refresh:

* Wait for cache expiration
* Or clear your WordPress cache

## Requirements

* Synoveo plugin connected and active
* Valid API credentials
* Google Business Profile with reviews

<Callout type="info">
  Reviews are fetched from Google via Synoveo. The number of reviews you can display depends on your plan's API quota.
</Callout>

## Next Steps

<Cards>
  <Card title="Sync Operations" href="/docs/wordpress/sync-operations" />

  <Card title="Troubleshooting" href="/docs/wordpress/troubleshooting" />
</Cards>


# Schema.org SEO (HyperSEO)











Synoveo's HyperSEO feature automatically generates Schema.org JSON-LD structured data for your WordPress site, helping search engines better understand your business.

## What is Schema.org?

Schema.org is a collaborative vocabulary used by search engines to understand web content. Adding structured data helps:

* Improve search result appearance with rich snippets
* Increase click-through rates
* Provide accurate business information to Google

## Accessing Schema Settings

Navigate to **Synoveo → Schema.org SEO** in your WordPress admin to access the HyperSEO settings.

<img alt="Schema.org SEO settings page" src={__img0} placeholder="blur" />

## Configuration Options

### Business Type

Select the Schema.org type that best describes your business:

* **LocalBusiness** (default)
* **Restaurant**
* **Store**
* **ProfessionalService**
* **MedicalBusiness**
* And many more...

### Business Information

Configure the core business details:

* Business name
* Description
* Address (street, city, state, zip, country)
* Phone number
* Website URL
* Email address

### Opening Hours

Set your business hours for each day of the week. These are included in the schema output.

### Social Profiles

Add links to your social media profiles:

* Facebook
* Twitter/X
* Instagram
* LinkedIn
* YouTube

## Schema Preview

Preview your generated JSON-LD structured data before publishing:

<img alt="Schema.org JSON-LD preview" src={__img1} placeholder="blur" />

The preview shows exactly what will be added to your site's HTML. You can verify:

* All fields are populated correctly
* Business type is accurate
* Hours and contact info are formatted properly

## Testing Your Schema

### Copy for Testing

Use the copy button to grab your schema JSON-LD for testing:

<img alt="Copy schema button" src={__img2} placeholder="blur" />

### Google Rich Results Test

Paste your schema into [Google's Rich Results Test](https://search.google.com/test/rich-results) to validate:

<img alt="Google Rich Results Test showing valid schema" src={__img3} placeholder="blur" />

Google will show:

* Whether your schema is valid
* Any warnings or errors
* A preview of how it may appear in search results

## Schema Types Supported

Synoveo generates the following Schema.org types:

| Type                        | Use Case                          |
| --------------------------- | --------------------------------- |
| **LocalBusiness**           | Default for most businesses       |
| **Restaurant**              | Restaurants, cafes, bars          |
| **Store**                   | Retail stores                     |
| **ProfessionalService**     | Lawyers, accountants, consultants |
| **MedicalBusiness**         | Doctors, dentists, clinics        |
| **LodgingBusiness**         | Hotels, B\&Bs                     |
| **FoodEstablishment**       | Food service businesses           |
| **HealthAndBeautyBusiness** | Spas, salons                      |

## Generated Markup

Example of generated JSON-LD:

```json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Your Business Name",
  "description": "Your business description",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main St",
    "addressLocality": "Your City",
    "addressRegion": "State",
    "postalCode": "12345",
    "addressCountry": "US"
  },
  "telephone": "+1-555-123-4567",
  "url": "https://yourbusiness.com",
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "17:00"
    }
  ]
}
```

## How It Works

1. **Automatic Injection** - Schema is automatically added to your site's `<head>` section
2. **No Code Required** - Configure everything through the WordPress admin
3. **Always Valid** - Generated markup follows Schema.org specifications
4. **Real-time Updates** - Changes reflect immediately on your site

## Integration with GBP

When you sync data between Synoveo and Google Business Profile:

* Business information stays consistent
* Hours of operation match across platforms
* Contact details are synchronized

This ensures your Schema.org data and GBP listing show the same information.

## Best Practices

1. **Complete all fields** - More data = better understanding by search engines
2. **Keep information current** - Update hours for holidays and special events
3. **Match GBP data** - Ensure consistency between schema and your Google listing
4. **Test regularly** - Use Google's tools to validate after changes

## Troubleshooting

### Schema not appearing

* Check that the feature is enabled in settings
* Clear your caching plugin
* View page source to verify JSON-LD is present

### Validation errors

* Ensure required fields (name, address) are filled
* Check phone number format (use international format)
* Verify URL is correct and accessible

### Rich snippets not showing

* Schema takes time to be indexed by Google
* Not all schema types get rich snippets
* Google decides which results show enhanced formatting

## Next Steps

<Cards>
  <Card title="Reviews Shortcode" href="/docs/wordpress/reviews-shortcode" />

  <Card title="Sync Operations" href="/docs/wordpress/sync-operations" />
</Cards>


# Setup & Configuration

























After installing the plugin, you need to generate API credentials from the Synoveo Hub and configure your WordPress site.

## Step 1: Sign in to Synoveo Hub

Go to [app.synoveo.com](https://app.synoveo.com) and sign in with your Google account.

<img alt="Synoveo Hub sign in with Google" src={__img0} placeholder="blur" />

<Callout type="info">
  Synoveo uses Google OAuth for authentication. You'll be signed in directly with your Google account - no separate registration required.
</Callout>

## Step 2: Connect Your Google Business Profile

After signing in, navigate to **Locations** to connect and manage your Google Business Profile locations.

<img alt="Locations list in Synoveo Hub" src={__img1} placeholder="blur" />

### Enable Sync for Your Location

Before creating an API key, you must enable sync for the location you want to connect to WordPress:

1. Find your location in the list
2. Toggle the **Sync** switch to ON
3. The location must be verified in Google Business Profile

<Callout type="warning">
  Only locations with sync enabled will appear in the API key creation modal. Make sure to toggle sync ON before proceeding.
</Callout>

## Step 3: Generate API Credentials

<Steps>
  <Step>
    ### Navigate to API Keys

    Click **API Keys** in the sidebar, then click **Create API Key**

        <img alt="Create API Key modal" src={__img2} placeholder="blur" />

    Configure your API key:

    * **Platform**: Select WordPress
    * **Location**: Choose the Google location to sync (only locations with sync enabled appear)
    * **Domain**: Your WordPress site URL
  </Step>

  <Step>
    ### Confirm Creation

    Review your settings and confirm the API key creation.

        <img alt="API Key creation confirmation" src={__img3} placeholder="blur" />
  </Step>

  <Step>
    ### Copy Your Credentials

    Copy the **Client ID** and **Client Secret** displayed.

        <img alt="API Key credentials displayed" src={__img4} placeholder="blur" />

    <Callout type="warning">
      **Important:** The Client Secret is only shown once. Save it securely before closing this dialog!
    </Callout>
  </Step>
</Steps>

## Step 4: Configure WordPress

<Steps>
  <Step>
    ### Open Synoveo Dashboard

    In WordPress admin, go to **Synoveo → Dashboard**. You'll see the disconnected state initially.

        <img alt="Synoveo Dashboard disconnected" src={__img5} placeholder="blur" />
  </Step>

  <Step>
    ### Enter Credentials

    Paste your Client ID and Client Secret in the credentials form.

        <img alt="Enter API credentials" src={__img6} placeholder="blur" />
  </Step>

  <Step>
    ### Connect

    Click **Connect** to establish the connection.
  </Step>

  <Step>
    ### Verify Connection

    You should see the connected state with your Google Business Profile location details.

        <img alt="Synoveo Dashboard connected" src={__img7} placeholder="blur" />

    The dashboard shows:

    * Your connected location name
    * Verification status
    * Last sync time
    * Quick actions for syncing
  </Step>
</Steps>

## Verified Location Indicator

When your location is properly verified with Google, you'll see a verification badge:

<img alt="Verified location indicator" src={__img8} placeholder="blur" />

## Detected Plugins

Synoveo automatically detects compatible WordPress plugins and extracts relevant data:

<img alt="Detected plugins panel" src={__img9} placeholder="blur" />

Supported plugins include:

* **WooCommerce** - Products, categories, business hours
* **Yoast SEO** - Business name, address, social profiles
* **Rank Math** - Business schema, local SEO data
* **Amelia** - Services, booking info
* **Bookly** - Services, pricing
* **Events Calendar** - Events for Google Posts

## Subscription Plans

Synoveo offers different plans with varying features. View and compare plans in the Hub:

<img alt="Billing plans comparison" src={__img10} placeholder="blur" />

| Plan         | Locations | Features                       |
| ------------ | --------- | ------------------------------ |
| **Lite**     | 1         | Basic business info sync       |
| **Solo**     | 1         | Complete profile management    |
| **Pro**      | 3         | Posts, reviews, Q\&A           |
| **Business** | 10        | Analytics, insights, unlimited |

## Settings Reference

| Setting           | Description                           | Default    |
| ----------------- | ------------------------------------- | ---------- |
| **Client ID**     | Your Synoveo API Client ID            | (required) |
| **Client Secret** | Your Synoveo API Secret               | (required) |
| **Auto-Sync**     | Sync automatically on content changes | Off        |
| **Debug Mode**    | Enable verbose logging                | Off        |

## Troubleshooting Connection

If you're having trouble connecting:

1. **Verify credentials** - Make sure you copied both Client ID and Secret correctly
2. **Check location sync** - Ensure sync is enabled for your location in the Hub
3. **Domain match** - The domain in your API key must match your WordPress site URL
4. **Clear cache** - Clear any caching plugins that might interfere

## Next Steps

<Cards>
  <Card title="Plugin Integrations" href="/docs/wordpress/plugin-integrations" />

  <Card title="Auto-Post Setup" href="/docs/wordpress/auto-post" />

  <Card title="Schema.org SEO" href="/docs/wordpress/schema-seo" />
</Cards>


# Sync Operations



Learn how Synoveo synchronizes your WordPress data with Google Business Profile.

## What Gets Synced

Based on your plan, Synoveo syncs these field categories:

### Basic Info (All Plans)

* Business name
* Address
* Phone number
* Website URL
* Business hours

### Extended Profile (Solo+)

* Business description
* Categories
* Basic attributes
* Service area

### Full Engagement (Pro+)

* Local Posts
* Review responses
* Q\&A answers
* Photos and media
* All 600+ attributes

## Sync Methods

### Manual Sync

Trigger a sync manually:

1. Go to **Synoveo → Dashboard**
2. Click **Sync Now**
3. Wait for completion
4. Review results

### Auto-Sync

Enable automatic sync:

1. Go to **Synoveo → Settings**
2. Enable "Auto-Sync"
3. Set frequency (hourly, daily, weekly)

### Content-Triggered Sync

Sync when content changes:

* When you update business info
* When you publish a new post (with auto-post enabled)
* When you update products/services

## Sync Status

Check sync status in **Synoveo → Sync History**:

| Status                  | Meaning                           |
| ----------------------- | --------------------------------- |
| <IconCheck /> Success   | All data synced successfully      |
| <IconWarning /> Partial | Some fields synced, others failed |
| <IconX /> Failed        | Sync failed (see error details)   |
| In Progress             | Sync currently running            |

## Sync Preview

Before syncing, preview what will change:

1. Go to **Synoveo → Dashboard**
2. Click **Preview Sync**
3. Review the comparison:
   * **Local**: Your WordPress data
   * **Google**: Current GBP data
   * **Changes**: What will be updated

## Field-Level Control

Control what syncs at the field level:

1. Go to **Synoveo → Field Settings**
2. Toggle individual fields on/off
3. Fields you disable won't sync

<Callout type="info">
  Your plan determines which fields are available. Disabled fields won't sync even if you enable them.
</Callout>

## Conflict Resolution

When data differs between WordPress and Google:

### WordPress Wins (Default)

WordPress data overwrites Google. Use when WordPress is your source of truth.

### Google Wins

Keep Google data, don't overwrite. Use when you want to manage some fields directly in Google.

### Manual Review

Flag conflicts for manual resolution. See conflicts in **Synoveo → Conflicts**.

## Sync Logs

View detailed logs in **Synoveo → Logs**:

* Timestamp
* Fields synced
* Success/failure status
* Error messages

Enable debug mode for verbose logging:

```php
// In wp-config.php
define('SYNOVEO_DEBUG', true);
```

## Best Practices

1. **Test first** - Use Preview before syncing
2. **Start small** - Enable fields gradually
3. **Monitor** - Check sync status regularly
4. **Backup** - Keep a record of your GBP state before major syncs

## Next Steps

<Cards>
  <Card title="Troubleshooting" href="/docs/wordpress/troubleshooting" />

  <Card title="Dashboard Guide" href="/docs/dashboard" />
</Cards>


# WordPress Troubleshooting



Solutions to common problems with the Synoveo WordPress plugin.

## Connection Issues

### "Connection Failed" Error

**Symptoms:** Red "Disconnected" status, unable to sync

**Solutions:**

1. Verify your Client ID and Secret are correct
2. Check your domain matches the API key domain
3. Ensure your server can reach `api.synoveo.com`
4. Check for firewall blocking outbound HTTPS

```php
// Test API connectivity
add_action('init', function() {
  $response = wp_remote_get('https://api.synoveo.com/health');
  var_dump(wp_remote_retrieve_response_code($response));
});
```

### "Invalid Credentials" Error

**Symptoms:** Credentials rejected on save

**Solutions:**

1. Regenerate credentials in Synoveo dashboard
2. Copy/paste carefully (no extra spaces)
3. Ensure the API key hasn't been revoked

### "Domain Mismatch" Error

**Symptoms:** Connection rejected due to domain

**Solutions:**

1. Check the domain in your API key settings
2. Must match your WordPress site URL exactly
3. Include or exclude `www.` consistently

## Sync Issues

### "Sync Failed" Error

**Symptoms:** Sync starts but fails to complete

**Solutions:**

1. Check your plan has the required fields
2. Verify location is verified in Google
3. Check sync is enabled for the location
4. Review error details in **Synoveo → Logs**

### "No Data to Sync" Error

**Symptoms:** Sync completes but nothing changed

**Solutions:**

1. Check data sources are enabled
2. Verify plugin integrations are detected
3. Ensure content exists to sync (products, posts, etc.)

### "Rate Limited" Error

**Symptoms:** Too many sync attempts blocked

**Solutions:**

1. Wait for rate limit to reset (usually 1 hour)
2. Reduce sync frequency
3. Consider upgrading your plan

## Auto-Post Issues

### "Posts Not Publishing to Google"

**Solutions:**

1. Verify you have Pro plan or higher
2. Check auto-post is enabled
3. Ensure the post type is selected for auto-post
4. Check post has a featured image
5. Review **Synoveo → Post History** for errors

### "Image Not Included in Post"

**Solutions:**

1. Set a featured image on the WordPress post
2. Image must be JPEG or PNG
3. Minimum size: 400x300 pixels
4. Check image URL is publicly accessible

## Reviews Issues

### "Reviews Not Displaying"

**Solutions:**

1. Check shortcode syntax: `[synoveo_reviews]`
2. Verify API credentials are connected
3. Ensure location has reviews in Google
4. Clear WordPress cache

### "Stale Reviews"

**Solutions:**

1. Reviews cache for 12 hours
2. Clear page cache to see updates
3. Wait for cache refresh

## Plugin Conflicts

### Common Conflicts

| Plugin               | Issue             | Solution                        |
| -------------------- | ----------------- | ------------------------------- |
| **Caching plugins**  | Stale data        | Exclude Synoveo AJAX from cache |
| **Security plugins** | Blocked API calls | Whitelist `api.synoveo.com`     |
| **SEO plugins**      | Duplicate data    | Set source priority in Synoveo  |

### Debug Mode

Enable debug mode to troubleshoot:

```php
// In wp-config.php
define('SYNOVEO_DEBUG', true);
define('WP_DEBUG_LOG', true);
```

Check `/wp-content/debug.log` for detailed errors.

## Server Requirements

### PHP Extensions

Required extensions:

* `curl`
* `json`
* `mbstring`

Check with:

```php
<?php phpinfo(); ?>
```

### Memory Limit

Minimum 128MB recommended:

```php
// In wp-config.php
define('WP_MEMORY_LIMIT', '256M');
```

## Getting Help

If you're still stuck:

1. Enable debug mode and collect logs
2. Note your WordPress, PHP, and plugin versions
3. Contact support at [support@synoveo.com](mailto:support@synoveo.com)

<Card title="Contact Support" href="/docs/troubleshooting/contact-support" />


# Custom Integration (SDK)



<Callout type="info">
  **Coming Soon** - The TypeScript/JavaScript SDK is currently in development.
</Callout>

## What to Expect

The Synoveo SDK will provide:

* **TypeScript support** - Full type definitions for all API endpoints
* **Easy authentication** - Handle API keys and OAuth tokens automatically
* **Webhook handling** - Process real-time updates from Google
* **Rate limiting** - Built-in request throttling and retry logic

## Planned SDK Features

```typescript
// Example usage (coming soon)
import { SynoveoClient } from '@synoveo/sdk';

const client = new SynoveoClient({
  apiKey: 'your-api-key',
});

// Sync business data
await client.sync.push({
  locationId: 'locations/123',
  data: {
    title: 'My Business',
    phoneNumbers: { primaryPhone: '+1-555-123-4567' },
    regularHours: { /* ... */ }
  }
});

// Listen for updates
client.webhooks.on('location.updated', (event) => {
  console.log('Location updated:', event.location);
});
```

## Current REST API

While the SDK is in development, you can use the REST API directly:

### Authentication

```bash
# Using API Key
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.synoveo.com/api/v1/google-business/locations
```

### Sync Data

```bash
curl -X POST https://api.synoveo.com/api/v1/google-business/sync \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Business", ...}'
```

## Use Cases

The API/SDK is ideal for:

| Use Case            | Example                                             |
| ------------------- | --------------------------------------------------- |
| **Custom CMS**      | Sync from headless CMS (Sanity, Contentful, Strapi) |
| **POS Systems**     | Update hours/services from point-of-sale            |
| **Booking Systems** | Sync services from custom booking platforms         |
| **Multi-location**  | Manage 100+ locations programmatically              |
| **White-label**     | Build GBP management into your SaaS product         |

## Get Started Now

You can start building with the REST API today:

<Cards>
  <Card title="API Reference" href="/api-reference">
    Full API documentation
  </Card>

  <Card title="Authentication" href="/api-reference/authentication">
    API keys and OAuth
  </Card>

  <Card title="Sync Endpoints" href="/api-reference/endpoints/sync">
    Push data to Google
  </Card>

  <Card title="Webhooks" href="/api-reference/webhooks">
    Receive real-time updates
  </Card>
</Cards>

## Get SDK Updates

Want to be notified when the SDK launches?

1. Sign in to [app.synoveo.com](https://app.synoveo.com)
2. Go to **Settings → Notifications**
3. Enable "New Feature Announcements"

Or star the repository on GitHub (coming soon).


# Shopify Integration



<Callout type="info">
  **Coming Soon** - The Shopify integration is currently in development.
</Callout>

## What to Expect

The Synoveo Shopify app will allow you to:

* **Auto-sync product data** - Keep your Google Business Profile updated with your Shopify catalog
* **Business info sync** - Sync store hours, address, and contact details
* **Auto-post products** - Publish new products as Google Posts
* **Review display** - Show Google reviews in your Shopify store

## Planned Features

| Feature        | Description                          |
| -------------- | ------------------------------------ |
| Product Sync   | Automatically sync products to GBP   |
| Store Info     | Sync business name, hours, address   |
| Auto-Post      | Post new products to Google          |
| Reviews        | Display Google reviews via Liquid    |
| Multi-location | Support for multiple store locations |

## Get Notified

Want to be notified when the Shopify integration launches?

1. Sign in to [app.synoveo.com](https://app.synoveo.com)
2. Go to **Settings → Notifications**
3. Enable "New Feature Announcements"

## Current Alternatives

While the Shopify app is in development, you can:

* **Use the REST API** - Build a custom integration with the [Synoveo API](/api-reference)
* **Use the Dashboard** - Manually manage your GBP from [app.synoveo.com](https://app.synoveo.com)

<Cards>
  <Card title="API Reference" href="/api-reference">
    Build custom integrations
  </Card>

  <Card title="Dashboard Guide" href="/docs/dashboard">
    Manage GBP manually
  </Card>
</Cards>


# Webflow Integration



<Callout type="info">
  **Coming Soon** - The Webflow integration is currently in development.
</Callout>

## What to Expect

The Synoveo Webflow app will allow you to:

* **CMS sync** - Sync Webflow CMS data to your Google Business Profile
* **Business info sync** - Keep your GBP updated with site changes
* **Auto-post** - Publish CMS items as Google Posts
* **Review embeds** - Display Google reviews using Webflow embeds

## Planned Features

| Feature       | Description                              |
| ------------- | ---------------------------------------- |
| CMS Sync      | Sync Webflow CMS collections to GBP      |
| Site Info     | Sync business details from site settings |
| Auto-Post     | Post CMS items to Google automatically   |
| Reviews Embed | Embed Google reviews on your site        |
| E-commerce    | Sync Webflow E-commerce products         |

## Get Notified

Want to be notified when the Webflow integration launches?

1. Sign in to [app.synoveo.com](https://app.synoveo.com)
2. Go to **Settings → Notifications**
3. Enable "New Feature Announcements"

## Current Alternatives

While the Webflow app is in development, you can:

* **Use the REST API** - Build a custom integration with the [Synoveo API](/api-reference)
* **Use the Dashboard** - Manually manage your GBP from [app.synoveo.com](https://app.synoveo.com)
* **Embed Reviews** - Use our embed code to display reviews on any site

<Cards>
  <Card title="API Reference" href="/api-reference">
    Build custom integrations
  </Card>

  <Card title="Dashboard Guide" href="/docs/dashboard">
    Manage GBP manually
  </Card>
</Cards>


# WordPress Quick Start



























Connect your WordPress site to Google Business Profile and start syncing automatically.

## Prerequisites

Before you begin, make sure you have:

* A WordPress site (5.8 or higher)
* A Google Business Profile account
* Admin access to your WordPress site

## Step 1: Install the Plugin

In your WordPress admin, navigate to **Plugins → Add New** and search for "Synoveo".

<img alt="Search for Synoveo plugin" src={__img0} placeholder="blur" />

Click **Install Now**, then **Activate**.

<img alt="Install Synoveo plugin" src={__img1} placeholder="blur" />

After activation, you'll see the Synoveo menu in your sidebar:

<img alt="Synoveo menu in WordPress" src={__img2} placeholder="blur" />

## Step 2: Sign in to Synoveo Hub

Go to [app.synoveo.com](https://app.synoveo.com) and sign in with your Google account.

<img alt="Synoveo Hub sign in" src={__img3} placeholder="blur" />

<Callout type="info">
  Synoveo uses Google OAuth. No separate registration required - just sign in with Google.
</Callout>

## Step 3: Enable Location Sync

Navigate to **Locations** in the Hub. Find your location and toggle **Sync** to ON.

<img alt="Locations list in Synoveo Hub" src={__img4} placeholder="blur" />

<Callout type="warning">
  Your location must have sync enabled before you can create an API key for it.
</Callout>

## Step 4: Create API Credentials

Go to **API Keys** and click **Create API Key**.

<img alt="Create API Key" src={__img5} placeholder="blur" />

Configure:

* **Platform**: WordPress
* **Location**: Your Google location (only sync-enabled locations appear)
* **Domain**: Your WordPress site URL

Confirm the creation:

<img alt="Confirm API Key creation" src={__img6} placeholder="blur" />

Copy your **Client ID** and **Client Secret**:

<img alt="Copy credentials" src={__img7} placeholder="blur" />

<Callout type="warning">
  Save your Client Secret now - it's only shown once!
</Callout>

## Step 5: Connect WordPress

In WordPress, go to **Synoveo → Dashboard**:

<img alt="Synoveo Dashboard disconnected" src={__img8} placeholder="blur" />

Enter your credentials:

<img alt="Enter credentials" src={__img9} placeholder="blur" />

Click **Connect**. You should see the connected state:

<img alt="Synoveo Dashboard connected" src={__img10} placeholder="blur" />

## Step 6: Sync Your Data

Click **Sync Now** to send your WordPress data to Google Business Profile.

Synoveo automatically detects data from popular plugins:

<img alt="Detected plugins" src={__img11} placeholder="blur" />

## You're Done!

Your WordPress site is now connected to Google Business Profile. Synoveo will:

* Keep your business info synchronized
* Auto-detect changes from plugins like WooCommerce, Yoast, Rank Math
* Optionally auto-post content to Google

## Next Steps

<Cards>
  <Card title="Auto-Post Setup" href="/docs/wordpress/auto-post">
    Publish WordPress posts to Google
  </Card>

  <Card title="Schema.org SEO" href="/docs/wordpress/schema-seo">
    Generate structured data
  </Card>

  <Card title="Reviews Shortcode" href="/docs/wordpress/reviews-shortcode">
    Display Google reviews on your site
  </Card>

  <Card title="Full WordPress Docs" href="/docs/wordpress">
    Complete documentation
  </Card>
</Cards>


# Competitor Analysis



Understanding your local competitors helps you identify opportunities and develop winning strategies.

## Identifying Competitors

### Local Pack Competitors

Search your target keywords and note:

* Who appears in the 3-pack
* Who appears consistently
* Who ranks for multiple keywords
* Geographic coverage of competitors

### Organic Competitors

Look beyond the local pack:

* Organic search results
* National brands with local presence
* Industry directories
* Review sites

### Rising Competitors

Watch for newcomers:

* New businesses in area
* Established businesses improving
* Franchises entering market
* Online-first competitors

## GBP Competitive Analysis

### Profile Completeness

**Compare:**

| Factor            | You | Competitor A | Competitor B |
| ----------------- | --- | ------------ | ------------ |
| Categories        |     |              |              |
| Attributes        |     |              |              |
| Description       |     |              |              |
| Services/Products |     |              |              |
| Q\&A              |     |              |              |

### Review Analysis

**Metrics to compare:**

* Total review count
* Average rating
* Review velocity (new reviews per month)
* Response rate
* Response time

**Qualitative analysis:**

* Common praise they receive
* Common complaints
* Keywords customers use
* Service highlights

### Visual Content

**Compare photo presence:**

* Total photo count
* Photo categories covered
* Photo quality
* Customer photos vs owner photos
* Recent additions

### Posting Activity

**Analyze their posts:**

* Posting frequency
* Post types used
* Engagement levels
* Content themes
* CTA effectiveness

## Website Competitive Analysis

### Local Content

**Evaluate:**

* Location pages quality
* Local content depth
* Blog/resources about local topics
* Service area coverage

### Technical Performance

**Compare:**

* Page speed scores
* Mobile friendliness
* Core Web Vitals
* Site architecture

### Backlink Profile

**Analyze:**

* Total backlinks
* Local backlinks
* Domain authority
* Referring domains
* Anchor text distribution

### On-Page Optimization

**Review:**

* Title tags
* Meta descriptions
* Header structure
* Keyword usage
* Schema markup

## Citation Analysis

### Citation Presence

**Check competitors on:**

* Major directories
* Industry directories
* Local directories
* Social platforms

### Citation Quality

**Compare:**

* Profile completeness
* Consistency
* Claimed vs unclaimed
* Reviews on directories

## Market Position Analysis

### Strengths and Weaknesses

Create SWOT for each competitor:

**Strengths:**

* What do they do well?
* Where do they outperform?
* What advantages do they have?

**Weaknesses:**

* Where do they fall short?
* What complaints do they receive?
* What gaps exist?

**Opportunities:**

* What could you do better?
* What are they missing?
* Where is the market underserved?

**Threats:**

* What might they improve?
* Are they investing in local?
* Do they have more resources?

### Competitive Gaps

Identify where you can differentiate:

* Service areas they don't cover
* Services they don't offer
* Customer segments they ignore
* Quality issues you can address

## Review Intelligence

### Competitor Review Mining

**Analyze their reviews for:**

* Features customers love
* Pain points mentioned
* Expectations not met
* Service differentiators

### Sentiment Analysis

**Track:**

* Overall sentiment trends
* Common positive themes
* Common negative themes
* How they handle complaints

### Opportunity Identification

**Look for:**

* Consistent complaints you can address
* Unmet needs in the market
* Service gaps
* Quality standards not being met

## Tracking Competitors

### Regular Monitoring

**Weekly:**

* Local pack position changes
* New reviews received
* Post activity

**Monthly:**

* Review count changes
* Rating changes
* Profile changes

**Quarterly:**

* Full competitive audit
* Strategy adjustments
* New competitor identification

### Tracking Tools

**Free options:**

* Manual monitoring
* Google Alerts
* Review platform notifications

**Paid options:**

* Rank tracking tools
* Review monitoring platforms
* Local SEO platforms

## Competitive Strategies

### When Behind

If competitors outrank you:

* Identify specific gaps
* Prioritize highest-impact fixes
* Build review momentum
* Increase content quality
* Improve citation profile

### When Leading

If you're ahead:

* Maintain momentum
* Watch for rising competitors
* Continue optimization
* Don't become complacent
* Innovate and differentiate

### Market Disruption

To leap ahead:

* Find underserved segments
* Create superior content
* Build community presence
* Develop unique value proposition
* Invest in customer experience

## Competitive Intelligence Ethics

### Acceptable Practices

* Analyzing public information
* Monitoring public profiles
* Reading public reviews
* Searching for their rankings
* Analyzing their content

### Unacceptable Practices

* Fake reviews (positive or negative)
* Impersonation
* Hacking or unauthorized access
* Spreading misinformation
* Unethical link schemes

## Actionable Insights

### Creating Action Plans

From competitive analysis:

1. Identify 3-5 key gaps
2. Prioritize by impact
3. Create specific tactics
4. Set measurable goals
5. Track progress

### Example Actions

**If they have more reviews:**

* Implement review generation strategy
* Improve review request process
* Make leaving reviews easier

**If they rank higher:**

* Analyze their GBP optimization
* Improve category/attribute selection
* Enhance website local content

**If they post more:**

* Create content calendar
* Develop post templates
* Assign posting responsibility

## Key Takeaways

1. Know who your real competitors are locally
2. Analyze both GBP and website presence
3. Learn from their reviews and customer feedback
4. Find gaps you can exploit
5. Monitor continuously and adapt strategy

<Cards>
  <Card title="Local SEO Audits" href="/docs/local-seo-guide/advanced/local-seo-audits" />

  <Card title="Future of Local SEO" href="/docs/local-seo-guide/advanced/future-of-local-seo" />
</Cards>


# Future of Local SEO



Local SEO continues to evolve with technology and consumer behavior. Stay ahead by understanding where local search is heading.

## Current Trends

### Zero-Click Searches

**What's happening:**

* More answers directly in search results
* GBP provides information without clicks
* Users get what they need faster

**Implications:**

* Profile completeness more important
* Every GBP field is potential zero-click answer
* Website traffic may decrease
* Conversions shift to direct actions (calls, directions)

### Mobile Dominance

**The shift:**

* Mobile searches now majority
* "Near me" searches continue growing
* Voice search increasing
* Mobile-first experience expected

**Adaptations needed:**

* Mobile-optimized everything
* Click-to-call prominence
* Quick-loading pages
* Thumb-friendly design

### AI in Local Search

**Google's AI integration:**

* AI-generated summaries
* Conversational search
* Better understanding of intent
* Personalized results

**What it means:**

* Content quality matters more
* Natural language optimization
* Context and relevance priority
* Less gaming the system

## Emerging Technologies

### Voice Search

**Current state:**

* Growing but not dominant
* Used for simple queries
* Local queries common
* Smart speakers in homes

**Optimization:**

* Conversational keywords
* Question-based content
* Featured snippet targeting
* Clear, concise answers

### AI Assistants

**Development:**

* Siri, Alexa, Google Assistant
* Task completion capabilities
* Booking and reservation integration
* Recommendation engines

**Preparation:**

* Ensure booking systems integrate
* Complete all GBP features
* Accurate real-time data
* Reserve with Google features

### Augmented Reality

**Emerging use cases:**

* AR directions and navigation
* Business visualization
* Virtual tours
* Product previews

**Early preparation:**

* High-quality 360 photos
* Virtual tours
* Accurate location data
* Rich media presence

## Consumer Behavior Changes

### Expectation of Immediacy

**Trends:**

* Real-time availability expected
* Instant communication
* Same-day service preference
* Live updates demanded

**Responses:**

* Real-time hour updates
* Messaging feature use
* Live inventory (where applicable)
* Quick response times

### Trust and Transparency

**Shift:**

* More skepticism of marketing
* Peer reviews highly valued
* Authenticity matters
* Behind-the-scenes interest

**Adaptations:**

* Genuine review generation
* Authentic responses
* Real photos (not stock)
* Transparent practices

### Local Preference

**Movement:**

* Support local businesses trend
* Community connection valued
* Sustainability considerations
* Personal relationships matter

**Leverage:**

* Emphasize local ownership
* Community involvement
* Local partnerships
* Story telling

## Platform Evolution

### Google Business Profile Changes

**Observed trends:**

* More features added regularly
* Increased engagement options
* Performance insights expansion
* Integration with other Google services

**Stay prepared:**

* Monitor for new features
* Early adoption advantage
* Complete profile always
* Engage with all features

### Apple Maps Growth

**Development:**

* Significant investment by Apple
* Apple Business Connect expanding
* Growing market share
* Unique features developing

**Action:**

* Claim Apple Business Connect
* Keep information synced
* Monitor Apple Maps presence
* Don't ignore non-Google

### Social Local Integration

**Trends:**

* Instagram local discovery
* TikTok local content
* Facebook local features
* Social proof importance

**Strategy:**

* Presence on relevant platforms
* Local social content
* Social citations value
* Engagement on social

## Algorithm Evolution

### E-E-A-T for Local

**Experience, Expertise, Authority, Trust:**

* Applied to local results
* Credentials matter more
* Reputation signals important
* Quality over quantity

**Building E-E-A-T:**

* Showcase credentials
* Expert content creation
* Industry authority building
* Trust signals everywhere

### Entity Understanding

**Development:**

* Google understanding entities better
* Connections between entities
* Knowledge graph integration
* Brand as entity

**Optimization:**

* Consistent entity information
* Schema markup importance
* Wikipedia/knowledge panel
* Brand building

### User Signals

**Importance growing:**

* Engagement metrics
* Click-through rates
* Time on site
* Action completion

**Focus:**

* User experience priority
* Compelling profile presentation
* Easy action completion
* Satisfaction indicators

## Preparation Strategies

### Foundation First

**Ensure basics are solid:**

* Complete, accurate GBP
* Consistent NAP everywhere
* Strong review presence
* Mobile-friendly website

### Adaptability

**Build flexible systems:**

* Easy to update information
* Quick content publication
* Responsive to changes
* Monitoring in place

### Diversification

**Don't rely on one channel:**

* Multiple discovery platforms
* Various traffic sources
* Different customer touchpoints
* Backup strategies

### Continuous Learning

**Stay informed:**

* Industry news and updates
* Google announcements
* Competitor innovations
* Technology developments

## What Won't Change

### Relevance

Google will always prioritize:

* Matching user intent
* Solving user problems
* Providing accurate information
* Quality results

### Trust

Businesses will always need:

* Positive reputation
* Customer satisfaction
* Transparent practices
* Reliable information

### User Experience

Success will always require:

* Easy interactions
* Quick information access
* Problem resolution
* Positive experiences

## Key Takeaways

1. Mobile and voice search continue growing
2. AI is changing how search works
3. User experience becomes more important
4. Multiple platforms matter
5. Fundamentals remain essential

<Cards>
  <Card title="GBP API" href="/docs/local-seo-guide/advanced/gbp-api" />

  <Card title="Local SEO Fundamentals" href="/docs/local-seo-guide/fundamentals" />
</Cards>


# GBP API



The Google Business Profile API enables automation of profile management, data retrieval, and integration with other systems.

## API Overview

### What is the GBP API?

The Google Business Profile API (formerly Google My Business API) allows programmatic access to:

* Profile information management
* Location data
* Reviews
* Posts
* Insights and metrics
* Media (photos/videos)

### Use Cases

* **Multi-location management**: Bulk updates across locations
* **Automated posting**: Scheduled content publication
* **Review monitoring**: Real-time review alerts
* **Data integration**: Sync with CRM/POS systems
* **Reporting**: Automated analytics collection
* **Quality control**: Automated auditing

## API Access

### Getting Access

The GBP API requires:

1. Google Cloud Project
2. API enabled in Cloud Console
3. OAuth 2.0 credentials
4. Account-level access to locations

### Access Levels

* **Owner**: Full API access
* **Manager**: Most API operations
* **Site Manager**: Limited access

### Rate Limits

* Requests per minute limits apply
* Varies by endpoint
* Batch operations help efficiency
* Respect quotas to avoid throttling

## Core API Endpoints

### Account Management API

Manage accounts and locations:

* List accounts
* Get account details
* Manage user access
* List locations under account

### Business Information API

Manage profile data:

* Read/write business information
* Categories and attributes
* Hours of operation
* Service areas
* Contact information

### Reviews API

Handle reviews:

* List reviews
* Get review details
* Reply to reviews
* Cannot delete reviews via API

### Posts API

Manage Google posts:

* Create posts (updates, offers, events)
* List existing posts
* Delete posts
* Track post performance

### Media API

Handle photos and videos:

* Upload media
* List media
* Delete media
* Set cover/profile photos

### Insights API

Access performance data:

* Search queries
* Customer actions
* Direction requests
* Phone calls
* Website clicks

## Implementation Patterns

### Authentication Flow

```
1. User authorizes application
2. Receive authorization code
3. Exchange for access/refresh tokens
4. Store refresh token securely
5. Use access token for API calls
6. Refresh token when expired
```

### Token Management

* Access tokens expire (typically 1 hour)
* Refresh tokens are long-lived
* Store tokens encrypted
* Implement automatic refresh
* Handle token revocation

### Error Handling

Common errors to handle:

* **401**: Authentication failed
* **403**: Permission denied
* **404**: Resource not found
* **429**: Rate limit exceeded
* **500**: Server error

### Best Practices

* Use exponential backoff for retries
* Batch operations when possible
* Cache frequently accessed data
* Monitor API quota usage
* Log all API interactions

## Common Operations

### Updating Business Hours

```
Endpoint: PATCH /locations/{locationId}
Payload: regularHours object
Considerations:
- Use 24-hour format
- Include all days
- Handle special hours separately
```

### Responding to Reviews

```
Endpoint: PUT /locations/{locationId}/reviews/{reviewId}/reply
Payload: comment string
Considerations:
- Maximum 4096 characters
- Can update existing reply
- Cannot delete replies via API
```

### Creating Posts

```
Endpoint: POST /locations/{locationId}/localPosts
Payload: post object with type, text, media
Considerations:
- Posts expire after 7 days (updates) or event date
- Media must be uploaded first
- CTA buttons available
```

### Retrieving Insights

```
Endpoint: GET /locations/{locationId}/insights
Parameters: metric types, time range
Considerations:
- Data may be delayed
- Some metrics aggregated
- Historical data limits
```

## Automation Strategies

### Scheduled Operations

* Daily: Sync hours, check reviews
* Weekly: Update posts, collect insights
* Monthly: Audit information, generate reports

### Event-Driven Operations

* New review: Alert and queue response
* Information change: Validate and approve
* Performance threshold: Trigger notification

### Bulk Operations

* Multi-location updates
* Batch API calls
* Parallel processing with rate limiting

## Integration Examples

### CRM Integration

* Sync customer reviews to CRM
* Track review responses
* Link reviews to customer records

### POS Integration

* Update hours from POS schedule
* Sync product availability
* Post specials from POS promotions

### Website Integration

* Display reviews on website
* Show current hours
* Embed location information

### Reporting Integration

* Export insights to analytics tools
* Automated report generation
* Performance dashboards

## Security Considerations

### Token Security

* Encrypt tokens at rest
* Secure transmission (HTTPS)
* Limited token scope
* Regular token rotation

### Access Control

* Principle of least privilege
* Role-based API access
* Audit logging
* Access reviews

### Data Protection

* Minimize data retention
* Secure data storage
* Compliance with regulations
* Privacy considerations

## Monitoring and Debugging

### Logging

Track all API interactions:

* Request timestamps
* Endpoints called
* Response codes
* Error messages

### Alerting

Set up alerts for:

* High error rates
* Rate limit warnings
* Authentication failures
* Unusual activity

### Debugging Tools

* Google Cloud Console logs
* API Explorer for testing
* Postman collections
* SDK debug modes

## Third-Party Platforms

### Why Use Platforms Like Synoveo

Instead of building API integration yourself:

* Pre-built functionality
* Maintained and updated
* Support included
* Faster implementation

### Platform Benefits

* User-friendly interface
* No coding required
* Best practices built-in
* Ongoing feature updates

### When to Build Custom

* Unique integration needs
* Full control required
* Specific workflow automation
* Developer resources available

## Key Takeaways

1. The GBP API enables powerful automation
2. Proper authentication and token management is critical
3. Respect rate limits and implement error handling
4. Consider using platforms for easier management
5. Security should be a primary concern

<Cards>
  <Card title="Insights & Analytics" href="/docs/local-seo-guide/advanced/insights-and-analytics" />

  <Card title="Local SEO Audits" href="/docs/local-seo-guide/advanced/local-seo-audits" />
</Cards>


# Advanced Topics



Take your local SEO to the next level with advanced strategies, API automation, and data-driven optimization.

## Topics

<Cards>
  <Card title="GBP API" href="/docs/local-seo-guide/advanced/gbp-api" description="Automation and integration" />

  <Card title="Insights & Analytics" href="/docs/local-seo-guide/advanced/insights-and-analytics" description="Data-driven decisions" />

  <Card title="Local SEO Audits" href="/docs/local-seo-guide/advanced/local-seo-audits" description="Comprehensive analysis" />

  <Card title="Competitor Analysis" href="/docs/local-seo-guide/advanced/competitor-analysis" description="Competitive intelligence" />

  <Card title="Future of Local SEO" href="/docs/local-seo-guide/advanced/future-of-local-seo" description="Trends and predictions" />
</Cards>


# Insights & Analytics



GBP Insights provide valuable data about how customers find and interact with your business. Use this data to optimize your local presence.

## Available Metrics

### Discovery Metrics

**How customers find you:**

* **Direct searches**: Searched for your business name
* **Discovery searches**: Searched for category/product/service
* **Branded searches**: Searched for related brand

**What this tells you:**

* Direct = brand awareness
* Discovery = local SEO effectiveness
* High discovery = good keyword optimization

### Visibility Metrics

**Where customers see you:**

* **Search views**: Seen in Google Search
* **Maps views**: Seen in Google Maps
* **Total views**: Combined visibility

**Trends to watch:**

* Growing views = improving visibility
* Search vs Maps ratio varies by business
* Mobile typically dominates Maps views

### Action Metrics

**What customers do:**

* **Website clicks**: Clicked to your website
* **Direction requests**: Asked for directions
* **Phone calls**: Called your business
* **Messages**: Sent a message

**Conversion indicators:**

* High actions relative to views = engaged audience
* Low actions = profile or relevance issues
* Compare to competitors if possible

### Photo Metrics

**Photo engagement:**

* Views of your photos
* Comparison to similar businesses
* Most viewed photos

## Interpreting Data

### Benchmarking

**Against yourself:**

* Week over week comparison
* Month over month trends
* Year over year seasonality

**Against category:**

* GBP shows category averages (when available)
* Above average = outperforming
* Below average = room for improvement

### Identifying Patterns

**Seasonal patterns:**

* Holiday impacts
* Weather effects
* Industry seasonality
* Event-driven spikes

**Weekly patterns:**

* Best performing days
* Action timing
* Customer behavior cycles

### Warning Signs

**Declining views:**

* Lost rankings
* Competitor gains
* Algorithm changes
* Profile issues

**Low action rates:**

* Poor profile quality
* Wrong category
* Irrelevant traffic
* Missing information

**Unusual spikes:**

* Bot traffic
* News mention
* Competitor actions
* Data errors

## Advanced Analysis

### Attribution Challenges

**What GBP doesn't tell you:**

* Actual conversions/sales
* Revenue from GBP traffic
* Customer journey beyond click
* Phone call outcomes

**How to bridge the gap:**

* UTM parameters on website links
* Call tracking numbers
* Landing page analytics
* CRM integration

### Correlation Analysis

**Connect metrics to actions:**

* Post frequency → engagement
* Photo additions → views
* Review responses → sentiment
* Information updates → relevance

### Multi-Location Analysis

**Compare locations:**

* Identify top performers
* Spot underperformers
* Find best practices
* Allocate resources

## Using Data for Optimization

### Profile Improvements

Based on insights:

* Low discovery → improve categories/description
* Low actions → add compelling CTAs
* Low photo views → update photos
* High certain action → optimize for it

### Content Strategy

Data-driven content:

* Post when engagement highest
* Topics aligned with searches
* Photos that perform well
* Offers that drive action

### Resource Allocation

Invest where data supports:

* High-potential locations
* Growing categories
* Converting traffic sources
* Effective tactics

## Tracking Tools

### GBP Dashboard

Native insights available in your profile:

* Basic metrics
* Simple trends
* Category comparisons

### Google Search Console

Connect for additional data:

* Search queries
* Click-through rates
* Position data
* Website performance

### Google Analytics 4

Track website behavior from GBP:

* Landing page performance
* Conversion tracking
* User behavior
* Traffic attribution

### Third-Party Tools

Enhanced analytics options:

* Rank tracking
* Competitor comparison
* Historical data
* Custom reporting

## Reporting Best Practices

### Regular Reporting

**Weekly:**

* Views and actions overview
* Review activity
* Notable changes

**Monthly:**

* Trend analysis
* Month-over-month comparison
* Goal progress

**Quarterly:**

* Strategic review
* Year-over-year comparison
* Competitive analysis

### Key Metrics to Track

**Visibility:**

* Total views (search + maps)
* View growth rate
* Category ranking indicators

**Engagement:**

* Actions per view
* Action growth rate
* Most valuable actions

**Reviews:**

* New review count
* Average rating
* Response rate and time

### Reporting Format

**Executive summary:**

* Key numbers at a glance
* Notable changes
* Recommended actions

**Detailed analysis:**

* Metric breakdowns
* Trend visualizations
* Correlation insights

**Action items:**

* Specific recommendations
* Priority ranking
* Expected impact

## Limitations of GBP Data

### Data Delays

* Not real-time
* 24-48 hour lag typical
* Monthly data may take longer

### Data Accuracy

* Estimates, not exact counts
* Bot traffic included
* Attribution challenges
* Privacy thresholds

### Historical Data

* Limited historical access
* Export before it's gone
* Third-party tools for archives

### Missing Data

* Individual user behavior
* Conversion data
* Revenue attribution
* Offline conversions

## Key Takeaways

1. Monitor trends, not just absolute numbers
2. Connect GBP data to business outcomes
3. Use data to drive optimization decisions
4. Compare against yourself and category
5. Acknowledge data limitations

<Cards>
  <Card title="Local SEO Audits" href="/docs/local-seo-guide/advanced/local-seo-audits" />

  <Card title="GBP API" href="/docs/local-seo-guide/advanced/gbp-api" />
</Cards>


# Local SEO Audits



Regular audits identify issues and opportunities in your local SEO strategy. Here's how to conduct a thorough audit.

## Audit Overview

### Why Audit?

* Identify issues before they hurt rankings
* Find optimization opportunities
* Benchmark current state
* Track improvement over time
* Justify resource allocation

### Audit Frequency

* **Comprehensive audit**: Quarterly
* **Quick check**: Monthly
* **Ongoing monitoring**: Weekly

## Google Business Profile Audit

### Information Accuracy

**Check:**

* [ ] Business name matches signage exactly
* [ ] Address is complete and correct
* [ ] Phone number is correct and active
* [ ] Website URL works and is correct
* [ ] Hours are accurate (including special hours)

### Category Optimization

**Check:**

* [ ] Primary category is most relevant
* [ ] Secondary categories are appropriate
* [ ] No irrelevant categories selected
* [ ] Category matches actual business

### Description and Attributes

**Check:**

* [ ] Description is complete (750 characters)
* [ ] Keywords naturally included
* [ ] All relevant attributes selected
* [ ] Attributes are accurate

### Photos and Media

**Check:**

* [ ] Cover photo is high quality
* [ ] Logo is uploaded
* [ ] At least 10+ photos present
* [ ] Photos are recent (last 6 months)
* [ ] Photo categories used correctly
* [ ] No inappropriate or low-quality photos

### Reviews

**Check:**

* [ ] Recent reviews exist (last 30 days)
* [ ] All reviews have responses
* [ ] Response time is reasonable
* [ ] Review sentiment is monitored
* [ ] No policy-violating reviews

### Posts

**Check:**

* [ ] Recent posts exist (last 7 days)
* [ ] Posts have images
* [ ] CTAs are included
* [ ] Post content is engaging
* [ ] Regular posting schedule

### Q\&A

**Check:**

* [ ] Questions are answered
* [ ] Answers are accurate
* [ ] Owner-seeded questions exist
* [ ] No spam in Q\&A

## Website Audit

### Local Pages

**Check:**

* [ ] Location pages exist for each location
* [ ] Unique content on each page
* [ ] NAP matches GBP exactly
* [ ] Schema markup present
* [ ] Map embedded
* [ ] Local keywords used

### Technical SEO

**Check:**

* [ ] Mobile-friendly
* [ ] Fast loading (Core Web Vitals)
* [ ] SSL certificate valid
* [ ] No crawl errors
* [ ] Proper URL structure

### On-Page Optimization

**Check:**

* [ ] Title tags include location
* [ ] Meta descriptions optimized
* [ ] H1 tags appropriate
* [ ] Local keywords in content
* [ ] Internal linking to location pages

### Contact Information

**Check:**

* [ ] NAP on every page (footer)
* [ ] Contact page has full details
* [ ] Click-to-call on mobile
* [ ] Directions link works

## Citation Audit

### Major Platforms

**Check presence and accuracy on:**

* [ ] Google Business Profile
* [ ] Apple Maps / Apple Business Connect
* [ ] Bing Places
* [ ] Facebook
* [ ] Yelp
* [ ] Yellow Pages
* [ ] Industry directories

### NAP Consistency

**Check:**

* [ ] Name exactly matches everywhere
* [ ] Address format is consistent
* [ ] Phone number is identical
* [ ] No old addresses or numbers
* [ ] No variations exist

### Citation Quality

**Check:**

* [ ] Listings are claimed
* [ ] Profiles are complete
* [ ] Photos are uploaded
* [ ] Descriptions present
* [ ] Categories correct

## Competitive Analysis

### Competitor Identification

**Identify:**

* Top 3 local pack competitors
* Main organic competitors
* Rising competitors
* Indirect competitors

### Competitor GBP Audit

**Compare:**

* [ ] Review quantity and rating
* [ ] Post frequency
* [ ] Photo quantity and quality
* [ ] Response rates
* [ ] Category selection

### Competitor Website Audit

**Compare:**

* [ ] Local content quality
* [ ] Location page depth
* [ ] Technical performance
* [ ] Backlink profile
* [ ] Content strategy

## Review Audit

### Review Health

**Metrics:**

* Total review count
* Average rating
* Review velocity (reviews per month)
* Response rate
* Response time

### Review Distribution

**Analyze:**

* Reviews across platforms
* Positive vs negative ratio
* Recent review trends
* Review sources

### Review Content

**Look for:**

* Common themes (positive)
* Common complaints
* Keywords mentioned
* Services mentioned

## Technical Audit

### Schema Markup

**Verify:**

* [ ] LocalBusiness schema present
* [ ] Schema validates without errors
* [ ] NAP in schema matches website
* [ ] All relevant properties included
* [ ] Schema on all location pages

### Mobile Performance

**Check:**

* [ ] Mobile-friendly test passes
* [ ] Touch elements properly sized
* [ ] Content readable without zoom
* [ ] Forms work on mobile

### Page Speed

**Check:**

* [ ] Core Web Vitals pass
* [ ] LCP under 2.5s
* [ ] FID under 100ms
* [ ] CLS under 0.1

## Reporting

### Audit Scorecard

Create scoring system:

* Each area scored 1-10
* Overall score calculated
* Comparison to previous audit
* Priority ranking

### Issue Prioritization

Categorize issues:

* **Critical**: Fix immediately
* **High**: Fix within 1 week
* **Medium**: Fix within 1 month
* **Low**: Nice to have

### Action Plan

Document:

* Specific issues found
* Recommended fixes
* Who is responsible
* Timeline for completion
* Expected impact

## Audit Checklist Template

### Quick Monthly Check

* [ ] GBP information accurate
* [ ] Recent reviews responded to
* [ ] Post published this week
* [ ] No new issues in GBP
* [ ] Rankings stable

### Comprehensive Quarterly Audit

* [ ] Full GBP audit
* [ ] Website audit
* [ ] Citation audit
* [ ] Competitive analysis
* [ ] Review audit
* [ ] Technical audit
* [ ] Action plan created

## Tools for Auditing

### Free Tools

* Google Business Profile Manager
* Google Search Console
* Google PageSpeed Insights
* Schema Validator
* Moz Local Check

### Paid Tools

* BrightLocal
* Whitespark
* SEMrush
* Ahrefs
* Yext

## Key Takeaways

1. Conduct regular audits at set intervals
2. Use checklists to ensure consistency
3. Prioritize issues by impact
4. Create actionable plans
5. Track improvements over time

<Cards>
  <Card title="Competitor Analysis" href="/docs/local-seo-guide/advanced/competitor-analysis" />

  <Card title="Insights & Analytics" href="/docs/local-seo-guide/advanced/insights-and-analytics" />
</Cards>


# How Local Search Works



Google processes billions of local searches daily. Understanding how it works helps you optimize effectively.

## Query Intent Detection

When someone searches, Google determines whether the query has local intent:

### Explicit Local Intent

Queries that clearly indicate location:

* "pizza delivery 90210"
* "dentist in Chicago"
* "coffee shop near me"

### Implicit Local Intent

Queries where Google infers local intent:

* "plumber" → assumes you want one nearby
* "pharmacy open now" → needs your location
* "gas station" → proximity matters

Google uses your device location, search history, and query context to detect local intent.

## Local vs Organic Results

Google displays different result types based on intent:

### Local Results (Map Pack)

* Appears for local intent queries
* Shows 3 businesses with map
* Pulls data from Google Business Profile
* Click-to-call, directions, website links

### Organic Results

* Traditional blue link results
* Based on website content and authority
* Appear below the Local Pack
* Can include local businesses with strong websites

### Knowledge Panel

* Appears for branded searches ("Starbucks near me")
* Shows single business details
* Includes reviews, hours, photos

## The Local Algorithm

Google's local algorithm is separate from its organic algorithm. It evaluates:

### 1. Google Business Profile Signals

* Completeness of profile
* Primary category selection
* Keywords in business name (naturally occurring)
* Photos and posts
* Reviews and ratings

### 2. Proximity Signals

* Distance from searcher
* Address accuracy
* Service area configuration

### 3. Website Signals

* Local keywords on site
* Mobile-friendliness
* Page speed
* Local schema markup

### 4. Citation Signals

* Number of citations
* NAP consistency
* Quality of citation sources

### 5. Review Signals

* Review quantity
* Review velocity (how often you get new reviews)
* Review diversity (different platforms)
* Review keywords
* Owner responses

### 6. Behavioral Signals

* Click-through rate from search
* Calls and direction requests
* Time spent on listing
* Return visits

## Personalization

Local results are highly personalized based on:

* **Physical location**: Different results across town
* **Search history**: Past businesses you've interacted with
* **Time of day**: Open businesses may rank higher
* **Device**: Mobile vs desktop can show different results

## The "Centroid" Effect

For competitive terms, Google uses a "centroid" - the geographic center of businesses in a category. Being closer to the centroid can improve rankings for citywide searches.

Example: Searching "lawyer" in a city may favor downtown businesses because that's where most lawyers are located.

## Algorithm Updates

Google continuously updates its local algorithm. Major updates include:

* **Pigeon (2014)**: Closer ties between local and organic signals
* **Possum (2016)**: Improved filtering of similar businesses
* **Vicinity (2021)**: Increased importance of proximity

## Key Takeaways

1. Google determines local intent automatically
2. Local Pack and organic results use different algorithms
3. Proximity is a major factor you cannot control
4. You can influence relevance and prominence through optimization
5. Results are personalized per user and location

<Cards>
  <Card title="The Local Pack" href="/docs/local-seo-guide/fundamentals/the-local-pack" />

  <Card title="Ranking Factors" href="/docs/local-seo-guide/fundamentals/ranking-factors" />
</Cards>


# Fundamentals



Before optimizing your Google Business Profile, you need to understand how local search works and what influences rankings.

## Core Concepts

<Cards>
  <Card title="What is Local SEO?" href="/docs/local-seo-guide/fundamentals/what-is-local-seo" description="How local SEO differs from traditional SEO" />

  <Card title="How Local Search Works" href="/docs/local-seo-guide/fundamentals/how-local-search-works" description="Understanding Google's local algorithm" />

  <Card title="The Local Pack" href="/docs/local-seo-guide/fundamentals/the-local-pack" description="What is the 3-pack and why it matters" />

  <Card title="Ranking Factors" href="/docs/local-seo-guide/fundamentals/ranking-factors" description="The Big 3: Relevance, Distance, Prominence" />
</Cards>


# Ranking Factors



Google uses hundreds of signals to rank local businesses. Research has identified the most impactful factors.

## The Big 3 Factors

Google officially states three primary ranking factors:

### 1. Relevance

How well your profile matches the search query.

**What affects relevance:**

* Primary business category
* Additional categories
* Business name (natural keywords only)
* Products and services listed
* Business description
* Attributes

### 2. Distance

How far each business is from the search location.

**What affects distance:**

* Physical address
* Service area configuration
* Searcher's GPS location
* Location mentioned in query

### 3. Prominence

How well-known and reputable your business is.

**What affects prominence:**

* Review count and rating
* Citation volume and quality
* Website authority
* Brand searches
* Offline reputation

## Ranking Factor Breakdown (2025)

Based on industry research, here's how factors weight in local rankings:

| Factor Category | Weight | Description                      |
| --------------- | ------ | -------------------------------- |
| Proximity       | 42.8%  | Distance from searcher           |
| Reviews         | 21.4%  | Quantity, quality, recency       |
| GBP Signals     | 15.5%  | Profile completeness, categories |
| On-Page SEO     | 10.3%  | Website local optimization       |
| Citations       | 5.2%   | NAP consistency, citation volume |
| Backlinks       | 3.1%   | Local link building              |
| Behavioral      | 1.7%   | Clicks, calls, engagement        |

## GBP Signals (Detailed)

### Primary Category

The single most important on-profile factor. Choose the most specific category that matches your core business.

### Business Name

Businesses with keywords in their name have an advantage. But don't add keywords artificially - this violates guidelines and risks suspension.

### Complete Profile

Google favors complete profiles:

* All hours filled in
* Business description
* Services/products listed
* Attributes selected
* Photos uploaded
* Posts published

### Engagement

Active profiles rank better:

* Regular photo uploads
* Weekly posts
* Prompt review responses
* Q\&A answers

## Review Signals (Detailed)

### Quantity

More reviews = stronger signal. But quality matters too.

### Recency

Recent reviews weigh more than old reviews. A steady flow beats a burst.

### Rating

Higher average ratings correlate with higher rankings. 4.0+ is typically needed for competitive terms.

### Review Content

Reviews containing keywords may boost relevance for those terms.

### Response Rate

Responding to reviews signals active management and may help rankings.

### Velocity

Consistent new reviews signal an active business. Sudden spikes may trigger spam detection.

## Website Signals (Detailed)

Your website supports your local rankings:

### Local Keywords

Include city/neighborhood names naturally in:

* Title tags
* Headers
* Content
* Meta descriptions

### Mobile-Friendliness

Most local searches are mobile. Ensure your site works perfectly on phones.

### Page Speed

Fast-loading pages rank better. Aim for under 3 seconds.

### Schema Markup

LocalBusiness schema helps Google understand your business data.

### Location Pages

For multi-location businesses, create unique pages for each location.

## Citation Signals (Detailed)

### NAP Consistency

Your Name, Address, Phone must match exactly everywhere online.

### Citation Volume

More citations from quality sources strengthen prominence.

### Citation Quality

Major platforms (Yelp, Apple Maps, Facebook) carry more weight than obscure directories.

## Behavioral Signals (Detailed)

Google may track user behavior:

### Click-Through Rate

How often people click your listing vs others.

### Engagement

Do people call, request directions, visit your website?

### Dwell Time

How long users spend on your listing or website.

### Bounce Rate

Do users quickly return to search results?

## Factors You Can't Control

Some ranking factors are outside your control:

* **Physical location**: You can't move closer to the searcher
* **Competitor activity**: Others are optimizing too
* **Algorithm changes**: Google updates ranking weights
* **Searcher personalization**: Past behavior influences results

Focus on what you can control: profile optimization, reviews, and online presence.

## Key Takeaways

1. Proximity is the largest factor (\~43%)
2. Reviews are the second largest (\~21%)
3. GBP profile optimization matters (\~16%)
4. All factors work together
5. Focus on controllable factors

<Cards>
  <Card title="Google Business Profile Setup" href="/docs/local-seo-guide/google-business-profile" />

  <Card title="Review Management" href="/docs/local-seo-guide/reviews" />
</Cards>


# The Local Pack



The Local Pack (also called the Map Pack or 3-Pack) is the boxed area showing three local businesses with a map on Google Search.

## What is the Local Pack?

When you search for local services, Google displays:

1. **Map** showing business locations
2. **Three business listings** with key info
3. **"More places" link** to expanded results

The Local Pack appears above organic results, making it prime real estate for local businesses.

## What Information Appears

Each listing in the Local Pack shows:

* Business name
* Star rating and review count
* Business category
* Address or service area
* Hours (and "Open/Closed" status)
* Phone number
* Website link
* Directions button

## Why the Local Pack Matters

### Visibility

* Appears at the top of search results
* Takes up significant screen space
* 44% of clicks go to Local Pack results

### Click-Through Rate

* Local Pack listings get 4x more clicks than organic results for local intent queries
* Mobile users often tap "Call" or "Directions" directly

### Zero-Click Actions

* Users can call, get directions, or read reviews without visiting your website
* This makes GBP optimization critical

## How Google Selects the 3 Businesses

Google uses three primary factors:

### 1. Relevance

How well your profile matches the search query:

* Primary category alignment
* Keywords in business name
* Services and products listed
* Description content

### 2. Distance

How far your business is from the searcher:

* For "near me" queries, closest businesses often win
* For city-level queries, distance matters less
* Service-area businesses show based on service area, not office location

### 3. Prominence

How well-known and trusted your business is:

* Review count and rating
* Citation presence
* Website authority
* Brand recognition

## Local Pack Variations

### Standard Local Pack

Three listings with map. Most common format.

### Local Services Ads

For some categories (plumbers, lawyers), paid listings appear above organic Local Pack.

### Hotel Pack

Shows hotels with prices and booking options.

### Local Finder

Clicking "More places" opens an expanded list with more businesses and filters.

## Factors That Improve Local Pack Rankings

### Optimize Your GBP

* Complete all profile fields
* Choose accurate primary category
* Add photos regularly
* Post updates weekly
* Respond to reviews

### Build Reviews

* More reviews = higher rankings
* Recent reviews matter more
* Higher ratings help
* Keywords in reviews may help

### Ensure NAP Consistency

* Same name/address/phone everywhere
* Match your GBP exactly
* Fix inconsistent citations

### Optimize Your Website

* Include local keywords
* Add schema markup
* Ensure mobile-friendliness
* Create location pages (for multi-location)

## Understanding Position Changes

Local Pack positions fluctuate based on:

* Searcher's location (even across a city)
* Time of day (open vs closed)
* Device type
* Personalization
* Algorithm updates

Don't panic over minor fluctuations. Focus on consistent optimization.

## Tracking Local Pack Performance

Monitor your Local Pack visibility using:

* **Google Business Profile Insights**: Search queries and visibility
* **Local rank tracking tools**: Position by location
* **Manual searches**: Check from different locations

## Key Takeaways

1. The Local Pack captures 44% of clicks for local searches
2. Only 3 businesses appear (unless expanded)
3. Relevance, distance, and prominence determine rankings
4. Your position varies by searcher location
5. GBP optimization is essential for Local Pack visibility

<Cards>
  <Card title="Ranking Factors" href="/docs/local-seo-guide/fundamentals/ranking-factors" />

  <Card title="Google Business Profile" href="/docs/local-seo-guide/google-business-profile" />
</Cards>


# What is Local SEO?



Local SEO is the practice of optimizing your online presence to attract customers from local searches. It focuses on appearing in geographically-related search results.

## Local SEO vs Traditional SEO

| Aspect          | Traditional SEO               | Local SEO                           |
| --------------- | ----------------------------- | ----------------------------------- |
| **Goal**        | Rank globally for keywords    | Rank locally for "near me" searches |
| **Results**     | Organic blue links            | Local Pack (map results) + organic  |
| **Key factors** | Content, backlinks, technical | GBP, reviews, citations, proximity  |
| **Competition** | Global websites               | Local businesses in your area       |

## Who Needs Local SEO?

Local SEO is essential for:

* **Brick-and-mortar businesses** with physical locations customers visit
* **Service-area businesses** that travel to customers (plumbers, electricians)
* **Multi-location businesses** with multiple storefronts
* **Professional services** (lawyers, doctors, accountants)
* **Restaurants and hospitality** businesses

## Key Components of Local SEO

### 1. Google Business Profile

Your GBP listing is the foundation. It determines how you appear on Google Maps and in the Local Pack.

### 2. Reviews

Customer reviews influence both rankings and consumer decisions. Quantity, quality, and recency all matter.

### 3. Citations

Mentions of your business name, address, and phone number across the web. Consistency is critical.

### 4. On-Page SEO

Your website still matters. Local keywords, location pages, and schema markup support local rankings.

### 5. Link Building

Local backlinks from community organizations, local news, and business directories signal local relevance.

## The Local Search Ecosystem

Google uses signals from multiple sources to determine local rankings:

```
┌─────────────────────────────────────────────────────┐
│                  Google Search                       │
├─────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │    GBP      │  │   Website   │  │  Citations  │ │
│  │  Profile    │  │   Content   │  │  & NAP      │ │
│  └─────────────┘  └─────────────┘  └─────────────┘ │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │   Reviews   │  │  Backlinks  │  │   User      │ │
│  │             │  │             │  │  Signals    │ │
│  └─────────────┘  └─────────────┘  └─────────────┘ │
└─────────────────────────────────────────────────────┘
```

## Why Local SEO Matters

* **46%** of all Google searches have local intent
* **76%** of people who search for something nearby visit a business within a day
* **28%** of local searches result in a purchase
* **88%** of consumers trust online reviews as much as personal recommendations

## Next Steps

Understanding local SEO fundamentals is just the beginning. Next, learn how Google actually processes and ranks local searches.

<Cards>
  <Card title="How Local Search Works" href="/docs/local-seo-guide/fundamentals/how-local-search-works" />
</Cards>


# Attributes



Attributes are additional details about your business that help customers make decisions. Google offers 600+ attributes across different categories.

## What Are Attributes?

Attributes are specific characteristics of your business, such as:

* Accessibility features (wheelchair accessible)
* Payment methods (accepts credit cards)
* Amenities (free Wi-Fi, outdoor seating)
* Service options (dine-in, takeout, delivery)
* Identity attributes (women-led, veteran-owned)

## Why Attributes Matter

### Search Visibility

Attributes help you appear in filtered searches:

* "wheelchair accessible restaurants near me"
* "restaurants with outdoor seating"
* "24 hour pharmacy"

### Customer Decision-Making

87% of consumers consider attributes when choosing a business.

### Trust Building

Accurate attributes set correct expectations.

## Types of Attributes

### Factual Attributes (You Set)

Business owner controls these:

* Payment methods accepted
* Accessibility features
* Service options
* Amenities offered

### Subjective Attributes (Google Sets)

Based on user feedback:

* "Good for kids"
* "Cozy atmosphere"
* "Popular with locals"

You can't directly set these, but providing good service influences them.

## Category-Specific Attributes

Different business categories unlock different attributes.

### Restaurants

* Dine-in, takeout, delivery
* Outdoor seating
* Reservations accepted
* Serves alcohol
* Good for groups
* Vegetarian options

### Hotels

* Pool, gym, spa
* Free breakfast
* Pet-friendly
* Business center
* Room service
* Airport shuttle

### Healthcare

* Accepts new patients
* Telehealth available
* Languages spoken
* Insurance accepted
* Appointment required

### Retail

* In-store shopping
* Curbside pickup
* Delivery available
* Returns accepted

### Service Businesses

* Online appointments
* Free estimates
* Emergency services
* Licensed and insured

## Identity Attributes

Google offers identity attributes to highlight:

* **Black-owned**
* **Women-led**
* **Veteran-owned**
* **LGBTQ+ friendly**
* **Latinx-owned**
* **Asian-owned**

These appear prominently on your profile and can attract customers who want to support these businesses.

## Accessibility Attributes

Important for compliance and customer service:

* Wheelchair accessible entrance
* Wheelchair accessible parking
* Wheelchair accessible restroom
* Wheelchair accessible seating
* Assistive hearing loop
* Braille menu

Be accurate—customers depend on this information.

## Health & Safety Attributes

Post-pandemic attributes include:

* Mask required
* Staff wears masks
* Temperature checks
* Sanitization practices
* Contactless payment

Update these as your policies change.

## Setting Attributes

### In GBP Dashboard

1. Go to your Business Profile
2. Click "Edit profile"
3. Scroll to "More" or "Attributes"
4. Toggle relevant attributes on/off

### Via Synoveo

Synoveo can sync attributes from your connected platforms automatically.

## Best Practices

### Be Accurate

Only select attributes that truly apply. Misleading attributes hurt trust and can lead to negative reviews.

### Be Complete

Fill in all relevant attributes. More information helps customers and Google.

### Stay Updated

Update attributes when things change:

* New payment methods
* Seasonal services (outdoor seating)
* Changed policies

### Prioritize Customer-Facing

Focus on attributes customers care about most:

* Accessibility
* Payment options
* Service methods (delivery, dine-in)

## Attributes and Rankings

While attributes aren't a direct ranking factor, they:

* Help you appear in filtered searches
* Improve click-through rates
* Reduce bounce rates (correct expectations)
* Influence customer choice

## Key Takeaways

1. Attributes help customers find and choose your business
2. Different categories have different available attributes
3. Be accurate—never claim attributes that don't apply
4. Update attributes when your business changes
5. Focus on accessibility and key service options

<Cards>
  <Card title="Service Areas" href="/docs/local-seo-guide/google-business-profile/service-areas" />

  <Card title="Hours" href="/docs/local-seo-guide/google-business-profile/hours" />
</Cards>


# Business Information



Your business information is the foundation of your Google Business Profile. Accurate, complete information helps customers find you and improves your local rankings.

## NAP: Name, Address, Phone

NAP is the most critical information on your profile.

### Business Name

**Rules:**

* Use your real-world business name exactly as it appears on signage
* Don't add keywords, locations, or taglines
* Don't add unnecessary descriptors

**Correct:** Joe's Plumbing
**Incorrect:** Joe's Plumbing - 24/7 Emergency Plumber Chicago IL

**Why it matters:**

* Keyword stuffing violates guidelines
* Can result in suspension
* Inconsistent names hurt citations

### Address

**For storefronts:**

* Enter complete street address
* Use USPS-standardized format
* Include suite/unit numbers if applicable
* Verify pin placement on map

**For service-area businesses:**

* Can hide address from public
* Still need a real address for verification
* No P.O. boxes or virtual offices

**Format tips:**

* "Street" not "St." (or be consistent everywhere)
* Include directional indicators (N, S, E, W)
* Apartment/Suite on separate line

### Phone Number

**Best practices:**

* Use a local phone number (area code matches location)
* Use a trackable number if needed for analytics
* Ensure it's answered during business hours
* Don't use premium rate numbers

**Call tracking:**

* If using call tracking, ensure the forwarding number matches your GBP
* Some call tracking numbers can cause issues with verification

## Business Description

Your description appears in the Knowledge Panel and helps customers understand what you do.

**Character limit:** 750 characters

**Best practices:**

* Lead with what you do and who you serve
* Include your location/service area naturally
* Mention unique selling points
* Include relevant keywords naturally
* Don't include URLs, phone numbers, or promotions

**Example:**

> Joe's Plumbing has served Denver homeowners since 1985. Our licensed plumbers handle everything from emergency repairs to bathroom renovations. We offer same-day service, upfront pricing, and a satisfaction guarantee on all work.

**Don't include:**

* ALL CAPS text
* Promotional language ("Best in town!")
* Prices or special offers
* Links or contact information (it's elsewhere on profile)

## Website URL

**Best practices:**

* Link to your homepage or a relevant landing page
* Ensure the page is mobile-friendly
* Use HTTPS (secure connection)
* Make sure the page loads quickly

**For multi-location businesses:**

* Link to location-specific pages if available
* Each location should have its own landing page

**Don't:**

* Link to social media profiles
* Use URL shorteners
* Link to third-party booking sites instead of your own site

## Opening Date

When your business first opened. This builds credibility for established businesses.

**Benefits:**

* "In business since \[year]" may display
* Builds trust with customers
* Helps Google understand your business history

## From the Business

Additional short description that appears prominently.

**Character limit:** 100 characters

**Use it for:**

* Quick value proposition
* Current promotion or announcement
* Key differentiator

## Contact Information

### Additional Phone Numbers

* Add secondary phone numbers if needed
* Useful for different departments

### Email

* Not publicly displayed
* Used by Google for communications

## Key Takeaways

1. NAP must be consistent everywhere online
2. Use your real business name without keyword stuffing
3. Write a compelling 750-character description
4. Link to a relevant, mobile-friendly website
5. Keep all information current and accurate

<Cards>
  <Card title="Categories" href="/docs/local-seo-guide/google-business-profile/categories" />

  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" />
</Cards>


# Categories



Your business category is one of the most important ranking factors for local search. Choose wisely.

## Why Categories Matter

Your primary category is the #1 on-profile ranking factor. It determines:

* Which searches you appear for
* Which attributes are available
* How Google categorizes your business

## Primary vs Secondary Categories

### Primary Category

* The single most important category
* Displayed publicly on your profile
* Should represent your core business

### Secondary Categories

* Up to 9 additional categories
* Not displayed publicly
* Help you rank for related searches

## How to Choose Your Primary Category

Use this test: **"This business IS a \_\_\_"**

Not: "This business HAS a \_\_\_"

**Examples:**

* A grocery store with a pharmacy → Primary: "Grocery Store" (not "Pharmacy")
* A hotel with a pool → Primary: "Hotel" (not "Swimming Pool")
* A law firm specializing in divorce → Primary: "Divorce Lawyer" (not "Lawyer")

### Be Specific

Google has 4,000+ categories. Choose the most specific one that fits.

| Too Broad  | Better             | Best                        |
| ---------- | ------------------ | --------------------------- |
| Restaurant | Italian Restaurant | Neapolitan Pizza Restaurant |
| Doctor     | Family Doctor      | Pediatrician                |
| Store      | Clothing Store     | Women's Clothing Store      |

### Research Competitors

Look at what categories successful competitors use:

1. Search for your main service + location
2. Click on Local Pack results
3. Note their primary category

## Choosing Secondary Categories

Add categories that represent services you actually provide:

**Example - Dental Practice:**

* Primary: Dentist
* Secondary: Cosmetic Dentist, Pediatric Dentist, Emergency Dental Service

**Rules for secondary categories:**

* Only add if you actively provide that service
* Don't add aspirational categories
* Quality over quantity (3-5 is often enough)
* Don't duplicate the primary

## Categories to Avoid

### Don't Add Generic Categories

If your primary is specific, don't add the generic version.

* <IconCheck /> Primary: "Italian Restaurant"
* <IconX /> Secondary: "Restaurant" (implied)

### Don't Add Unrelated Categories

Only add categories for services you actually provide.

* <IconX /> Adding "Coffee Shop" because you have a coffee machine

### Don't Add Location-Based Categories

Categories shouldn't include locations.

* <IconX /> "Chicago Plumber" (not a real category)
* <IconCheck /> "Plumber" (let your address handle location)

## Finding the Right Category

### Use Google's Autocomplete

1. Start typing in the category field
2. See what Google suggests
3. Choose the most specific match

### Check Available Categories

Categories are updated regularly. What wasn't available before might exist now.

### Industry-Specific Tips

**Restaurants:**

* Use cuisine type (Mexican Restaurant, Thai Restaurant)
* Add "Restaurant" only if no specific type exists

**Medical:**

* Use specialty (Cardiologist, Dermatologist)
* "Doctor" is too generic

**Legal:**

* Use practice area (Personal Injury Attorney, Estate Planning Attorney)
* "Lawyer" is too generic

**Home Services:**

* Be specific (Plumber, Electrician, HVAC Contractor)
* Add emergency services category if offered

## Changing Categories

You can change categories at any time:

1. Go to your GBP dashboard
2. Click "Edit profile"
3. Update categories
4. Changes take effect within days

**Note:** Frequent changes can look suspicious. Make changes thoughtfully.

## Category Impact on Features

Your primary category unlocks specific features:

| Category Type | Unlocked Features                    |
| ------------- | ------------------------------------ |
| Restaurants   | Menu, reservations, delivery options |
| Hotels        | Room booking, amenities, star rating |
| Healthcare    | Insurance info, appointment booking  |
| Retail        | Products, inventory                  |

## Key Takeaways

1. Primary category is your #1 ranking factor
2. Be as specific as possible
3. Use the "This business IS a \_\_\_" test
4. Add 3-5 relevant secondary categories
5. Don't add generic or unrelated categories

<Cards>
  <Card title="Attributes" href="/docs/local-seo-guide/google-business-profile/attributes" />

  <Card title="Ranking Factors" href="/docs/local-seo-guide/fundamentals/ranking-factors" />
</Cards>


# Creating Your Profile



This guide walks through creating a new Google Business Profile or claiming an existing one.

## Before You Start

Gather this information:

* Business legal name (as it appears on signage)
* Complete address
* Phone number
* Website URL
* Business category
* Business hours
* High-quality photos

## Check for Existing Listing

Before creating a new profile, check if one exists:

1. Go to [Google Maps](https://maps.google.com)
2. Search for your business name
3. If found, you'll claim it (not create new)

Creating a duplicate listing violates guidelines and can result in suspension.

## Creating a New Profile

### Step 1: Go to Google Business Profile

Visit [business.google.com](https://business.google.com) and sign in with a Google account.

Use a business Google account, not a personal one. This simplifies access management.

### Step 2: Enter Business Name

Enter your exact business name as it appears on:

* Storefront signage
* Legal documents
* Marketing materials

Do not add keywords, locations, or taglines. "Joe's Plumbing" is correct. "Joe's Plumbing - Best Emergency Plumber in Chicago" violates guidelines.

### Step 3: Select Business Category

Choose your primary category from Google's list of 4,000+ options.

Be specific. "Italian Restaurant" is better than "Restaurant" if that's what you are.

### Step 4: Add Location

For businesses with a physical location:

* Enter your complete street address
* Confirm location on map
* Adjust pin if needed

For service-area businesses:

* Skip physical address
* Define service areas instead

### Step 5: Add Contact Information

* Business phone number
* Website URL (if you have one)

Use a local phone number when possible. It reinforces geographic relevance.

### Step 6: Verify Your Business

Google requires verification to prove you own/manage the business.

Most common methods:

* **Postcard**: Google mails a code (5-14 days)
* **Phone**: Automated call with code
* **Email**: Code sent to business email
* **Video**: Record and submit video tour

See the [Verification page](/docs/local-seo-guide/google-business-profile/verification) for details on each method.

## Claiming an Existing Listing

If your business already appears on Google:

### Step 1: Find the Listing

Search for your business on Google or Google Maps.

### Step 2: Click "Claim this business"

Or "Own this business?" depending on display.

### Step 3: Follow Verification Steps

Same verification process as new listings.

### If Already Claimed

If someone else has claimed your listing:

1. Click "Request access"
2. Google contacts the current owner
3. If no response in 7 days, you may gain access
4. If disputed, provide documentation proving ownership

## After Creation

Once your profile is created:

1. **Complete all sections**: Add hours, description, photos, services
2. **Verify**: Complete the verification process
3. **Wait**: Profile typically appears within 1-3 days after verification
4. **Optimize**: See the [Optimization section](/docs/local-seo-guide/optimization)

## Common Mistakes to Avoid

### Wrong Business Name

Don't add keywords or location to your name. Use only your real business name.

### Wrong Category

Choose the most specific category. You can add additional categories later.

### Duplicate Listings

Never create a second listing. Claim or update the existing one.

### Virtual Address

Don't use a virtual office, coworking space, or P.O. box unless you meet customers there.

### Wrong Address Format

Use the USPS-standardized address format. Match exactly what appears on your signage.

<Cards>
  <Card title="Verification" href="/docs/local-seo-guide/google-business-profile/verification" />

  <Card title="Business Information" href="/docs/local-seo-guide/google-business-profile/business-information" />
</Cards>


# Hours



Accurate business hours are essential for customer experience and can affect your local rankings.

## Why Hours Matter

### Customer Experience

* Customers rely on your hours to plan visits
* Wrong hours lead to frustrated customers
* "Permanently closed" users if hours seem wrong

### Rankings Impact

* Google may rank open businesses higher
* "Open now" filter uses your hours
* Accurate hours signal an active, legitimate business

### Reviews Impact

* Wrong hours often lead to negative reviews
* "Arrived and they were closed" is a common complaint

## Regular Hours

Your standard operating hours for each day of the week.

### Setting Regular Hours

1. Go to GBP dashboard
2. Click "Edit profile"
3. Select "Hours"
4. Set opening and closing time for each day

### Format Options

* **Standard hours**: 9:00 AM - 5:00 PM
* **Split hours**: 9:00 AM - 12:00 PM, 1:00 PM - 5:00 PM (for lunch break)
* **24 hours**: Select "Open 24 hours"
* **Closed**: Mark specific days as closed

### Multiple Hour Ranges

If you close for lunch or have split shifts:

* Add multiple time ranges for the same day
* Example: 11:00 AM - 2:00 PM, 5:00 PM - 10:00 PM

## Special Hours

Temporary changes to your regular hours.

### When to Use Special Hours

* Holidays (Christmas, Thanksgiving)
* Special events
* Temporary closures
* Extended hours (Black Friday)

### Setting Special Hours

1. Go to "Edit profile"
2. Select "Hours"
3. Click "Special hours"
4. Add date and modified hours

### Google's Holiday Suggestions

Google may suggest special hours for upcoming holidays. Review and confirm these are accurate for your business.

## More Hours

Hours for specific services or departments.

### Available Options

Depending on your category:

* **Delivery hours**
* **Pickup hours**
* **Drive-through hours**
* **Senior hours**
* **Kitchen hours**
* **Pharmacy hours**
* **Service department hours**

### When to Use More Hours

Use when a specific service has different hours than your main business:

* Restaurant open until 10 PM, but kitchen closes at 9:30 PM
* Store open 9-5, but pharmacy closes at 4 PM

## Temporary Closures

For extended closures (vacation, renovation):

### "Temporarily Closed" Status

1. Go to GBP dashboard
2. Select "Mark as temporarily closed"
3. Set expected reopening date if known

### When to Use

* Renovations lasting more than a day
* Extended vacation
* Seasonal closures
* Unexpected situations (fire, flood)

### Important Notes

* Profile still appears in search, marked as closed
* Reviews can still be left
* Don't use for regular closed days (like Sundays)

## Time Zone Handling

GBP uses your business location's time zone.

* Hours display in local time to searchers
* No need to manually adjust for time zones
* Ensure your address is correct for proper time zone detection

## Common Hours Mistakes

### Not Updating for Holidays

* Set special hours in advance
* Google sends reminders for major holidays
* Wrong holiday hours = frustrated customers

### Forgetting Split Hours

* If you close for lunch, show it
* Don't just show earliest open to latest close

### Incorrect 24-Hour Format

* Some regions use 24-hour format
* Verify hours display correctly in search results

### Not Matching Website Hours

* GBP hours should match website
* Inconsistency confuses customers and Google

## Hours and "Open Now"

When users search, Google shows "Open" or "Closed" indicators.

* Businesses showing "Open" may get more clicks
* "Closes soon" can create urgency
* "Opens at \[time]" helps customers plan

## Updating Hours

### Regular Updates

Update hours whenever they change:

* Seasonal schedule changes
* New permanent hours
* Expanded hours

### Bulk Updates (Multi-location)

For businesses with many locations, use:

* GBP bulk management
* Synoveo's sync feature
* API updates

## Key Takeaways

1. Accurate hours prevent negative customer experiences
2. Use special hours for holidays and temporary changes
3. Use "More Hours" for department-specific schedules
4. Mark as temporarily closed for extended closures
5. Keep hours consistent with your website

<Cards>
  <Card title="Profile Completeness" href="/docs/local-seo-guide/optimization/profile-completeness" />

  <Card title="Business Information" href="/docs/local-seo-guide/google-business-profile/business-information" />
</Cards>


# Google Business Profile



Your Google Business Profile is the foundation of local SEO. This section covers everything from creation to advanced optimization.

## Topics

<Cards>
  <Card title="What is GBP?" href="/docs/local-seo-guide/google-business-profile/what-is-gbp" description="Overview and importance" />

  <Card title="Creating Your Profile" href="/docs/local-seo-guide/google-business-profile/creating-your-profile" description="Step-by-step setup guide" />

  <Card title="Verification" href="/docs/local-seo-guide/google-business-profile/verification" description="All verification methods explained" />

  <Card title="Business Information" href="/docs/local-seo-guide/google-business-profile/business-information" description="NAP, description, website" />

  <Card title="Categories" href="/docs/local-seo-guide/google-business-profile/categories" description="Primary and secondary categories" />

  <Card title="Attributes" href="/docs/local-seo-guide/google-business-profile/attributes" description="600+ attributes by category" />

  <Card title="Service Areas" href="/docs/local-seo-guide/google-business-profile/service-areas" description="SAB vs storefront configuration" />

  <Card title="Hours" href="/docs/local-seo-guide/google-business-profile/hours" description="Regular, special, and holiday hours" />
</Cards>


# Service Areas



How you configure your location type affects where and how you appear in search results.

## Business Types

### Storefront Business

Customers come to your location:

* Retail stores
* Restaurants
* Medical offices
* Banks

**Configuration:** Display your address publicly

### Service-Area Business (SAB)

You travel to customers:

* Plumbers
* Electricians
* Mobile pet grooming
* House cleaning

**Configuration:** Hide address, define service areas

### Hybrid Business

Both—customers visit AND you travel:

* Pizza restaurant with delivery
* Florist with delivery service
* Auto shop with towing

**Configuration:** Display address AND define service areas

## Service-Area Business Setup

### When to Use SAB

* You don't serve customers at your business address
* Your address is a home office
* You travel to customer locations

### Setting Service Areas

You can define service areas by:

**Cities/Towns:**

* Add specific cities you serve
* Most precise option
* Recommended for most SABs

**Postal Codes:**

* Add specific ZIP codes
* Good for defined delivery zones

**Regions:**

* Counties or larger areas
* Use sparingly—can be too broad

### Service Area Limits

* Maximum 20 service areas
* Should represent areas you actually serve
* Areas should be within reasonable travel distance

### Address Visibility

For SABs:

* Your address is hidden from customers
* You still need a real address for verification
* No P.O. boxes or virtual offices allowed

## Storefront Setup

### When to Use Storefront

* Customers visit your physical location
* You have signage and a public address
* Walk-ins are welcome

### Address Requirements

* Must be a real, physical address
* Must have visible signage
* Must be staffed during listed hours
* No virtual offices or coworking spaces (unless you have dedicated space)

## Hybrid Business Setup

### When to Use Hybrid

* Customers visit AND you provide services at their location
* Restaurant with dine-in AND delivery
* Store with in-store shopping AND home installation

### Configuration

1. Display your address publicly
2. Also define service areas
3. Both are shown on your profile

## Common Configuration Mistakes

### Using Home Address for SAB

* Technically allowed
* Address is hidden, so privacy maintained
* But still needed for verification

### Setting Service Areas Too Large

* Don't claim to serve areas 3+ hours away
* Google may limit visibility if areas seem unrealistic
* Customers may leave bad reviews if you can't actually serve them

### Incorrect Business Type Selection

* Claiming SAB when you have a storefront (to avoid address issues)
* This violates guidelines and risks suspension

## How Service Areas Affect Rankings

### For SABs

* Rank based on service area, not physical location
* Proximity to searcher still matters within service area
* More specific service areas may help targeting

### For Storefronts

* Proximity to searcher is key
* Service areas don't override location-based ranking

### For Hybrids

* Location matters for "near me" searches
* Service areas extend reach for delivery/service searches

## Changing Business Type

You can switch between types:

1. Go to GBP dashboard
2. Edit profile
3. Change "Location" settings

**Note:** Switching may require re-verification.

## Multi-Location Service Areas

For businesses with multiple locations:

* Each location should have its own profile
* Service areas can overlap slightly
* Don't create fake locations to cover more area

## Key Takeaways

1. Choose the right business type (storefront, SAB, hybrid)
2. SABs hide address but still need real location for verification
3. Service areas should be realistic and achievable
4. Don't game the system with fake addresses or unrealistic service areas
5. Service area configuration affects where you appear in search

<Cards>
  <Card title="Hours" href="/docs/local-seo-guide/google-business-profile/hours" />

  <Card title="Creating Your Profile" href="/docs/local-seo-guide/google-business-profile/creating-your-profile" />
</Cards>


# Verification



Verification proves to Google that you're the legitimate owner or manager of a business. Until verified, your profile may not appear in search results and you can't access all features.

## Why Verification Matters

Unverified profiles:

* May not appear in Local Pack
* Cannot respond to reviews
* Cannot post updates
* Have limited editing capabilities
* Cannot use messaging features

## Verification Methods

Google determines which method(s) you're offered based on your business type, category, and other factors.

### Postcard Verification (Most Common)

1. Google mails a postcard to your business address
2. Postcard contains a 5-digit verification code
3. Enter the code in your GBP dashboard
4. Arrives in 5-14 business days

**Tips:**

* Don't request a new postcard until 14 days have passed
* Check with mail handlers to ensure it's not discarded
* The code expires after 30 days

### Phone Verification

1. Google calls your business phone number
2. Automated system provides a verification code
3. Enter the code immediately

**Requirements:**

* Must use the phone number on your listing
* Phone must be answered during business hours
* Not available for all business types

### Email Verification

1. Google sends a code to your business email
2. Email must match your domain (e.g., [info@yourbusiness.com](mailto:info@yourbusiness.com))
3. Enter the code from the email

**Requirements:**

* Email must be on your business domain
* Gmail/personal emails typically not accepted
* Check spam folder

### Video Verification

1. Record a video showing your business
2. Must show: exterior signage, interior, proof you can access the location
3. Upload to Google for review
4. Decision within 5 business days

**Requirements:**

* Show business name on signage
* Demonstrate you have keys/access
* Show business equipment or inventory
* Can be recorded on smartphone

### Live Video Call

1. Schedule a video call with Google support
2. Show your business in real-time via video
3. Google representative verifies on the spot

**Requirements:**

* Must be at the business location
* Have ID and business documents ready
* Strong internet connection recommended

### Instant Verification

Some businesses qualify for instant verification if:

* You've verified your website with Google Search Console
* The website domain matches your GBP listing
* Google can confirm domain ownership

## 2025 Verification Changes

Google has tightened verification requirements:

* **More documentation required**: Utility bills, business licenses
* **Video verification more common**: Especially for service-area businesses
* **Stricter name matching**: Business name must match documentation exactly
* **One appeal only**: New reinstatement process limits appeals

## Verification Timeline

| Method     | Time to Complete |
| ---------- | ---------------- |
| Postcard   | 5-14 days        |
| Phone      | Instant          |
| Email      | Instant          |
| Video      | Up to 5 days     |
| Live Video | Same day         |
| Instant    | Immediate        |

## Troubleshooting

### Postcard Never Arrived

* Wait full 14 days before requesting another
* Verify address is correct and complete
* Check with mail room or building management
* Request a new postcard (up to 3 times)

### "This phone number can't be used"

* Ensure it's your business phone, not personal
* Try during different business hours
* Phone verification may not be available for your category

### Video Rejected

* Ensure signage clearly shows business name
* Video must show you unlocking/accessing the location
* Include business-specific items (equipment, inventory)
* Try again with clearer footage

### Verification Code Invalid

* Codes expire after 30 days
* Ensure you're entering the most recent code
* Don't request multiple postcards simultaneously

## After Verification

Once verified:

1. **Complete your profile**: Add all business information
2. **Enable sync**: If using Synoveo, turn on sync toggle
3. **Monitor regularly**: Keep information updated
4. **Respond to reviews**: You now have full access

## Re-Verification

Google may require re-verification if:

* You make significant changes to your listing
* Your business moves to a new address
* Google detects suspicious activity
* Your listing was suspended and reinstated

<Cards>
  <Card title="Business Information" href="/docs/local-seo-guide/google-business-profile/business-information" />

  <Card title="Verification Problems" href="/docs/local-seo-guide/troubleshooting/verification-problems" />
</Cards>


# What is Google Business Profile?



Google Business Profile (GBP) is Google's free tool for managing how your business appears across Google Search and Maps.

## History

* **2014**: Launched as "Google My Business"
* **2021**: Rebranded to "Google Business Profile"
* **Today**: Primary platform for local business visibility

## Where Your GBP Appears

Your profile information displays in:

### Google Search

* Local Pack (map results)
* Knowledge Panel (brand searches)
* Google Shopping (product listings)

### Google Maps

* Map markers
* Business details
* Directions and navigation

### Google Assistant

* Voice search answers
* "Near me" queries

## Key Features

### Business Information

* Name, address, phone number
* Website and hours
* Business description
* Categories and attributes

### Visual Content

* Photos and videos
* Logo and cover image
* Virtual tours

### Customer Interaction

* Reviews and ratings
* Q\&A section
* Messaging (chat)
* Booking integration

### Updates

* Posts (updates, offers, events)
* Product listings
* Service menus

### Insights

* Search queries
* Customer actions (calls, directions, website visits)
* Photo views

## Why GBP Matters

### Visibility

* 5 billion+ daily Google searches
* 46% have local intent
* GBP is required for Local Pack appearance

### Trust

* 87% of consumers read online reviews
* Star ratings visible immediately
* Photos show real business

### Conversions

* Click-to-call on mobile
* One-tap directions
* Direct booking integration

### Free Marketing

* No cost for basic features
* Reach customers at search moment
* Compete with paid advertisers

## Who Can Create a GBP

### Eligible Businesses

* Physical storefronts
* Service-area businesses
* Hybrid businesses (storefront + service area)

### Not Eligible

* Virtual offices without staff
* P.O. boxes
* Businesses without customer contact
* Lead generation companies (fake addresses)

## GBP vs Paid Advertising

| Feature   | GBP (Free) | Google Ads (Paid) |
| --------- | ---------- | ----------------- |
| Cost      | Free       | Pay per click     |
| Placement | Local Pack | Top of page       |
| Reviews   | Displayed  | Not displayed     |
| Trust     | High       | Lower             |
| Control   | Limited    | Full              |

Most successful local businesses use both.

## Next Steps

Ready to create or claim your profile? The next page walks through the process step by step.

<Cards>
  <Card title="Creating Your Profile" href="/docs/local-seo-guide/google-business-profile/creating-your-profile" />
</Cards>


# Multi-Location SEO



Multi-location SEO requires different strategies than single-location businesses. Learn how to manage multiple Google Business Profiles effectively.

## Topics

<Cards>
  <Card title="Managing Multiple Profiles" href="/docs/local-seo-guide/multi-location/managing-multiple-profiles" description="Organization and workflows" />

  <Card title="Location Pages" href="/docs/local-seo-guide/multi-location/location-pages" description="Website structure" />

  <Card title="Scaling Local SEO" href="/docs/local-seo-guide/multi-location/scaling-local-seo" description="Processes that scale" />
</Cards>


# Location Pages



Location pages are dedicated pages on your website for each physical location. They're essential for multi-location local SEO.

## Why Location Pages Matter

### Local Relevance Signals

Each location page provides:

* Unique content for that location
* Local keywords and context
* NAP information for citations
* Landing page for GBP links

### User Experience

Visitors can find:

* Specific location information
* Directions and contact details
* Services at that location
* Local staff and hours

### Search Engine Understanding

Helps Google understand:

* You have multiple locations
* Where each location serves
* Which location matches which query

## Location Page Essentials

### Required Elements

**NAP Information:**

* Full business name
* Complete street address
* Local phone number
* Match GBP exactly

**Hours of Operation:**

* Regular hours
* Holiday hours
* Special hours

**Map:**

* Embedded Google Map
* Shows exact location
* Helps users and search engines

### Recommended Elements

**Unique Content:**

* Location-specific description
* Local landmarks or directions
* Staff information
* Community involvement

**Local Images:**

* Storefront photo
* Interior photos
* Local team photos
* Neighborhood context

**Services/Products:**

* Services at this location
* Products available
* Location-specific offerings

## URL Structure

### Best Practices

**Option 1: /locations/city-state/**

```
example.com/locations/chicago-il/
example.com/locations/denver-co/
```

**Option 2: /city-state/**

```
example.com/chicago-il/
example.com/denver-co/
```

**Option 3: Subdirectory by region**

```
example.com/midwest/chicago/
example.com/southwest/denver/
```

### Avoid

* Random ID numbers: `/locations/12345/`
* No location indication: `/store-page-3/`
* Keyword stuffing: `/best-plumber-chicago-il-plumbing/`

## Content Strategy

### Unique Content per Page

Don't just change the city name. Include:

* Location-specific details
* Local area information
* Unique services or features
* Staff bios
* Customer testimonials from that area

### Content Elements

**Location Description (200-500 words):**

* What makes this location unique
* Services offered
* Nearby landmarks
* Parking information
* Accessibility features

**Service Area Information:**

* Neighborhoods served
* Nearby cities
* Service radius (if applicable)

**Local FAQ:**

* Questions specific to this location
* Local service information
* Area-specific concerns

## Technical Implementation

### Schema Markup

Add LocalBusiness schema to each page:

```json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Business Name - Chicago",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main Street",
    "addressLocality": "Chicago",
    "addressRegion": "IL",
    "postalCode": "60601"
  },
  "telephone": "+1-312-555-1234",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 41.8781,
    "longitude": -87.6298
  }
}
```

### Internal Linking

Connect location pages:

* From main locations page
* From service pages (when relevant)
* From blog posts about that area
* In footer navigation

### Canonical Tags

Ensure proper canonicalization:

* Each location page self-references
* Avoid duplicate content issues
* Don't canonical all to one page

## Common Mistakes

### Thin Content

**Problem:** Same content, different city name

**Fix:** Create unique content for each location with local details, staff info, and area-specific information.

### Missing NAP

**Problem:** No clear address or phone on page

**Fix:** Display NAP prominently, exactly matching GBP.

### No Schema

**Problem:** Search engines can't parse location data

**Fix:** Add LocalBusiness schema with complete information.

### Poor Mobile Experience

**Problem:** Hard to find contact info on mobile

**Fix:** Click-to-call phone, prominent address, embedded map.

### Orphaned Pages

**Problem:** Location pages not linked from anywhere

**Fix:** Create locations index page, add to navigation, internal link from relevant content.

## Location Index Page

Create a main locations page:

* Lists all locations
* Map showing all locations
* Filter by region/state
* Search by ZIP code
* Links to individual pages

### Index Page Content

* Overview of your locations
* Total number of locations
* Interactive map
* List with key info (address, phone, hours)
* Link to each location page

## Multi-Region Strategies

### National Businesses

* State-level pages
* City-level pages
* Hierarchy: /locations/illinois/chicago/

### Regional Businesses

* Focus on metro areas
* Neighborhood-level for dense areas
* Service area pages for surrounding areas

### International Businesses

* Country-level organization
* Local language content
* Local domain or subdomain considerations

## Performance Optimization

### Page Speed

* Optimize images
* Lazy load maps
* Minimize scripts
* Cache effectively

### Mobile-First

* Responsive design
* Touch-friendly elements
* Fast mobile load time
* Easy navigation

## Key Takeaways

1. Create unique content for each location page
2. Include complete NAP matching your GBP exactly
3. Add LocalBusiness schema markup
4. Use logical, location-based URL structure
5. Link location pages properly throughout your site

<Cards>
  <Card title="Managing Multiple Profiles" href="/docs/local-seo-guide/multi-location/managing-multiple-profiles" />

  <Card title="Scaling Local SEO" href="/docs/local-seo-guide/multi-location/scaling-local-seo" />
</Cards>


# Managing Multiple Profiles



Managing multiple GBP locations requires organization, consistent processes, and the right tools.

## Account Structure

### Business Groups

Google allows organizing locations into groups:

* Create logical groupings (by region, brand, franchise)
* Assign user access at group level
* Manage multiple locations from one dashboard

### User Access Levels

Assign appropriate permissions:

* **Owner**: Full control, can delete
* **Manager**: Can edit all information
* **Site Manager**: Limited editing, location-specific

### Access Best Practices

* Use group-level access for efficiency
* Limit owner access to essential personnel
* Document who has access to what
* Review access quarterly

## Organizational Strategies

### By Geography

Group locations by:

* Region (Northeast, Southwest)
* State or province
* Metropolitan area
* Country (for international)

### By Brand

For multi-brand companies:

* Separate groups per brand
* Maintain brand-specific guidelines
* Different teams for different brands

### By Franchise Structure

For franchise systems:

* Corporate-owned vs franchisee-owned
* Regional franchise groups
* Individual franchisee access

## Consistency at Scale

### Brand Guidelines

Create documentation covering:

* Approved business name format
* Description templates
* Photo requirements and style
* Response templates for reviews

### Naming Conventions

Maintain consistent format:

* <IconCheck /> "Brand Name - City" or "Brand Name City Location"
* <IconX /> Mixing formats across locations
* <IconX /> Adding keywords to names (violates guidelines)

### Information Standards

Standardize:

* Category selection across locations
* Attribute usage
* Hours format
* Service lists

## Bulk Management

### Google Business Profile Manager

Native tools for bulk operations:

* Upload changes via spreadsheet
* Download all location data
* Bulk verification requests
* Multi-location posting

### Spreadsheet Management

Use spreadsheets for:

* Tracking all location information
* Planning updates
* Auditing consistency
* Change documentation

### Third-Party Tools

Consider tools that offer:

* Centralized dashboard
* Automated posting
* Review management
* Analytics aggregation

## Common Challenges

### Keeping Information Current

**Problem:** Information gets outdated across locations

**Solutions:**

* Regular audit schedule
* Change notification process
* Automated monitoring
* Clear ownership per location

### Maintaining Consistency

**Problem:** Different locations have inconsistent information

**Solutions:**

* Central approval process
* Template requirements
* Regular consistency audits
* Training for local managers

### Local Customization vs. Brand Standards

**Problem:** Balancing local needs with brand consistency

**Solutions:**

* Define what can be customized
* What must stay consistent
* Approval process for exceptions
* Clear documentation

## Workflows

### New Location Launch

1. Gather all required information
2. Create GBP listing
3. Apply brand standards
4. Request verification
5. Add to management system
6. Train local staff

### Regular Maintenance

**Weekly:**

* Check for new reviews
* Monitor Q\&A
* Review messages

**Monthly:**

* Verify hours accuracy
* Update seasonal information
* Post fresh content

**Quarterly:**

* Full information audit
* Photo refresh
* Category review

### Closing a Location

1. Update hours to "Permanently Closed"
2. Respond to remaining reviews
3. Remove from active management
4. Document closure date
5. Monitor for duplicate creation

## Team Structure

### Centralized Model

One team manages all locations:

* **Pros:** Consistency, efficiency, expertise
* **Cons:** Less local knowledge, slower response

### Distributed Model

Local teams manage their locations:

* **Pros:** Local knowledge, quick response
* **Cons:** Inconsistency, training needs

### Hybrid Model

Central oversight with local execution:

* Corporate sets standards
* Local teams execute
* Central team monitors
* Best of both worlds

## Reporting and Analytics

### Aggregate Metrics

Track across all locations:

* Total searches and views
* Direction requests
* Phone calls
* Website clicks

### Location Comparison

Compare performance:

* Top performers
* Underperformers
* Trends by region
* Seasonal patterns

### Actionable Insights

Use data to:

* Identify best practices
* Spot problems early
* Allocate resources
* Measure ROI

## Key Takeaways

1. Organize locations logically using Google's group structure
2. Create and enforce brand standards documentation
3. Use bulk management tools for efficiency
4. Establish clear workflows for common tasks
5. Balance central control with local flexibility

<Cards>
  <Card title="Location Pages" href="/docs/local-seo-guide/multi-location/location-pages" />

  <Card title="Scaling Local SEO" href="/docs/local-seo-guide/multi-location/scaling-local-seo" />
</Cards>


# Scaling Local SEO



As your business grows from 5 to 50 to 500 locations, your local SEO processes must scale accordingly.

## Scaling Challenges

### Information Management

More locations mean:

* More data to maintain
* Higher chance of inconsistencies
* Harder to catch errors
* More updates needed

### Review Management

Volume increases:

* Hundreds or thousands of reviews
* Can't respond to each personally
* Need prioritization system
* Response time expectations

### Content Creation

Content needs multiply:

* Unique location pages
* Local posts for each location
* Photo updates
* Seasonal content

### Resource Allocation

Limited resources across:

* Time for management
* Budget for tools
* Personnel for oversight
* Attention for details

## Automation Strategies

### What to Automate

**Information Sync:**

* Hours updates across locations
* Temporary closures
* Holiday hours
* Basic information changes

**Monitoring:**

* Review alerts
* Listing change detection
* Competitor monitoring
* Rank tracking

**Reporting:**

* Performance dashboards
* Weekly/monthly reports
* Alert notifications
* Trend analysis

### What Not to Automate

**Review Responses:**

* Generic responses harm reputation
* Personalization matters
* Context is important
* Use templates as starting points only

**Content Creation:**

* Duplicate content hurts rankings
* Local relevance requires human touch
* Photos need authenticity
* Quality over quantity

## Process Development

### Standard Operating Procedures (SOPs)

Create documentation for:

* New location setup
* Regular maintenance tasks
* Review response guidelines
* Problem escalation
* Audit procedures

### Checklists

**New Location Launch:**

* [ ] Gather business information
* [ ] Create GBP listing
* [ ] Upload photos (minimum 10)
* [ ] Verify location
* [ ] Create website location page
* [ ] Add to management system
* [ ] Initial citations submission
* [ ] Train local team

**Monthly Maintenance:**

* [ ] Verify hours accuracy
* [ ] Check for duplicate listings
* [ ] Review and respond to reviews
* [ ] Update photos if needed
* [ ] Check Q\&A for new questions
* [ ] Post fresh content
* [ ] Review performance metrics

### Workflows

**Review Response Workflow:**

1. Review notification received
2. Categorize (positive/negative/neutral)
3. Assign priority
4. Draft response using template
5. Customize for context
6. Manager approval (if needed)
7. Post response
8. Log completion

## Team Structure at Scale

### Small Scale (5-20 locations)

* 1 person manages all
* May be part of other duties
* Tools help with efficiency

### Medium Scale (20-100 locations)

* Dedicated local SEO manager
* Regional coordinators
* Shared support staff

### Large Scale (100+ locations)

* Local SEO team
* Regional managers
* Corporate oversight
* External agency support

### Roles and Responsibilities

**Corporate/Central:**

* Strategy and standards
* Tool selection and management
* Training and documentation
* Performance monitoring
* Vendor relationships

**Regional:**

* Local implementation
* Quality control
* Escalation handling
* Local partnerships

**Location Level:**

* Daily monitoring
* Photo capture
* Customer interaction
* Issue reporting

## Technology Stack

### Essential Tools

**GBP Management:**

* Centralized dashboard
* Bulk editing capabilities
* Multi-user access
* Audit trails

**Review Management:**

* Aggregated review feed
* Response workflow
* Sentiment analysis
* Response templates

**Rank Tracking:**

* Local rank monitoring
* Multiple locations
* Competitor comparison
* Trend reporting

**Analytics:**

* Consolidated reporting
* Location comparison
* Custom dashboards
* Export capabilities

### Tool Selection Criteria

* Supports your location count
* API availability
* Integration options
* Pricing scalability
* Support quality

## Budget Considerations

### Cost Categories

**Tools and Software:**

* GBP management platform
* Review management
* Rank tracking
* Reporting tools

**Personnel:**

* Internal team
* Agency fees
* Freelancer costs

**Content:**

* Photography
* Copywriting
* Design work

### Budget Allocation

* 40-50% personnel
* 30-40% tools
* 10-20% content/creative

### ROI Measurement

Track investment against:

* Search visibility improvement
* Review volume and rating
* Website traffic from local
* Direction requests
* Phone calls

## Quality Control

### Regular Audits

**Weekly:**

* Review response completion
* New listing issues
* Customer complaints

**Monthly:**

* Information accuracy check
* Photo quality review
* Post schedule adherence

**Quarterly:**

* Full location audit
* Competitive analysis
* Strategy review

### Quality Metrics

* Information accuracy rate
* Review response time
* Review response rate
* Content freshness
* Photo completeness

## Communication

### Internal Communication

* Regular team meetings
* Documentation updates
* Training sessions
* Performance reviews

### Escalation Paths

Define when to escalate:

* Negative review crisis
* Information errors
* Duplicate listings
* Suspension issues

### Reporting Cadence

* Daily: Critical alerts only
* Weekly: Key metrics summary
* Monthly: Full performance report
* Quarterly: Strategic review

## Continuous Improvement

### Learning from Data

* Identify top performers
* Understand what works
* Share best practices
* Apply learnings broadly

### Testing and Optimization

* Test different post types
* Experiment with photos
* Try response variations
* Measure and iterate

### Staying Current

* Follow Google updates
* Industry best practices
* Competitor monitoring
* Training and education

## Key Takeaways

1. Develop clear SOPs and checklists for all processes
2. Automate monitoring and reporting, not customer interaction
3. Invest in tools that scale with your growth
4. Build team structure that matches your scale
5. Maintain quality through regular audits and metrics

<Cards>
  <Card title="Managing Multiple Profiles" href="/docs/local-seo-guide/multi-location/managing-multiple-profiles" />

  <Card title="Location Pages" href="/docs/local-seo-guide/multi-location/location-pages" />
</Cards>


# Auditing Citations



Regular citation audits identify problems before they hurt your rankings. Here's how to systematically review your citations.

## Why Audit Citations

### Find Inconsistencies

Discover NAP variations across the web.

### Identify Duplicates

Find and merge duplicate listings.

### Spot Outdated Info

Locate listings with old addresses or phone numbers.

### Discover Opportunities

Find directories where you're not yet listed.

## Manual Audit Process

### Step 1: Search for Your Business

Search Google for:

* "Your Business Name"
* "Your Business Name + City"
* Your phone number
* Your address

### Step 2: Document Findings

Create a spreadsheet tracking:

* Site name
* URL
* NAP as listed
* Correct? (Y/N)
* Claimed? (Y/N)
* Login credentials
* Last updated

### Step 3: Check Major Sites

Manually verify these important sites:

* Google Business Profile
* Apple Maps
* Bing Places
* Facebook
* Yelp
* Yellow Pages
* BBB

### Step 4: Search Variations

Search for common misspellings or variations:

* Old business names
* Abbreviated names
* Common typos

## Automated Audit Tools

### Free Tools

* Moz Local (free check)
* Google search operators

### Paid Tools

* BrightLocal
* Whitespark Citation Finder
* Moz Local (full version)
* Yext

### Tool Benefits

* Faster than manual
* More comprehensive coverage
* Ongoing monitoring
* Inconsistency alerts

## What to Look For

### NAP Issues

* Wrong address (even partial)
* Wrong phone number
* Wrong business name variation
* Mixed old and new info

### Listing Issues

* Duplicate listings on same platform
* Wrong business category
* Wrong hours
* Missing website

### Quality Issues

* Incomplete profiles
* No photos
* Outdated description

## Prioritizing Fixes

### Priority 1: Critical

* Google Business Profile errors
* Apple Maps/Bing errors
* Major directory errors (Yelp, Facebook)

### Priority 2: Important

* Data aggregator errors
* Industry-specific directory errors
* Duplicate listings

### Priority 3: Maintenance

* Minor directories
* Incomplete profiles
* Missing optional info

## Fixing Citations

### Listings You Can Claim

1. Find claim/edit option
2. Verify ownership
3. Update information
4. Save and verify changes

### Listings You Can't Claim

1. Find site contact info
2. Send correction request
3. Include correct information
4. Follow up after 2 weeks

### Data Aggregators

Submit corrections to major aggregators—fixes propagate to many sites:

* Foursquare
* Data Axle
* Localeze
* Acxiom

## Handling Duplicates

### Same Platform Duplicates

If you have 2+ listings on one platform:

1. Identify the "real" listing
2. Claim the real one
3. Request removal of duplicates
4. Report through platform's help system

### Google Duplicates

For Google Maps/GBP duplicates:

1. Report as duplicate through Maps
2. Claim your correct listing
3. Mark duplicates as "not a real place" or report

## Audit Frequency

### Full Audit

* Annually for stable businesses
* After any business changes
* When rankings drop unexpectedly

### Spot Checks

* Monthly for major sites
* After address/phone changes
* When building new citations

## Audit Spreadsheet Template

| Site   | URL     | Listed Name        | Listed Address  | Listed Phone   | Correct? | Claimed? | Action      |
| ------ | ------- | ------------------ | --------------- | -------------- | -------- | -------- | ----------- |
| Google | \[link] | Joe's Plumbing     | 123 Main St     | 555-1234       | Yes      | Yes      | None        |
| Yelp   | \[link] | Joe's Plumbing Inc | 123 Main Street | (555) 123-4567 | No       | No       | Claim & fix |

## After the Audit

### Create Fix List

Prioritize issues to fix:

1. Critical platform errors
2. NAP inconsistencies
3. Unclaimed listings
4. Incomplete profiles

### Track Progress

Monitor:

* Fixes completed
* Fixes verified
* Remaining issues

### Schedule Next Audit

Set calendar reminder for next audit.

## Key Takeaways

1. Audit citations at least annually
2. Use both manual and automated methods
3. Prioritize fixing critical platforms first
4. Submit corrections to data aggregators
5. Track all listings in a central spreadsheet

<Cards>
  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" />

  <Card title="Local Citations" href="/docs/local-seo-guide/nap-and-citations/local-citations" />
</Cards>


# NAP & Citations



NAP (Name, Address, Phone) consistency across the web is foundational to local SEO. Citations help build trust and visibility.

## Topics

<Cards>
  <Card title="What is NAP?" href="/docs/local-seo-guide/nap-and-citations/what-is-nap" description="Name, Address, Phone explained" />

  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" description="Why consistency matters" />

  <Card title="Local Citations" href="/docs/local-seo-guide/nap-and-citations/local-citations" description="Building citation presence" />

  <Card title="Auditing Citations" href="/docs/local-seo-guide/nap-and-citations/auditing-citations" description="Finding and fixing issues" />
</Cards>


# Local Citations



Local citations are online mentions of your business NAP. They signal to Google that your business is legitimate and established.

## What Are Citations?

Citations are mentions of your business information online, including:

* Business directories
* Social platforms
* Industry sites
* Local websites
* Apps and maps

## Types of Citations

### Structured Citations

Formal business listings with consistent format:

* Google Business Profile
* Yelp
* Yellow Pages
* Facebook Business Page
* Apple Maps

### Unstructured Citations

Mentions in content, articles, or blogs:

* News articles
* Blog posts
* Event listings
* Sponsor mentions

## Why Citations Matter

### Trust Signals

More citations = more validation that your business exists.

### Ranking Factor

Citations are approximately 5% of local ranking factors, but they support other signals.

### Discovery

Customers find you on various platforms, not just Google.

### Link Building

Many directories provide backlinks to your website.

## Major Citation Sources

### Universal Directories

Every business should be listed on:

| Directory               | Priority |
| ----------------------- | -------- |
| Google Business Profile | Critical |
| Apple Maps              | High     |
| Bing Places             | High     |
| Facebook                | High     |
| Yelp                    | High     |
| Yellow Pages            | Medium   |
| Better Business Bureau  | Medium   |

### Data Aggregators

These feed data to many directories:

* Foursquare
* Data Axle (formerly InfoUSA)
* Localeze
* Acxiom

### Industry-Specific Directories

Depends on your industry:

**Healthcare:**

* Healthgrades
* WebMD
* Zocdoc
* Vitals

**Legal:**

* Avvo
* FindLaw
* Justia
* Lawyers.com

**Restaurants:**

* TripAdvisor
* OpenTable
* Zomato
* Grubhub

**Home Services:**

* Angi (Angie's List)
* HomeAdvisor
* Houzz
* Thumbtack

### Local Citations

* Chamber of Commerce
* Local newspaper websites
* City/town business directories
* Local blog mentions

## Building Citations

### Priority Order

1. Claim GBP and ensure accuracy
2. Submit to data aggregators
3. Claim major directory listings
4. Add industry-specific directories
5. Build local citations

### Claiming vs Creating

* **Claiming:** Taking control of existing listing
* **Creating:** Adding new listing where none exists

Always search first to avoid duplicates.

### Quality Over Quantity

* 50 high-quality citations beat 500 low-quality ones
* Focus on relevant, authoritative sites
* Avoid spammy directories

## Citation Checklist

For each citation, ensure:

* [ ] NAP matches exactly
* [ ] Category is accurate
* [ ] Hours are correct
* [ ] Website URL is correct
* [ ] Description is complete
* [ ] Photos are uploaded (where possible)

## Citation Building Process

### Step 1: Audit Current Citations

Know what exists before building more.

### Step 2: Fix Inconsistencies

Correct any NAP issues in existing citations.

### Step 3: Claim Unclaimed Listings

Take ownership of auto-created listings.

### Step 4: Build New Citations

Add to priority directories you're missing.

### Step 5: Maintain

Regularly check and update citations.

## Citation Building Services

### DIY vs Managed

**DIY:** Cheaper but time-consuming
**Managed Services:** Faster but costs money

### Popular Tools

* Moz Local
* BrightLocal
* Yext
* Whitespark

### Considerations

* One-time build vs ongoing management
* Data ownership
* Removal fees (some services)

## Citation Velocity

### Don't Build Too Fast

* Sudden surge looks unnatural
* Build steadily over time
* Focus on quality first

### Recommended Pace

* 10-20 citations per month for new businesses
* 5-10 per month for maintenance

## Local Link Building Through Citations

Some citations provide backlinks:

* Follow links (pass SEO value)
* NoFollow links (less SEO value but still good)

Focus on authoritative sites for best link value.

## Key Takeaways

1. Citations validate your business exists
2. Prioritize major platforms and aggregators
3. Industry-specific directories matter
4. Quality beats quantity
5. Maintain NAP consistency across all citations

<Cards>
  <Card title="Auditing Citations" href="/docs/local-seo-guide/nap-and-citations/auditing-citations" />

  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" />
</Cards>


# NAP Consistency



NAP consistency is one of the top local SEO ranking factors. Inconsistencies confuse search engines and erode trust.

## Why Consistency Matters

### Search Engine Confusion

Google cross-references business data across sources. When it finds:

* "Main Street" in one place, "Main St" in another
* Different phone numbers on different sites
* Slightly different business names

It may:

* Trust your data less
* Rank you lower
* Show incorrect information

### Real-World Impact

**Case Study:** A business moved locations but kept the same phone number. The inconsistent address across old citations caused them to drop from #2 to off the first page for 2 years.

### Customer Experience

Inconsistent NAP leads to:

* Customers going to wrong address
* Calls to disconnected numbers
* Frustration and lost business

## Types of Inconsistencies

### Format Variations

Same info, different format:

* "123 Main Street" vs "123 Main St."
* "(555) 123-4567" vs "555-123-4567"
* "Company, Inc." vs "Company Inc"

### Data Errors

Actual mistakes:

* Wrong suite number
* Transposed phone digits
* Misspelled street name

### Outdated Information

* Previous addresses
* Old phone numbers
* Former business names

## How Inconsistencies Happen

### Historical Changes

* Business moved locations
* Phone number changed
* Rebranded or renamed

### Automated Listings

* Data aggregators spread old data
* Directories auto-create listings
* Third parties scrape incorrect info

### Human Error

* Staff enter info differently
* Typos during setup
* Copy-paste errors

## Establishing Your Canonical NAP

### Step 1: Define Your Standard

Create a master document with exact format:

```
Business Name: Joe's Plumbing Services LLC
Address: 123 Main Street, Suite 100, Chicago, IL 60601
Phone: (312) 555-1234
Website: https://www.joesplumbing.com
```

### Step 2: Use Google Business Profile as Source

Your GBP listing should be the authority. All other listings should match it exactly.

### Step 3: Document Everything

Keep a record of:

* Exact formatting to use
* All platforms where you're listed
* Login credentials for each platform

## Maintaining Consistency

### When Making Changes

If you need to update your NAP:

1. Update GBP first
2. Update your website
3. Update major directories (Yelp, Facebook, etc.)
4. Update data aggregators
5. Update remaining citations over time

### Regular Audits

Check NAP consistency:

* Monthly for high-priority sites
* Quarterly for full audit
* After any business changes

### Training Staff

Ensure anyone who might enter your business info:

* Uses the documented format
* Knows why consistency matters
* Has access to master document

## Priority Platforms for NAP

### Tier 1 (Most Important)

* Google Business Profile
* Your website
* Apple Maps
* Bing Places
* Facebook Business

### Tier 2 (Important)

* Yelp
* Yellow Pages
* Better Business Bureau
* Industry-specific directories

### Tier 3 (Helpful)

* Local directories
* Chamber of Commerce
* Niche sites

## Tools for NAP Monitoring

### Manual Checking

Search for your business name and review results.

### Automated Tools

* Moz Local
* BrightLocal
* Yext
* Whitespark

These scan the web for your NAP and identify inconsistencies.

## Fixing Inconsistencies

### Claim Listings

If you find incorrect listings:

1. Claim the listing if possible
2. Update to correct information
3. Verify changes take effect

### Contact Site Owners

For sites you can't claim:

* Find contact information
* Send correction request
* Follow up if needed

### Data Aggregators

Submit correct data to major aggregators:

* Foursquare (Factual)
* Data Axle
* Localeze
* Acxiom

Correct data flows to many directories.

## Key Takeaways

1. NAP inconsistencies hurt rankings
2. Even small format differences matter
3. Establish a canonical NAP format
4. Use GBP as your source of truth
5. Audit regularly and fix issues promptly

<Cards>
  <Card title="Local Citations" href="/docs/local-seo-guide/nap-and-citations/local-citations" />

  <Card title="Auditing Citations" href="/docs/local-seo-guide/nap-and-citations/auditing-citations" />
</Cards>


# What is NAP?



NAP stands for Name, Address, and Phone Number—the three core pieces of business information that appear across the web.

## NAP Components

### Name

Your official business name exactly as it appears on:

* Legal documents
* Storefront signage
* Google Business Profile

### Address

Your complete physical address:

* Street address
* Suite/unit number
* City, State, ZIP code

### Phone Number

Your primary contact number:

* Local area code preferred
* Consistent format everywhere

## Why NAP Matters

### Search Engine Understanding

Google cross-references your NAP across sources to:

* Verify your business exists
* Confirm location accuracy
* Build confidence in your data

### Customer Trust

Consistent information:

* Builds credibility
* Reduces confusion
* Ensures customers can find you

### Ranking Impact

NAP consistency affects:

* Local Pack rankings
* Map accuracy
* Citation value

## Where NAP Appears

### Your Properties

* Website
* Google Business Profile
* Social media profiles
* Email signatures

### Third-Party Sites

* Business directories (Yelp, Yellow Pages)
* Industry directories
* Data aggregators
* Review sites

### Unstructured Mentions

* News articles
* Blog posts
* Press releases

## NAP Format Standards

### Business Name

Use your exact legal/trading name:

* <IconCheck /> Joe's Plumbing Inc.
* <IconX /> Joe's Plumbing - Best Plumber in Town

### Address Format

Use consistent formatting:

* <IconCheck /> 123 Main Street, Suite 100
* <IconX /> 123 Main St Ste 100

Choose one format and use it everywhere.

### Phone Format

Pick one format:

* (555) 123-4567
* 555-123-4567
* 555.123.4567

Use the same format across all listings.

## NAP+ Extended Information

Beyond basic NAP, consistency also matters for:

* Website URL
* Business hours
* Business categories
* Business description

## Common NAP Issues

### Variations

* "Street" vs "St"
* "Avenue" vs "Ave"
* Different phone formats

### Outdated Information

* Old addresses after moving
* Old phone numbers
* Closed locations

### Inconsistent Names

* Using abbreviations sometimes
* Including/excluding "Inc." or "LLC"
* Different DBA names

## Key Takeaways

1. NAP = Name, Address, Phone
2. Consistency across all platforms is critical
3. Small variations can cause problems
4. Choose one format and stick to it
5. Regularly audit for inconsistencies

<Cards>
  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" />

  <Card title="Local Citations" href="/docs/local-seo-guide/nap-and-citations/local-citations" />
</Cards>


# Optimization



A complete, optimized profile ranks better and converts more customers. This section covers optimization strategies.

## Topics

<Cards>
  <Card title="Profile Completeness" href="/docs/local-seo-guide/optimization/profile-completeness" description="Why 100% completion matters" />

  <Card title="Photos & Media" href="/docs/local-seo-guide/optimization/photos-and-media" description="Photo guidelines and best practices" />

  <Card title="Posts" href="/docs/local-seo-guide/optimization/posts" description="Updates, offers, and events" />

  <Card title="Products & Services" href="/docs/local-seo-guide/optimization/products-and-services" description="Listing what you offer" />

  <Card title="Q&A" href="/docs/local-seo-guide/optimization/questions-and-answers" description="Managing the Q&A section" />

  <Card title="Messaging" href="/docs/local-seo-guide/optimization/messaging" description="Chat feature setup" />
</Cards>


# Messaging



Google Business Profile messaging lets customers chat with you directly from your listing. It can drive leads but requires active management.

## How Messaging Works

### Customer Experience

1. Customer finds your listing
2. Clicks "Chat" or "Message" button
3. Types their question
4. You receive notification
5. Conversation continues until resolved

### Where Messages Appear

Customers can message from:

* Google Search (Knowledge Panel)
* Google Maps
* Google Maps app

## Enabling Messaging

### Setup Steps

1. Go to GBP dashboard
2. Navigate to "Messages"
3. Turn on messaging
4. Set up welcome message
5. Download GBP app for notifications

### Welcome Message

Automatic first response when someone messages:

**Example:**

> Thanks for reaching out to \[Business Name]! We typically respond within 1 hour during business hours. How can we help you today?

## Benefits of Messaging

### Lead Generation

* Low-friction contact method
* Captures customers in the moment
* Alternative to phone calls

### Customer Preference

* Many prefer text over phone
* Can message outside business hours
* Keeps record of conversation

### Competitive Advantage

* Not all businesses enable messaging
* Shows you're accessible
* Modern customer service

## Challenges

### Response Time Expectations

* Customers expect quick replies
* Google tracks response time
* Slow responses = poor experience

### After-Hours Messages

* Messages come 24/7
* Need plan for off-hours
* Set expectations in welcome message

### Resource Requirements

* Someone must monitor
* Need mobile app installed
* Requires consistent attention

## Best Practices

### Response Time

* Aim for under 1 hour during business hours
* Set up auto-reply for after hours
* Google may disable messaging if you're slow

### Auto-Responses

Set up automated messages for:

* After hours
* Busy periods
* Common questions

### Message Quality

* Be helpful and friendly
* Answer the actual question
* Provide next steps
* Include contact info for complex issues

### Transition to Other Channels

For complex needs, transition appropriately:

* "Let me call you to discuss this in detail"
* "I'll send you an email with all the information"
* "Can you call us at \[number] to schedule?"

## Managing Multiple Locations

### Centralized Management

* Use GBP app or dashboard
* Assign team members per location
* Create consistent response templates

### Location-Specific Responses

* Know which location the message is for
* Provide location-specific information
* Transfer to appropriate team member

## When to Disable Messaging

Consider disabling if:

* You can't monitor consistently
* Response times are suffering
* It's creating more problems than leads

Poor messaging experience is worse than no messaging.

## Messaging Metrics

Track in GBP Insights:

* Number of messages received
* Response rate
* Average response time
* Conversation outcomes

## Integration Options

### Third-Party Tools

Some tools can help manage GBP messaging:

* Centralized inbox
* Team assignments
* Automated responses

### Chatbots

Currently limited support for automated chatbots on GBP, but basic auto-replies available.

## Key Takeaways

1. Only enable if you can respond quickly
2. Set clear expectations in welcome message
3. Aim for under 1-hour response time
4. Use auto-replies for after hours
5. Monitor metrics and adjust

<Cards>
  <Card title="Profile Completeness" href="/docs/local-seo-guide/optimization/profile-completeness" />

  <Card title="Reviews" href="/docs/local-seo-guide/reviews" />
</Cards>


# Photos & Media



Businesses with photos receive 42% more requests for directions and 35% more clicks to their websites.

## Why Photos Matter

### Customer Engagement

* Photos are the most viewed content on GBP
* Help customers visualize your business
* Build trust before they visit

### Rankings

* Profiles with photos rank better
* Photo quantity and quality both matter
* Regular uploads signal activity

### Decision Making

* 60% of consumers say images influence their decisions
* Interior photos set expectations
* Product photos drive purchases

## Photo Types

### Logo

Your business logo displayed on profile.

**Specifications:**

* Size: 720 x 720 pixels (square)
* Format: JPG or PNG
* Max file size: 5MB

### Cover Photo

The main banner image on your profile.

**Specifications:**

* Size: 1080 x 608 pixels (16:9 ratio)
* Format: JPG or PNG
* Max file size: 5MB

### Business Photos

General photos of your business.

**Categories:**

* **Exterior**: Help customers find your location
* **Interior**: Show your space and atmosphere
* **Products**: What you sell
* **Services**: Services in action
* **Team**: Your employees
* **Food & Drink**: Menu items (restaurants)

**Specifications:**

* Minimum: 720 x 720 pixels
* Recommended: 1200 x 900 pixels (4:3 ratio)
* Format: JPG or PNG
* Max file size: 5MB per photo

## Photo Best Practices

### Quality Guidelines

* Well-lit (natural light is best)
* In-focus and sharp
* High resolution
* No heavy filters
* No watermarks or overlays
* No stock photos

### What to Avoid

* Blurry or dark images
* Stock photography (Google may remove)
* AI-generated images
* Excessive text overlays
* Promotional banners
* Misleading images

### Content Guidelines

* Show your actual business
* Feature real employees (with permission)
* Capture authentic moments
* Update seasonally if relevant

## Video Guidelines

GBP supports short videos.

**Specifications:**

* Duration: Up to 30 seconds
* Resolution: 720p minimum (1080p recommended)
* Aspect ratio: 16:9 (widescreen)
* Format: MP4
* Max file size: 75MB

**Video Ideas:**

* Business tour
* Team introduction
* Product demonstrations
* Customer testimonials
* Behind the scenes

## Photo Quantity Recommendations

| Business Type         | Minimum | Recommended |
| --------------------- | ------- | ----------- |
| Retail                | 10      | 25+         |
| Restaurant            | 15      | 30+         |
| Service Business      | 5       | 15+         |
| Professional Services | 5       | 10+         |

## Uploading Photos

### From GBP Dashboard

1. Go to your profile
2. Click "Add photo"
3. Select photo type/category
4. Upload and save

### From Google Maps

1. Find your business on Maps
2. Click "Add a photo"
3. Upload directly

### Customer Photos

Customers can also upload photos. You cannot remove these unless they violate guidelines.

## Managing Photos

### Monitoring Customer Photos

* Review customer-uploaded photos regularly
* Flag inappropriate content for removal
* Engage positively with customer photos

### Removing Photos

You can remove photos you uploaded:

1. Go to Photos section
2. Select the photo
3. Click delete

For customer photos, you can only flag violations:

* Irrelevant content
* Inappropriate content
* Wrong location

### Photo Organization

Google auto-categorizes photos, but you can help by:

* Adding photos to specific categories
* Using descriptive file names
* Uploading similar photos together

## Photo Impact on Search

Photos can appear in:

* Local Pack results
* Knowledge Panel
* Google Maps
* Image search results
* Google Discover

Well-optimized photos increase visibility across all these surfaces.

## Key Takeaways

1. Businesses with photos get significantly more engagement
2. Upload high-quality, authentic images
3. Include variety: exterior, interior, products, team
4. Avoid stock photos and heavy editing
5. Upload new photos regularly

<Cards>
  <Card title="Posts" href="/docs/local-seo-guide/optimization/posts" />

  <Card title="Products & Services" href="/docs/local-seo-guide/optimization/products-and-services" />
</Cards>


# Posts



Google Business Profile posts let you share updates, promotions, and events directly on your profile. Regular posting signals an active business.

## Post Types

### Updates (What's New)

General updates about your business.

**Use for:**

* News and announcements
* New products or services
* Company milestones
* Behind-the-scenes content
* Tips and advice

### Offers

Promotional deals and discounts.

**Required fields:**

* Title
* Start and end dates
* Terms and conditions (optional)

**Features:**

* "View Offer" button auto-added
* Coupon code field available
* Highlighted with special formatting

### Events

Promote upcoming events.

**Required fields:**

* Title
* Start date and time
* End date and time

**Use for:**

* Grand openings
* Sales events
* Classes or workshops
* Community events

## Post Specifications

### Text

* Maximum: 1,500 characters
* Visible preview: \~80 characters
* Lead with the most important info

### Images

* Recommended: 1200 x 900 pixels (4:3 ratio)
* Minimum: 400 x 300 pixels
* Format: JPG or PNG
* No excessive text overlay

### Videos

* Maximum: 30 seconds
* Minimum: 720p resolution
* Format: MP4

### Call-to-Action Buttons

Available buttons:

* Book
* Order online
* Buy
* Learn more
* Sign up
* Call now

## Best Practices

### Posting Frequency

* **Minimum**: Once per week
* **Optimal**: 2-3 times per week
* **Maximum**: Don't spam (1 per day is plenty)

### Content Strategy

* Mix post types (updates, offers, events)
* 60% value, 40% promotional
* Tie into seasons and holidays
* Highlight what makes you unique

### Writing Effective Posts

**Do:**

* Lead with value or hook
* Keep it concise
* Include a clear CTA
* Use relevant keywords naturally
* Add a compelling image

**Don't:**

* Use ALL CAPS
* Include phone numbers in text
* Use excessive hashtags (they don't work)
* Post the same content repeatedly
* Use stock photos

### Example Posts

**Good Update Post:**

> New fall menu now available! Try our pumpkin spice latte and maple pecan scone. Made fresh daily with locally sourced ingredients. Stop by this week!

**Good Offer Post:**

> Save 20% on all services this month. New customers only. Book your appointment today and mention this offer. Valid through October 31.

**Good Event Post:**

> Grand Opening Celebration - Saturday, Nov 15 from 10am-2pm. Free samples, live music, and prizes. Bring the family!

## Post Lifespan

### Updates

* Prominent for \~7 days
* Then move to lower visibility
* Don't disappear entirely

### Offers

* Active until end date
* Removed after expiration
* Plan around your promotion schedule

### Events

* Active until event date passes
* Build anticipation beforehand
* Consider post-event recap

## Posts and SEO

### Ranking Impact

Posts may help with:

* Freshness signals (active business)
* Keyword relevance (post content)
* Engagement metrics (clicks, views)

### Keyword Strategy

Include relevant keywords naturally:

* Service keywords
* Location keywords
* Problem/solution keywords

Don't keyword stuff—write for humans first.

## Tracking Post Performance

### GBP Insights

View for each post:

* Views
* Clicks
* Button clicks

### UTM Parameters

Add UTM tags to track in Google Analytics:

```
?utm_source=google&utm_medium=gbp&utm_campaign=fall-offer
```

## Automating Posts

### Scheduling

Use tools to schedule posts in advance:

* Plan content calendars
* Maintain consistency
* Reduce manual work

### Synoveo Integration

Synoveo can automate posts based on:

* WordPress content
* WooCommerce products
* Scheduled campaigns

## Key Takeaways

1. Post at least weekly to signal activity
2. Mix update, offer, and event posts
3. Lead with value, not just promotions
4. Include compelling images
5. Track performance and adjust strategy

<Cards>
  <Card title="Products & Services" href="/docs/local-seo-guide/optimization/products-and-services" />

  <Card title="Advanced Post Strategy" href="/docs/local-seo-guide/advanced/posts-strategy" />
</Cards>


# Products & Services



Adding products and services helps customers understand what you offer and improves your visibility for relevant searches.

## Products vs Services

### Products

Physical items you sell:

* Retail merchandise
* Food menu items
* Manufactured goods

**Features:**

* Photos
* Prices
* Descriptions
* Categories
* Links to purchase

### Services

What you do for customers:

* Professional services
* Home services
* Personal services

**Features:**

* Service name
* Description
* Price or price range (optional)
* Categories

## Adding Products

### Product Information

For each product, include:

**Required:**

* Product name
* Category

**Recommended:**

* Description (up to 1,000 characters)
* Price
* Photo
* Link to product page

### Product Categories

Organize products into categories:

* Makes browsing easier
* Helps Google understand your offerings
* Improves search relevance

### Product Photos

* High-quality images
* Show product clearly
* Multiple angles if possible
* Consistent style across products

### Pricing Options

* Fixed price: $29.99
* Price range: $20-$50
* "From" pricing: From $99
* No price: Leave blank if varies

## Adding Services

### Service Listings

For each service:

**Required:**

* Service name

**Recommended:**

* Description
* Price or "Free estimates"
* Duration (if applicable)

### Service Categories

Group related services:

* Primary services
* Add-on services
* Specialty services

### Service Descriptions

Write clear, benefit-focused descriptions:

* What the service includes
* Who it's for
* What problems it solves

**Example:**

> Complete home plumbing inspection. Our licensed plumbers check all fixtures, pipes, and water heater. Includes written report with recommendations. Takes approximately 1 hour.

## Menu Items (Restaurants)

Restaurants have special menu features:

### Menu Sections

* Appetizers
* Main courses
* Desserts
* Drinks
* Specials

### Menu Item Details

* Item name
* Description
* Price
* Photo (highly recommended)
* Dietary tags (vegetarian, gluten-free)

### Third-Party Menus

Google may pull menu data from:

* Your website
* Delivery platforms
* Third-party menu services

Claim and verify your menu data for accuracy.

## Best Practices

### Keep Lists Updated

* Remove discontinued items
* Update prices promptly
* Add new offerings quickly

### Use Keywords Naturally

Include relevant search terms:

* Service type keywords
* Problem-solving keywords
* Location if relevant

### Pricing Transparency

* Show prices when possible
* Builds trust
* Filters qualified leads

### Quality Images

* Professional product photos
* Consistent lighting and style
* Show scale when helpful

## Products/Services and Search

### Search Visibility

Products and services can appear in:

* GBP Knowledge Panel
* Local Pack (for relevant queries)
* Google Shopping (products)
* "Services" filter on Maps

### Keyword Matching

Google matches searches to your listings:

* "pizza delivery" → matches "Delivery" service
* "brake repair" → matches "Brake Service"

## Syncing with Your Website

### WooCommerce/E-commerce

Sync product catalogs automatically with tools like Synoveo.

### Benefits of Syncing

* One source of truth
* Automatic updates
* Consistent pricing
* Time savings

## Key Takeaways

1. List all products and services you offer
2. Include descriptions, prices, and photos
3. Organize into logical categories
4. Keep listings current and accurate
5. Use keywords naturally in descriptions

<Cards>
  <Card title="Q&A" href="/docs/local-seo-guide/optimization/questions-and-answers" />

  <Card title="Photos & Media" href="/docs/local-seo-guide/optimization/photos-and-media" />
</Cards>


# Profile Completeness



Google favors complete profiles. Businesses with fully completed profiles are 2.7x more likely to be considered reputable.

## Why Completeness Matters

### Ranking Impact

* Complete profiles rank higher in Local Pack
* More content = more relevance signals
* Google trusts complete profiles more

### Customer Trust

* Incomplete profiles look abandoned
* Missing info creates friction
* Complete profiles answer customer questions

### Conversion Rate

* More info = fewer barriers to contact
* Photos increase engagement
* Hours prevent wasted trips

## Profile Completeness Checklist

### Basic Information (Required)

* [ ] Business name (exact, no keywords)
* [ ] Address (or service areas for SABs)
* [ ] Phone number
* [ ] Website URL
* [ ] Business hours
* [ ] Primary category

### Enhanced Information

* [ ] Business description (750 characters)
* [ ] Secondary categories (3-5)
* [ ] Opening date
* [ ] "From the business" snippet

### Visual Content

* [ ] Logo
* [ ] Cover photo
* [ ] Interior photos (3+)
* [ ] Exterior photos (3+)
* [ ] Team photos
* [ ] Product/service photos

### Services & Products

* [ ] Services listed
* [ ] Products listed (if applicable)
* [ ] Menu items (restaurants)
* [ ] Pricing where appropriate

### Attributes

* [ ] Accessibility features
* [ ] Payment methods
* [ ] Service options
* [ ] Amenities
* [ ] Health & safety

### Engagement Features

* [ ] Messaging enabled
* [ ] Q\&A seeded with FAQs
* [ ] Review responses up to date
* [ ] Posts published (weekly)

## Measuring Completeness

### GBP Dashboard

Google shows a completeness score for your profile. Aim for 100%.

### What Counts

* Each section has a weight
* Some fields more important than others
* Photos have significant impact

## Priority Order for Completion

If starting from scratch, complete in this order:

1. **NAP + Hours**: Critical for basic functionality
2. **Category**: Major ranking factor
3. **Description**: Helps relevance
4. **Photos**: High engagement impact
5. **Services/Products**: Helps discovery
6. **Attributes**: Improves filtering
7. **Posts**: Signals activity

## Common Gaps

### Missing Photos

Many businesses have no photos or only a few. Add:

* Exterior (help customers find you)
* Interior (set expectations)
* Products/services (show what you offer)
* Team (build personal connection)

### No Description

The description is free text to explain your business. Use all 750 characters.

### Missing Services

If you offer multiple services, list them all. Each is a potential search match.

### Outdated Hours

Especially holiday hours. Update seasonally.

## Maintaining Completeness

### Regular Audits

Monthly review of your profile:

* Are hours still accurate?
* Any new services to add?
* New photos to upload?
* Recent reviews to respond to?

### After Changes

Update profile when:

* Hours change
* Services change
* Location changes
* Contact info changes

## Key Takeaways

1. Complete profiles rank and convert better
2. Aim for 100% completeness
3. Prioritize photos and services
4. Audit monthly for accuracy
5. Keep all information current

<Cards>
  <Card title="Photos & Media" href="/docs/local-seo-guide/optimization/photos-and-media" />

  <Card title="Posts" href="/docs/local-seo-guide/optimization/posts" />
</Cards>


# Questions & Answers



The Q\&A section lets anyone ask questions about your business—and anyone can answer. Active management is essential.

## How Q\&A Works

### Who Can Participate

* Anyone can ask questions
* Anyone can answer (not just you)
* Answers can be upvoted

### Where It Appears

* On your GBP Knowledge Panel
* In Google Maps listing
* Visible to all searchers

## Why Q\&A Matters

### Customer Service

* Answers common questions publicly
* Reduces repetitive inquiries
* Available 24/7

### Trust Building

* Shows you're responsive
* Demonstrates expertise
* Humanizes your business

### SEO Value

* Questions contain keywords
* Answers add relevant content
* May influence rankings

## Managing Q\&A

### Monitor Regularly

Check Q\&A section frequently:

* Daily for high-traffic businesses
* Weekly minimum for all businesses
* Set up alerts if possible

### Respond Quickly

* Answer new questions within 24 hours
* Business owner answers carry more weight
* Mark your answers as from "Owner"

### Handle Incorrect Answers

Others may answer incorrectly:

* Provide correct answer (will appear alongside)
* Upvote accurate answers
* Report spam or abuse

## Pre-Seeding Questions

You can (and should) add your own FAQs.

### How to Seed Q\&A

1. Have someone ask common questions
2. Answer as the business owner
3. Upvote your answers

### Questions to Pre-Seed

* Operating hours and policies
* Parking information
* Payment methods accepted
* Accessibility features
* Popular services/products
* COVID policies (if relevant)

### Example Pre-Seeded Q\&A

**Q: Do you accept walk-ins or appointment only?**
A: We accept both! Walk-ins are welcome during business hours. For guaranteed availability, we recommend booking online at \[website].

**Q: Is there parking available?**
A: Yes! Free parking is available in our lot behind the building. Street parking is also available with 2-hour limits.

**Q: Do you offer vegetarian options?**
A: Absolutely! About 30% of our menu is vegetarian. Ask your server for recommendations or check the (V) symbols on our menu.

## Best Practices

### Answer Tone

* Friendly and helpful
* Professional but not stiff
* Conversational

### Answer Content

* Directly address the question
* Provide complete information
* Include next steps if relevant
* Add contact info for complex questions

### What Not to Do

* Don't ignore questions
* Don't be defensive
* Don't argue publicly
* Don't use Q\&A for promotions

## Handling Problematic Q\&A

### Spam Questions

* Report as spam
* Don't engage
* Google may remove

### Competitor Questions

Sometimes competitors ask loaded questions:

* Answer factually and professionally
* Don't accuse or engage negatively
* Report if clearly spam

### Inappropriate Content

Report questions or answers that:

* Contain profanity
* Are discriminatory
* Include personal attacks
* Are clearly fake

## Q\&A Notifications

### Getting Notified

* Enable notifications in GBP settings
* Check email associated with account
* Use GBP app for mobile alerts

### Response Time

Quick responses show:

* You're attentive
* You value customers
* Your business is active

## Key Takeaways

1. Monitor Q\&A section regularly
2. Pre-seed with common FAQs
3. Answer as "Owner" for credibility
4. Respond within 24 hours
5. Report spam and incorrect information

<Cards>
  <Card title="Messaging" href="/docs/local-seo-guide/optimization/messaging" />

  <Card title="Reviews" href="/docs/local-seo-guide/reviews" />
</Cards>


# Getting Reviews



Getting reviews requires a systematic approach. The key is making it easy and asking at the right time.

## Google's Review Policies

### What's Allowed

* Asking customers for reviews
* Making it easy to leave reviews
* Reminding customers to review
* Providing a direct link to your review page

### What's Not Allowed

* Offering incentives for reviews
* Paying for reviews
* Review gating (only sending happy customers to Google)
* Fake reviews from employees or friends
* Buying reviews from services

Violations can result in review removal or profile suspension.

## Your Google Review Link

### Finding Your Link

1. Search for your business on Google
2. Click "Write a review" and copy the URL
3. Or generate from GBP dashboard

### Short Link Format

Create a memorable short link:

* Use URL shortener (bit.ly, etc.)
* Or custom domain redirect (yourbusiness.com/review)

### QR Code

Generate QR code from your review link for:

* Business cards
* Receipts
* In-store signage
* Email signatures

## When to Ask for Reviews

### Optimal Timing

Ask when the customer is happiest:

* After successful service completion
* When they express satisfaction
* At the point of delivery
* Following a compliment

### Too Early

Don't ask:

* Before service is complete
* During a complaint
* When outcome is uncertain

### Follow-Up Window

If not asking in person:

* Within 24 hours of service
* Within 1 week maximum
* Longer delays = lower response rate

## How to Ask

### In-Person (Best)

After a positive interaction:

> "I'm so glad we could help! If you have a moment, we'd really appreciate a Google review. It helps other people find us."

### Email

Subject: How did we do?

> Hi \[Name],
>
> Thanks for choosing \[Business]. We hope you're happy with \[service].
>
> If you have 2 minutes, we'd love your feedback on Google. Your review helps us improve and helps others find trustworthy service.
>
> \[Leave a Review Button]
>
> Thank you!

### Text/SMS

> Hi \[Name], thanks for visiting \[Business] today! If you have a moment, we'd appreciate a quick Google review: \[link]

### In-Store Signage

Simple sign near register or exit:

> Enjoyed your experience?
> Leave us a Google review!
> \[QR Code]

## Building a Review System

### Step 1: Identify Happy Customers

* After positive service outcomes
* When they verbally express satisfaction
* Following repeat purchases

### Step 2: Make It Easy

* Provide direct link (no searching required)
* QR codes for instant access
* Email with one-click link

### Step 3: Ask Consistently

* Train all employees to ask
* Include in standard follow-up process
* Automate where possible

### Step 4: Follow Up

* Reminder email 2-3 days later if no review
* Don't over-ask (2 attempts max)

## Review Velocity

### Steady Flow vs Bursts

* Google prefers consistent review flow
* Sudden spikes may trigger spam detection
* Aim for 5-10% of customers leaving reviews

### Avoiding Red Flags

* Don't ask all customers on one day
* Spread requests over time
* Natural variation looks authentic

## Employee Training

Train your team:

* When to ask (happy customer moments)
* How to ask (comfortable, not pushy)
* What to say (simple, appreciative)
* Not to offer incentives

## Automating Review Requests

### Email Automation

Send automatic review requests:

* After appointment completion
* After purchase
* After service delivery

### SMS Automation

Higher open rates than email:

* Keep it brief
* Include direct link
* Send at appropriate time

### CRM Integration

Track:

* Who's been asked
* Who's left reviews
* Response rates

## Tracking Results

### Metrics to Watch

* Review request sent count
* Conversion rate (requests → reviews)
* Average rating of new reviews
* Review velocity over time

### Improving Conversion

If low response rate:

* Try different ask methods
* Adjust timing
* Simplify the process
* A/B test messaging

## Key Takeaways

1. Ask at the moment of happiness
2. Make it extremely easy (one click)
3. Be consistent but don't spam
4. Never offer incentives
5. Train your entire team to ask

<Cards>
  <Card title="Responding to Reviews" href="/docs/local-seo-guide/reviews/responding-to-reviews" />

  <Card title="Handling Negative Reviews" href="/docs/local-seo-guide/reviews/handling-negative-reviews" />
</Cards>


# Handling Negative Reviews



Negative reviews are inevitable. How you handle them defines your reputation. 45% of consumers say they're more likely to visit a business that responds to negative reviews.

## Don't Panic

### Perspective

* One negative review won't destroy you
* Mixed reviews can seem more authentic
* Your response matters more than the review

### The Math

* 100 reviews at 4.8 average
* One 1-star drops you to 4.76
* Impact is minimal if you have volume

## Response Framework: LEARN

### L - Listen

Read the review carefully. Understand their actual complaint.

### E - Empathize

Acknowledge their frustration, even if you disagree.

### A - Apologize

Say sorry for their experience (not for being wrong).

### R - Resolve

Offer to fix the issue. Take it offline.

### N - Next Steps

Provide clear path to resolution.

## Response Template

> \[Name], we're truly sorry to hear about your experience. \[Acknowledge specific issue]. This isn't the level of service we strive for.
>
> We'd like to make this right. Please contact \[name] at \[email/phone] so we can address this personally.
>
> Thank you for bringing this to our attention.
>
> \[Your name], \[Title]

## Timing

### Respond Quickly

* Within 24 hours maximum
* Ideally within a few hours
* Shows you take feedback seriously

### Don't Respond Emotionally

* Write response, wait 1 hour, then send
* Have someone else read it first
* Emotional responses backfire

## Taking It Offline

### Why Go Offline

* Complex issues need real conversation
* Avoids public back-and-forth
* Shows genuine care

### How to Transition

> "We'd like to discuss this further. Please email us at [service@business.com](mailto:service@business.com) or call 555-1234."

### What Happens Offline

* Call the customer
* Listen to full complaint
* Offer resolution
* Ask them to update review if resolved

## When Customers Are Wrong

Even when the customer is factually wrong:

### Don't Argue Publicly

* You won't win
* Makes you look bad
* Other readers won't know who's right

### Do This Instead

> "We're sorry for any confusion. Our records show \[brief factual correction]. We'd be happy to discuss this further at \[contact]."

## Flagging Fake or Policy-Violating Reviews

Some reviews can be removed by Google:

### Grounds for Removal

* Spam or fake content
* Off-topic content
* Illegal content
* Sexually explicit content
* Offensive language
* Impersonation
* Conflict of interest (competitor, ex-employee)

### How to Flag

1. Find the review
2. Click the flag icon
3. Select violation type
4. Submit report

### Reality Check

* Google removes relatively few reviews
* Process takes weeks
* Don't rely on removal as strategy

## Turning Negatives into Positives

### Service Recovery Paradox

Customers who have problems resolved well become MORE loyal than those who never had problems.

### After Resolution

If you fix the issue:

> "Thank you for giving us the chance to make this right. We hope you'll give us another try in the future."

### Ask for Update

If resolution is successful:

> "We're so glad we could resolve this. If you feel we've earned it, we'd be grateful if you'd consider updating your review."

## Patterns in Negative Reviews

### Look for Trends

Multiple complaints about same issue = real problem to fix.

### Categories to Watch

* Wait times
* Staff behavior
* Product quality
* Pricing concerns
* Communication issues

### Operational Improvements

Use negative feedback to improve:

* Staff training
* Process changes
* Product improvements
* Communication clarity

## When to Not Respond

Rare cases where silence may be better:

### Obvious Trolls

* Clearly fake or spam
* No connection to your business
* Inflammatory without substance

### Legal Situations

* If you're in legal dispute
* Consult lawyer before responding

## Key Takeaways

1. Respond to every negative review
2. Respond quickly (within 24 hours)
3. Use LEARN framework: Listen, Empathize, Apologize, Resolve, Next steps
4. Take complex issues offline
5. Never argue or get defensive publicly
6. Look for patterns to improve operations

<Cards>
  <Card title="Responding to Reviews" href="/docs/local-seo-guide/reviews/responding-to-reviews" />

  <Card title="Importance of Reviews" href="/docs/local-seo-guide/reviews/importance-of-reviews" />
</Cards>


# Importance of Reviews



Reviews account for approximately 21% of local ranking factors—the second largest factor after proximity.

## Reviews and Rankings

### Direct Ranking Impact

Google considers:

* **Quantity**: More reviews = stronger signal
* **Quality**: Higher ratings correlate with rankings
* **Recency**: Recent reviews matter more
* **Velocity**: Consistent flow signals active business

### Indirect Ranking Impact

Reviews also affect:

* Click-through rates (higher ratings get more clicks)
* Engagement signals (time on listing)
* Conversion rates (leads to more business)

## Reviews and Customer Behavior

### Trust Factor

* 87% of consumers read online reviews
* 73% trust a business more with positive reviews
* 94% say a bad review has convinced them to avoid a business

### Decision Making

* Reviews are the #1 factor in choosing between similar businesses
* Star ratings are visible immediately in search results
* Review snippets appear in Local Pack

### Review Quantity Expectations

What customers expect to see:

| Industry              | Minimum Reviews | Competitive |
| --------------------- | --------------- | ----------- |
| Restaurants           | 50+             | 200+        |
| Medical               | 20+             | 50+         |
| Home Services         | 15+             | 50+         |
| Professional Services | 10+             | 30+         |

## Star Rating Impact

### Rating Thresholds

* **4.0-4.5**: Considered good by most consumers
* **4.5-5.0**: Excellent, builds strong trust
* **3.5-4.0**: Acceptable but raises questions
* **Below 3.5**: Significant concern for consumers

### Star Rating in Search

Google may filter businesses with low ratings from certain searches. A 3.0 rating or below can significantly hurt visibility.

## Review Components That Matter

### Quantity

More reviews signal popularity and provide more data for Google.

### Rating

Higher average ratings improve both rankings and click-through.

### Recency

Reviews from the last 3 months carry more weight than older reviews.

### Keywords

Reviews mentioning specific services may boost relevance for those searches.

### Response Rate

Responding to reviews signals engagement and may help rankings.

### Diversity

Reviews across multiple platforms strengthen your overall presence.

## Reviews on Multiple Platforms

While Google reviews are most important for GBP, reviews on other platforms matter too:

### Primary Platforms

* Google (most important for local SEO)
* Facebook
* Yelp

### Industry-Specific

* TripAdvisor (hospitality)
* Healthgrades (medical)
* Avvo (legal)
* Houzz (home services)

### Aggregation

Google may pull ratings from third-party sites for Knowledge Panel.

## The Review-Revenue Connection

### Studies Show

* One-star increase in Yelp rating = 5-9% revenue increase
* Businesses with 200+ reviews generate 83% more revenue
* 72% won't take action until reading reviews

### Calculate Your Impact

If you get 100 monthly leads and convert 30%:

* 4.5 stars vs 3.5 stars = \~15% more conversions
* That's 4-5 extra customers per month

## Key Takeaways

1. Reviews are \~21% of ranking factors
2. Quality, quantity, and recency all matter
3. 4.0+ rating is threshold for most consumers
4. Recent reviews carry more weight
5. Reviews directly impact revenue

<Cards>
  <Card title="Getting Reviews" href="/docs/local-seo-guide/reviews/getting-reviews" />

  <Card title="Responding to Reviews" href="/docs/local-seo-guide/reviews/responding-to-reviews" />
</Cards>


# Reviews



Reviews are the second most important local ranking factor. They also heavily influence customer decisions.

## Topics

<Cards>
  <Card title="Importance of Reviews" href="/docs/local-seo-guide/reviews/importance-of-reviews" description="Why reviews matter for rankings and trust" />

  <Card title="Getting Reviews" href="/docs/local-seo-guide/reviews/getting-reviews" description="Ethical strategies to generate reviews" />

  <Card title="Responding to Reviews" href="/docs/local-seo-guide/reviews/responding-to-reviews" description="Best practices for review responses" />

  <Card title="Handling Negative Reviews" href="/docs/local-seo-guide/reviews/handling-negative-reviews" description="Turn negatives into opportunities" />
</Cards>


# Responding to Reviews



88% of consumers are more likely to use a business that responds to all reviews. Response signals that you care.

## Why Respond to Reviews

### Customer Perception

* Shows you value feedback
* Demonstrates attentiveness
* Humanizes your business

### SEO Impact

* Signals active profile
* Adds fresh content
* May influence rankings

### Reputation Management

* Mitigates negative review impact
* Showcases customer service
* Builds trust with prospects

## Respond to ALL Reviews

Not just negative ones. Responding only to complaints looks defensive.

### Positive Reviews

Thank them and reinforce the positive:

> Thank you so much for the kind words, \[Name]! We loved working with you and are thrilled you're happy with \[specific thing]. See you next time!

### Neutral Reviews

Acknowledge and seek to improve:

> Thanks for your feedback, \[Name]. We're glad you had a good experience. We'd love to earn that 5th star next time—let us know how we can improve!

### Negative Reviews

Address concerns professionally (covered in next section).

## Response Timing

### Ideal Response Time

* Within 24 hours for negative reviews
* Within 48 hours for all reviews
* Never more than a week

### Why Speed Matters

* Customer may still be upset (fixable)
* Shows responsiveness to prospects
* Prevents escalation

## Response Templates

Use templates as starting points, then personalize.

### 5-Star Response Template

> Thank you, \[Name]! We're so happy to hear \[specific positive]. Your support means the world to us. We look forward to serving you again!

### 4-Star Response Template

> Thanks for the great feedback, \[Name]! We're glad you enjoyed \[positive mentioned]. If there's anything we can do to make it a 5-star experience next time, please let us know!

### 3-Star Response Template

> Thank you for your feedback, \[Name]. We appreciate you taking the time to share your experience. We'd love to learn more about how we can improve. Please reach out to \[contact] so we can make it right.

### Negative Response Template

> \[Name], we're sorry to hear about your experience. This isn't the standard we strive for. Please contact us at \[email/phone] so we can address this personally and make it right.

## Personalization Best Practices

### Always Include

* Customer's name
* Reference to their specific experience
* Your name/role (optional but humanizing)

### Vary Your Responses

* Don't copy-paste identical responses
* Each customer deserves unique acknowledgment
* Google may flag identical responses as spam

### Keep It Brief

* 2-4 sentences is ideal
* Don't write essays
* Get to the point

## What Not to Do

### Don't Be Defensive

<IconX /> "That's not what happened"
<IconCheck /> "We're sorry that was your experience"

### Don't Make Excuses

<IconX /> "We were short-staffed that day"
<IconCheck /> "We should have done better"

### Don't Argue

<IconX /> "Actually, you're wrong because..."
<IconCheck /> "Let's discuss this offline"

### Don't Reveal Personal Information

<IconX /> "I see from your account that..."
<IconCheck /> Keep the response general

### Don't Offer Public Compensation

<IconX /> "We'll give you 50% off next time"
<IconCheck /> "Contact us to discuss a resolution"

## Tone Guidelines

### Professional but Warm

* Friendly, not corporate-speak
* Apologetic without groveling
* Confident without arrogant

### Match Their Energy (Somewhat)

* Enthusiastic response to enthusiastic review
* Measured response to measured review
* Calm response to angry review

## Review Response Workflow

### Daily Process

1. Check for new reviews (morning)
2. Categorize (positive/neutral/negative)
3. Respond to negative first
4. Respond to positive
5. Log in tracking system

### Weekly Review

* Review response metrics
* Check for patterns in feedback
* Update templates if needed

## Tracking Responses

### Metrics to Track

* Total reviews responded to
* Average response time
* Sentiment of new reviews
* Issues identified from feedback

## Key Takeaways

1. Respond to every review
2. Respond within 24-48 hours
3. Personalize each response
4. Keep responses brief and professional
5. Never argue or get defensive

<Cards>
  <Card title="Handling Negative Reviews" href="/docs/local-seo-guide/reviews/handling-negative-reviews" />

  <Card title="Getting Reviews" href="/docs/local-seo-guide/reviews/getting-reviews" />
</Cards>


# Schema Markup



Schema markup helps search engines understand your business information, potentially leading to rich results in search.

## Topics

<Cards>
  <Card title="What is Schema?" href="/docs/local-seo-guide/schema-markup/what-is-schema" description="Structured data explained" />

  <Card title="LocalBusiness Schema" href="/docs/local-seo-guide/schema-markup/local-business-schema" description="Implementation guide" />

  <Card title="Industry-Specific Schema" href="/docs/local-seo-guide/schema-markup/industry-specific-schema" description="Restaurant, Medical, Auto" />

  <Card title="Testing Schema" href="/docs/local-seo-guide/schema-markup/testing-schema" description="Validation tools" />
</Cards>


# Industry-Specific Schema



Many industries have specific schema types that provide more relevant properties than generic LocalBusiness.

## Restaurant Schema

Use `Restaurant` type for dining establishments.

```json
{
  "@context": "https://schema.org",
  "@type": "Restaurant",
  "name": "Mario's Italian Kitchen",
  "servesCuisine": "Italian",
  "priceRange": "$$",
  "menu": "https://www.marios.com/menu",
  "acceptsReservations": true,
  "address": { ... },
  "telephone": "+1-555-123-4567",
  "openingHoursSpecification": [ ... ]
}
```

### Restaurant-Specific Properties

* **servesCuisine**: Type of food served
* **menu**: URL to menu page
* **acceptsReservations**: true/false
* **hasMenu**: Structured menu data

### Menu Schema

You can include detailed menu items:

```json
"hasMenu": {
  "@type": "Menu",
  "hasMenuSection": {
    "@type": "MenuSection",
    "name": "Appetizers",
    "hasMenuItem": {
      "@type": "MenuItem",
      "name": "Bruschetta",
      "offers": {
        "@type": "Offer",
        "price": "9.99",
        "priceCurrency": "USD"
      }
    }
  }
}
```

## Medical Business Schema

Healthcare providers have specialized types.

### Physician/Doctor

```json
{
  "@context": "https://schema.org",
  "@type": "Physician",
  "name": "Dr. Jane Smith, MD",
  "medicalSpecialty": "Dermatology",
  "hospitalAffiliation": {
    "@type": "Hospital",
    "name": "City General Hospital"
  },
  "address": { ... },
  "telephone": "+1-555-123-4567"
}
```

### Dentist

```json
{
  "@context": "https://schema.org",
  "@type": "Dentist",
  "name": "Bright Smile Dental",
  "address": { ... },
  "telephone": "+1-555-123-4567"
}
```

### Medical-Specific Properties

* **medicalSpecialty**: Area of specialization
* **availableService**: Services offered
* **hospitalAffiliation**: Related hospital
* **acceptedPaymentMethod**: Insurance/payment

## Automotive Schema

### AutoRepair

```json
{
  "@context": "https://schema.org",
  "@type": "AutoRepair",
  "name": "Quick Fix Auto Service",
  "address": { ... },
  "telephone": "+1-555-123-4567",
  "openingHoursSpecification": [ ... ]
}
```

### AutoDealer

```json
{
  "@context": "https://schema.org",
  "@type": "AutoDealer",
  "name": "City Motors",
  "address": { ... },
  "telephone": "+1-555-123-4567"
}
```

## Legal Services Schema

### Attorney

```json
{
  "@context": "https://schema.org",
  "@type": "Attorney",
  "name": "Smith & Associates Law Firm",
  "address": { ... },
  "telephone": "+1-555-123-4567",
  "areaServed": {
    "@type": "State",
    "name": "Illinois"
  }
}
```

### Legal-Specific Properties

* **areaServed**: Geographic jurisdiction
* **knowsAbout**: Legal specialties

## Real Estate Schema

### RealEstateAgent

```json
{
  "@context": "https://schema.org",
  "@type": "RealEstateAgent",
  "name": "Premier Realty Group",
  "address": { ... },
  "telephone": "+1-555-123-4567",
  "areaServed": "Chicago Metro Area"
}
```

## Home Services Schema

### Plumber, Electrician, HVAC

```json
{
  "@context": "https://schema.org",
  "@type": "Plumber",
  "name": "Reliable Plumbing Co",
  "address": { ... },
  "telephone": "+1-555-123-4567",
  "areaServed": {
    "@type": "City",
    "name": "Chicago"
  }
}
```

### Available Types

* Plumber
* Electrician
* HVACBusiness
* RoofingContractor
* GeneralContractor
* Locksmith

## Professional Services Schema

### AccountingService

```json
{
  "@context": "https://schema.org",
  "@type": "AccountingService",
  "name": "Johnson CPA Firm",
  "address": { ... },
  "telephone": "+1-555-123-4567"
}
```

### Other Professional Types

* FinancialService
* InsuranceAgency
* TravelAgency
* EmploymentAgency

## Lodging Schema

### Hotel

```json
{
  "@context": "https://schema.org",
  "@type": "Hotel",
  "name": "Grand Plaza Hotel",
  "starRating": {
    "@type": "Rating",
    "ratingValue": "4"
  },
  "amenityFeature": [
    {"@type": "LocationFeatureSpecification", "name": "Pool"},
    {"@type": "LocationFeatureSpecification", "name": "Gym"}
  ],
  "address": { ... },
  "telephone": "+1-555-123-4567"
}
```

## Choosing the Right Type

### Use Specific Over Generic

* <IconCheck /> Restaurant (specific)
* <IconX /> LocalBusiness (generic)

### Check Schema.org

Visit schema.org/LocalBusiness to see all available subtypes.

### When No Specific Type Exists

Use LocalBusiness with detailed properties.

## Key Takeaways

1. Use industry-specific schema types when available
2. Specific types have relevant properties
3. Check Schema.org for available types
4. Add industry-specific properties
5. Test implementation thoroughly

<Cards>
  <Card title="Testing Schema" href="/docs/local-seo-guide/schema-markup/testing-schema" />

  <Card title="LocalBusiness Schema" href="/docs/local-seo-guide/schema-markup/local-business-schema" />
</Cards>


# LocalBusiness Schema



LocalBusiness is the core schema type for businesses with a physical location. This guide shows how to implement it properly.

## Complete LocalBusiness Example

```json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Joe's Plumbing Services",
  "image": "https://www.joesplumbing.com/images/logo.png",
  "url": "https://www.joesplumbing.com",
  "telephone": "+1-312-555-1234",
  "email": "info@joesplumbing.com",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main Street, Suite 100",
    "addressLocality": "Chicago",
    "addressRegion": "IL",
    "postalCode": "60601",
    "addressCountry": "US"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 41.8781,
    "longitude": -87.6298
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "08:00",
      "closes": "18:00"
    },
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "Saturday",
      "opens": "09:00",
      "closes": "14:00"
    }
  ],
  "priceRange": "$$",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "127"
  },
  "sameAs": [
    "https://www.facebook.com/joesplumbing",
    "https://twitter.com/joesplumbing",
    "https://www.yelp.com/biz/joes-plumbing-chicago"
  ]
}
```

## Required Properties

### @type

Must be "LocalBusiness" or a more specific subtype.

### name

Your official business name, matching GBP exactly.

### address

Complete postal address using PostalAddress type.

## Recommended Properties

### telephone

Phone number in international format: `+1-555-123-4567`

### url

Your website homepage URL.

### image

Logo or business image URL.

### geo

Latitude and longitude coordinates.

### openingHoursSpecification

Business hours in structured format.

### priceRange

Price indicator: $, $$, $$$, or $$$$

## Address Schema

```json
"address": {
  "@type": "PostalAddress",
  "streetAddress": "123 Main Street, Suite 100",
  "addressLocality": "Chicago",
  "addressRegion": "IL",
  "postalCode": "60601",
  "addressCountry": "US"
}
```

### Properties

* **streetAddress**: Street and suite/unit
* **addressLocality**: City
* **addressRegion**: State (use abbreviation)
* **postalCode**: ZIP code
* **addressCountry**: Country code

## Opening Hours Schema

```json
"openingHoursSpecification": [
  {
    "@type": "OpeningHoursSpecification",
    "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
    "opens": "08:00",
    "closes": "18:00"
  }
]
```

### Properties

* **dayOfWeek**: Day(s) these hours apply
* **opens**: Opening time (24-hour format)
* **closes**: Closing time (24-hour format)

### Closed Days

Don't include days you're closed, or explicitly set with no opens/closes.

## Social Profiles (sameAs)

Link to your social profiles:

```json
"sameAs": [
  "https://www.facebook.com/yourbusiness",
  "https://twitter.com/yourbusiness",
  "https://www.linkedin.com/company/yourbusiness",
  "https://www.instagram.com/yourbusiness"
]
```

## Reviews Schema

If displaying reviews on your site:

```json
"aggregateRating": {
  "@type": "AggregateRating",
  "ratingValue": "4.8",
  "reviewCount": "127",
  "bestRating": "5",
  "worstRating": "1"
}
```

**Note:** Only use if you have actual reviews on your website. Don't pull from Google.

## Implementation Methods

### Manual Addition

Add JSON-LD directly to your HTML:

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Your Business"
  ...
}
</script>
```

### WordPress Plugins

Popular options:

* Rank Math
* Yoast SEO
* Schema Pro

### Page Builders

Many page builders have schema modules built in.

## Multi-Location Schema

For businesses with multiple locations:

* Each location page needs its own schema
* Include specific address, phone, hours for each
* Can nest under an Organization with multiple locations

## Common Mistakes

### Mismatched Information

Schema doesn't match GBP or website = confusion.

### Missing Required Fields

Always include name and address minimum.

### Fake Reviews

Don't add aggregateRating without actual reviews on your site.

### Wrong @type

Use specific subtypes when available (Restaurant, not just LocalBusiness).

## Key Takeaways

1. Include all recommended properties
2. Match GBP information exactly
3. Use specific business types when available
4. Include geo-coordinates
5. Test after implementation

<Cards>
  <Card title="Industry-Specific Schema" href="/docs/local-seo-guide/schema-markup/industry-specific-schema" />

  <Card title="Testing Schema" href="/docs/local-seo-guide/schema-markup/testing-schema" />
</Cards>


# Testing Schema



Always test schema markup before publishing. Errors can prevent rich results and may even cause issues.

## Testing Tools

### Google Rich Results Test

**URL:** [https://search.google.com/test/rich-results](https://search.google.com/test/rich-results)

**Features:**

* Tests if page qualifies for rich results
* Shows which rich result types are detected
* Displays errors and warnings
* Mobile and desktop testing

**Best For:** Checking if Google will show rich results

### Schema.org Validator

**URL:** [https://validator.schema.org](https://validator.schema.org)

**Features:**

* Validates against Schema.org specification
* Shows all detected types
* Highlights syntax errors
* More comprehensive than Google's tool

**Best For:** Checking technical validity

### Google Search Console

**Location:** Enhancements section

**Features:**

* Shows schema performance over time
* Identifies pages with errors
* Tracks rich result impressions
* Site-wide monitoring

**Best For:** Ongoing monitoring

## How to Test

### Step 1: Use Rich Results Test

1. Go to Google's Rich Results Test
2. Enter URL or paste code
3. Run test
4. Review results

### Step 2: Check Schema.org Validator

1. Go to validator.schema.org
2. Paste your JSON-LD code
3. Run validation
4. Fix any errors

### Step 3: Verify in Search Console

After implementation:

1. Go to Search Console
2. Check Enhancements reports
3. Monitor for new errors

## Understanding Results

### Valid (No Errors)

* Schema is properly formatted
* All required properties present
* May or may not generate rich results

### Warnings

* Non-critical issues
* May affect rich result eligibility
* Should be fixed but not urgent

### Errors

* Must be fixed
* Prevent rich results
* May indicate broken code

## Common Errors

### Missing Required Properties

```
Error: Missing field "name"
```

**Fix:** Add the required property.

### Invalid Value Type

```
Error: Property "telephone" expects type "Text"
```

**Fix:** Use correct data type.

### Syntax Errors

```
Error: JSON parse error
```

**Fix:** Check for missing commas, brackets, or quotes.

### Unknown Property

```
Warning: Property "businessType" not recognized
```

**Fix:** Use correct property name from Schema.org.

## Testing Workflow

### Before Publishing

1. Paste code into validator
2. Fix all errors
3. Test URL with Rich Results Test
4. Verify on staging site
5. Publish to production

### After Publishing

1. Test live URL
2. Request indexing in Search Console
3. Monitor Enhancements report
4. Check for errors weekly

## Testing Tips

### Test the Live Page

Don't just test the code—test the actual URL where it's implemented.

### Check Mobile and Desktop

Some rich results differ between mobile and desktop.

### Test All Page Types

If you have different schema on different pages (location pages, service pages), test each template.

### Test After Updates

Re-test whenever you modify schema or page content.

## Debugging Common Issues

### Schema Not Detected

**Possible causes:**

* Code not on page
* JavaScript not rendering
* Code has syntax errors

**Debug:**

* View page source
* Check browser console
* Validate JSON syntax

### Rich Results Not Showing

**Possible causes:**

* Page not indexed
* Doesn't meet requirements
* Google chose not to display

**Debug:**

* Check indexing status
* Review guidelines
* Give it time (not instant)

### Errors After Changes

**Possible causes:**

* Introduced syntax error
* Changed required property
* CMS override

**Debug:**

* Compare before/after
* Check CMS settings
* Review recent changes

## Monitoring Over Time

### Search Console Alerts

Set up email alerts for:

* New schema errors
* Coverage issues
* Rich result changes

### Regular Audits

* Monthly: Check for new errors
* Quarterly: Full schema audit
* After updates: Re-test affected pages

## Key Takeaways

1. Always test before publishing
2. Use both Google's tool and Schema.org validator
3. Fix errors before warnings
4. Monitor ongoing via Search Console
5. Re-test after any changes

<Cards>
  <Card title="LocalBusiness Schema" href="/docs/local-seo-guide/schema-markup/local-business-schema" />

  <Card title="What is Schema?" href="/docs/local-seo-guide/schema-markup/what-is-schema" />
</Cards>


# What is Schema?



Schema markup is code you add to your website that helps search engines understand your content. For local businesses, it reinforces your NAP and business details.

## Schema Basics

### What is Structured Data?

Structured data is a standardized format for providing information about a page. It helps search engines:

* Understand page content
* Display rich results
* Connect related information

### What is Schema.org?

Schema.org is a collaborative vocabulary for structured data. It's supported by:

* Google
* Bing
* Yahoo
* Yandex

### How It Works

You add code to your website that explicitly tells search engines:

* What type of entity this is (business, product, event)
* Properties of that entity (name, address, hours)
* Relationships between entities

## Benefits of Schema Markup

### Rich Results

Schema can enable enhanced search features:

* Star ratings in search results
* Business hours
* Price ranges
* Event dates

### Improved Understanding

Search engines better understand:

* What your business does
* Where you're located
* When you're open
* How to contact you

### Voice Search

Schema helps voice assistants answer queries:

* "What time does \[business] close?"
* "What's the phone number for \[business]?"

### Competitive Edge

Only \~12% of websites use schema markup. Implementation gives you an advantage.

## Schema Formats

### JSON-LD (Recommended)

JavaScript notation added to page `<head>` or `<body>`:

* Preferred by Google
* Easier to implement
* Doesn't mix with HTML
* Easier to maintain

### Microdata

Inline HTML attributes:

* Older format
* Mixed with HTML
* More complex
* Still supported

### RDFa

HTML5 extension:

* Complex implementation
* Less common
* Still supported

**Recommendation:** Use JSON-LD for all new implementations.

## Schema for Local SEO

### LocalBusiness Type

The core schema type for local businesses includes:

* Business name
* Address
* Phone number
* Hours
* Geo-coordinates
* Reviews

### Supporting GBP

Schema should match your GBP exactly:

* Same business name
* Same address format
* Same phone number
* Same hours

### Not a Ranking Factor (Directly)

Google has stated schema isn't a direct ranking factor. However, it:

* Improves click-through rates
* Enables rich results
* Supports voice search
* Helps search engines understand your site

## Basic JSON-LD Structure

```json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Business Name",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main Street",
    "addressLocality": "City",
    "addressRegion": "State",
    "postalCode": "12345",
    "addressCountry": "US"
  },
  "telephone": "+1-555-123-4567"
}
```

## Where to Add Schema

### Homepage

Essential LocalBusiness schema.

### Contact Page

Reinforce NAP with schema.

### Location Pages

For multi-location businesses, each page gets its own schema.

### Service Pages

Add Service schema where relevant.

## Key Takeaways

1. Schema helps search engines understand your content
2. Use JSON-LD format (Google's preference)
3. LocalBusiness is the core type for local SEO
4. Schema should match your GBP exactly
5. Test your implementation before publishing

<Cards>
  <Card title="LocalBusiness Schema" href="/docs/local-seo-guide/schema-markup/local-business-schema" />

  <Card title="Testing Schema" href="/docs/local-seo-guide/schema-markup/testing-schema" />
</Cards>


# Common GBP Errors



Encountering errors in Google Business Profile is common. Here are the most frequent issues and how to fix them.

## Profile Information Errors

### "Your edits can't be saved"

**Causes:**

* Session timeout
* Server issues
* Invalid data entered

**Solutions:**

1. Refresh the page
2. Sign out and back in
3. Try a different browser
4. Wait and try again later
5. Check data for special characters

### "This phone number is already in use"

**Causes:**

* Phone already linked to another listing
* Duplicate listing exists
* Previous business used this number

**Solutions:**

1. Search for existing listings with that number
2. Claim or remove conflicting listing
3. Use different phone number
4. Contact support for resolution

### "This address is already in use"

**Causes:**

* Another business at same address
* Duplicate listing
* Previous tenant's listing still active

**Solutions:**

1. Search for existing listings at address
2. If legitimate multi-tenant, proceed with verification
3. Remove duplicate listings
4. Contact support if stuck

### Business Name Rejected

**Causes:**

* Keywords in name
* Location in name (when not on signage)
* Excessive punctuation
* Promotional language

**Solutions:**

1. Use only legal business name
2. Remove keywords and locations
3. Match your storefront signage exactly
4. Review naming guidelines

## Category Errors

### "Category not available"

**Causes:**

* Category was removed by Google
* Region-specific category
* Category merged with another

**Solutions:**

1. Search for similar categories
2. Use parent category
3. Check if category renamed
4. Wait for Google to update

### Category Changed Unexpectedly

**Causes:**

* Google's automated systems
* User suggestions accepted
* Category consolidation

**Solutions:**

1. Change back to correct category
2. Monitor for future changes
3. Report if keeps changing
4. Ensure category matches business

## Hours Errors

### Hours Not Displaying

**Causes:**

* Hours not set
* Conflicting information
* Technical glitch

**Solutions:**

1. Re-enter hours in GBP
2. Verify hours are saved
3. Check for special hours conflicts
4. Wait 24-48 hours for propagation

### "Open 24 hours" Showing Incorrectly

**Causes:**

* Open/close times set incorrectly
* Next-day hours confusion

**Solutions:**

1. Set specific open and close times
2. For overnight hours (bar closing at 2am):
   * Use "Opens Thursday 5pm, Closes Friday 2am"
3. Don't use 24-hour format if not truly 24/7

### Holiday Hours Not Showing

**Causes:**

* Set too early/late
* Conflicting with regular hours
* Technical delay

**Solutions:**

1. Add special hours at least 3 days early
2. Check format is correct
3. Verify they saved properly
4. Clear cache and re-check

## Photo Errors

### "Photo can't be uploaded"

**Causes:**

* File too large (max 5MB)
* Wrong format (need JPG, PNG)
* Resolution too low (under 720px)
* Copyright or content issues

**Solutions:**

1. Resize image (2000x2000 max)
2. Convert to JPG or PNG
3. Ensure minimum 720px width
4. Check for content policy violations

### Photos Not Appearing

**Causes:**

* Processing time (up to 24 hours)
* Content review pending
* Photo rejected
* Cache issues

**Solutions:**

1. Wait 24-48 hours
2. Check for rejection notice
3. Try uploading again
4. Clear browser cache

### Photos Removed Without Notice

**Causes:**

* User-reported issue
* Policy violation detected
* Automated removal
* Quality issues

**Solutions:**

1. Review photo guidelines
2. Re-upload if compliant
3. Don't include text overlays
4. Avoid stock photos

## Review Errors

### Can't Respond to Reviews

**Causes:**

* Not listing owner/manager
* Technical glitch
* Account issues

**Solutions:**

1. Verify you have edit access
2. Try different browser
3. Sign out and back in
4. Check for account suspension

### Review Response Not Posting

**Causes:**

* Content flagged
* Links in response
* Response too long
* Technical issues

**Solutions:**

1. Remove any links
2. Shorten response
3. Remove potentially flagged words
4. Wait and try again

### Reviews Disappeared

**Causes:**

* Google filtered as spam
* Policy violation detected
* Account issues (reviewer)
* Temporary glitch

**Solutions:**

1. Wait—sometimes reviews return
2. Check if review violated policies
3. Don't contact Google about filtered reviews
4. Focus on getting new legitimate reviews

## Post Errors

### "Post can't be published"

**Causes:**

* Content policy violation
* Link issues
* Image problems
* Technical glitch

**Solutions:**

1. Check for prohibited content
2. Verify link works
3. Try different image
4. Simplify post text

### Posts Not Showing

**Causes:**

* Still processing
* Rejected during review
* Display lag
* Category restrictions

**Solutions:**

1. Wait 30 minutes
2. Check for rejection notice
3. Try posting again
4. Simplify content

## Verification Errors

### "Verification code invalid"

**Causes:**

* Wrong code entered
* Code expired (30 days)
* Multiple postcards sent
* Address changed after request

**Solutions:**

1. Double-check code
2. Request new code if expired
3. Use most recent postcard
4. Don't change address while waiting

### "Verification not available"

**Causes:**

* Business type restrictions
* Previous verification issues
* Address concerns

**Solutions:**

1. Try again later
2. Contact support
3. Provide documentation
4. Try alternate method if available

## Dashboard Errors

### "Something went wrong"

**Solutions:**

1. Refresh page
2. Clear browser cache
3. Try incognito mode
4. Wait and retry later

### Changes Not Saving

**Solutions:**

1. Check internet connection
2. Try different browser
3. Disable browser extensions
4. Contact support if persistent

### Missing Features in Dashboard

**Causes:**

* Feature not available in your region
* Business category restrictions
* Account not fully verified
* Rolling feature updates

**Solutions:**

1. Verify listing is complete
2. Check verification status
3. Wait for feature rollout
4. Try different browser/device

## API Errors

### Rate Limiting

If using Google Business Profile API:

* Respect quota limits
* Implement exponential backoff
* Cache responses where possible
* Monitor usage

### Authentication Errors

* Verify OAuth tokens are fresh
* Check API permissions
* Ensure correct scopes
* Refresh tokens as needed

## When to Contact Support

### Contact Google When:

* Error persists after trying solutions
* No clear cause identified
* Data loss or corruption
* Verification completely blocked
* Suspension without clear reason

### Provide:

* Screenshots of error
* Steps you've tried
* Business details
* Timeline of issue

## Key Takeaways

1. Most errors have simple solutions
2. Wait before assuming permanent issue
3. Try clearing cache and different browsers
4. Document errors with screenshots
5. Contact support for persistent issues

<Cards>
  <Card title="Duplicate Listings" href="/docs/local-seo-guide/troubleshooting/duplicate-listings" />

  <Card title="Ranking Drops" href="/docs/local-seo-guide/troubleshooting/ranking-drops" />
</Cards>


# Duplicate Listings



Duplicate listings confuse customers, dilute reviews, and can hurt rankings. Here's how to identify and eliminate them.

## Why Duplicates Exist

### Common Causes

* Business moved locations
* Name or address changes
* Multiple people created listings
* Google auto-generated a listing
* Mergers or acquisitions
* Franchisee/franchisor confusion

### Problems They Cause

* Reviews split between listings
* Customers get wrong information
* Rankings negatively affected
* Google may trust neither listing
* Confusion in search results

## Finding Duplicates

### Google Search

Search for your business:

* "Business Name" + city
* Address only
* Phone number
* Variations of your name

### Google Maps

* Search your business name
* Search your address
* Look at nearby businesses
* Check for similar names

### Google Business Profile Dashboard

* Look for "Duplicate" notices
* Check suggested matches
* Review "Your business on Google"

### Third-Party Tools

Use SEO tools that scan for:

* NAP variations
* Multiple listings at same address
* Similar business names
* Phone number duplicates

## Types of Duplicates

### Exact Duplicates

Same business, same address, same name

* Easiest to identify
* Clear case for removal

### Soft Duplicates

Same business, slightly different info:

* Different phone numbers
* Slight name variation
* Old address

### Legitimate Similar Listings

Not duplicates:

* Different businesses at same address (mall, office building)
* Parent company and subsidiary
* Different departments with separate entries

## Removal Process

### For Listings You Own

**If you can access the duplicate:**

1. Sign into Google Business Profile
2. Select the duplicate listing
3. Go to Settings (or Info)
4. Look for "Mark as permanently closed" or "Remove listing"
5. Select "Duplicate of another listing"
6. Identify the correct listing
7. Submit removal request

### For Listings You Don't Own

**Option 1: Suggest an Edit**

1. Find the duplicate on Google Maps
2. Click "Suggest an edit"
3. Select "Close or remove"
4. Choose "Duplicate of another place"
5. Provide the correct listing info

**Option 2: Report to Google**

1. Go to Google Business Profile Help
2. Report the duplicate
3. Provide evidence (screenshots, documentation)
4. Wait for Google review

**Option 3: Google Business Profile Support**

1. Contact GBP support
2. Explain the duplicate situation
3. Provide both listing URLs
4. Request merger or removal

## Merging Listings

### When to Merge

* Both listings have reviews
* Both have been verified
* Want to preserve review history

### How to Request Merge

1. Contact Google Business Profile support
2. Provide both listing URLs
3. Explain which is the primary listing
4. Request reviews be merged
5. Note: Google doesn't always approve merges

### What Gets Merged

* Reviews (usually)
* Photos (sometimes)
* Q\&A (varies)
* Insights history (typically not)

## Prevention Strategies

### Claim Your Listing First

* Search for existing listings before creating
* Claim and verify immediately
* Don't create duplicates when claiming fails

### Consistent Information

* Use exact same name everywhere
* Same address format
* Same phone number
* Reduces auto-generation of duplicates

### Monitor Regularly

* Monthly checks for duplicates
* Set up Google Alerts for business name
* Watch for customer reports

### Document Ownership

* Keep verification records
* Screenshot your dashboard
* Maintain business documentation

## Special Situations

### After a Move

1. Update existing listing (don't create new)
2. Check for old listing at previous address
3. Mark old location as moved if separate listing exists
4. Update all citations with new address

### After Rebranding

1. Update existing listing name
2. Check for listings under old name
3. Remove old name listings
4. Update all citations

### Multi-Location Businesses

* Clear naming convention
* Unique phone per location
* Prevent franchisees from creating duplicates
* Central management of listings

## Troubleshooting Removal Issues

### Google Won't Remove Duplicate

**Possible reasons:**

* Google doesn't see it as duplicate
* Other business is legitimate
* Insufficient evidence

**Solutions:**

* Provide more documentation
* Try different reporting method
* Contact support directly
* Be patient (can take weeks)

### Duplicate Keeps Reappearing

**Possible causes:**

* Data aggregators recreating it
* Outdated citations
* Google's auto-generation

**Solutions:**

* Clean up all citations
* Update data aggregators
* Monitor and report again
* Keep documentation of removals

## Key Takeaways

1. Regularly search for duplicate listings
2. Document and report duplicates promptly
3. Use proper channels for removal
4. Prevent duplicates with consistent NAP
5. Consider merging if reviews are at stake

<Cards>
  <Card title="Ranking Drops" href="/docs/local-seo-guide/troubleshooting/ranking-drops" />

  <Card title="NAP Consistency" href="/docs/local-seo-guide/nap-and-citations/nap-consistency" />
</Cards>


# Troubleshooting



Even well-optimized listings encounter issues. Learn how to diagnose and fix common problems.

## Topics

<Cards>
  <Card title="Duplicate Listings" href="/docs/local-seo-guide/troubleshooting/duplicate-listings" description="Find and remove duplicates" />

  <Card title="Ranking Drops" href="/docs/local-seo-guide/troubleshooting/ranking-drops" description="Diagnose visibility issues" />

  <Card title="Suspension Recovery" href="/docs/local-seo-guide/troubleshooting/suspension-recovery" description="Getting reinstated" />

  <Card title="Verification Issues" href="/docs/local-seo-guide/troubleshooting/verification-issues" description="Solving verification problems" />

  <Card title="Common GBP Errors" href="/docs/local-seo-guide/troubleshooting/common-gbp-errors" description="Fixing typical issues" />
</Cards>


# Ranking Drops



Ranking drops can happen suddenly or gradually. Understanding why helps you recover faster.

## Types of Ranking Drops

### Sudden Drop

* Overnight ranking loss
* Usually algorithm or penalty related
* Often affects specific rankings

### Gradual Decline

* Slow erosion over weeks/months
* Often competition-related
* Harder to pinpoint cause

### Partial Drop

* Lost rankings for some keywords
* Others remain stable
* May indicate targeted issue

## Diagnosis Process

### Step 1: Verify the Drop

**Confirm it's real:**

* Check from different devices
* Use incognito/private browsing
* Check from different locations
* Use rank tracking tools

**Rule out:**

* Personalized results
* Location-based variations
* Temporary fluctuations
* Tool inaccuracies

### Step 2: Check Timeline

**Correlate with events:**

* Algorithm updates
* Changes you made
* Competitor actions
* Industry events

### Step 3: Identify Scope

**Determine what's affected:**

* All keywords or specific ones?
* Local pack only or organic too?
* Desktop and mobile?
* One location or all?

## Common Causes and Solutions

### Google Algorithm Updates

**Symptoms:**

* Drop coincides with announced update
* Many businesses affected
* Industry-wide discussions

**Solutions:**

* Research the specific update
* Identify what it targets
* Adjust strategy accordingly
* Wait for dust to settle

### Guideline Violations

**Symptoms:**

* Sudden, severe drop
* Possible suspension notice
* Specific violation warnings

**Solutions:**

* Review Google's guidelines
* Fix any violations immediately
* Request reinstatement if needed
* Ensure full compliance

### Competitor Improvements

**Symptoms:**

* Gradual decline
* Competitors ranking higher
* Your metrics unchanged

**Solutions:**

* Analyze competitor changes
* Improve your optimization
* Focus on differentiators
* Build more reviews/citations

### Negative SEO or Spam

**Symptoms:**

* Unusual backlink patterns
* Spam reviews appearing
* Citation inconsistencies

**Solutions:**

* Audit your backlinks
* Disavow toxic links
* Report spam reviews
* Clean up citations

### Website Technical Issues

**Symptoms:**

* Site speed problems
* Mobile issues
* Crawl errors
* SSL problems

**Solutions:**

* Run technical SEO audit
* Fix site speed issues
* Ensure mobile-friendliness
* Resolve crawl errors

### GBP Changes or Issues

**Symptoms:**

* Information changed unexpectedly
* Listing edits by Google
* Category changes

**Solutions:**

* Audit your GBP listing
* Correct any wrong information
* Re-verify accuracy
* Check for suggested edits

## Investigation Checklist

### GBP Audit

* [ ] Verify business information is correct
* [ ] Check for Google-suggested edits
* [ ] Review category accuracy
* [ ] Confirm verification status
* [ ] Check for duplicate listings
* [ ] Review recent changes

### Website Audit

* [ ] Check for technical errors
* [ ] Verify mobile-friendliness
* [ ] Test page speed
* [ ] Review on-page SEO
* [ ] Check for manual actions in Search Console

### Citation Audit

* [ ] Verify NAP consistency
* [ ] Check major directories
* [ ] Look for conflicting information
* [ ] Review recent citation changes

### Review Audit

* [ ] Check for spam reviews
* [ ] Review recent negative reviews
* [ ] Assess overall sentiment
* [ ] Compare to competitors

### Competition Analysis

* [ ] Track competitor rankings
* [ ] Analyze their recent changes
* [ ] Compare optimization levels
* [ ] Identify their improvements

## Recovery Strategies

### Immediate Actions

1. Fix any obvious issues
2. Correct GBP information
3. Address technical problems
4. Remove guideline violations

### Short-Term Actions

1. Increase optimization efforts
2. Request more reviews
3. Clean up citations
4. Improve content quality

### Long-Term Actions

1. Build sustainable advantages
2. Focus on customer experience
3. Develop unique differentiators
4. Monitor consistently

## When to Wait vs. Act

### Wait When:

* Drop is minor (1-2 positions)
* Algorithm update just happened
* No clear cause identified
* Fluctuation is normal pattern

### Act When:

* Drop is significant (page 2+)
* Clear cause is identified
* Violation exists
* Issue is fixable

## Preventing Future Drops

### Regular Monitoring

* Track rankings weekly
* Monitor GBP insights
* Watch for changes
* Set up alerts

### Proactive Optimization

* Stay current with best practices
* Continuously improve listing
* Build review momentum
* Maintain citation accuracy

### Diversified Strategy

* Don't rely on one factor
* Build comprehensive presence
* Multiple traffic sources
* Strong website AND GBP

## Key Takeaways

1. Verify drops are real before reacting
2. Identify the specific cause
3. Fix violations and issues immediately
4. Be patient with algorithm fluctuations
5. Build sustainable, diversified presence

<Cards>
  <Card title="Suspension Recovery" href="/docs/local-seo-guide/troubleshooting/suspension-recovery" />

  <Card title="Common GBP Errors" href="/docs/local-seo-guide/troubleshooting/common-gbp-errors" />
</Cards>


# Suspension Recovery



A suspended GBP listing disappears from search. Understanding why suspensions happen and how to recover is critical.

## Types of Suspensions

### Soft Suspension

* Listing still visible in dashboard
* Not showing in search/maps
* "Suspended" status shown
* Can appeal directly

### Hard Suspension

* Listing may be removed entirely
* Multiple violations or repeat offense
* Requires more extensive appeal
* Longer recovery process

### Account-Level Suspension

* All listings under account affected
* Severe policy violation
* May lose access entirely
* Most difficult to recover

## Common Causes

### Business Name Violations

* Keywords stuffed in name
* Location added to name (when not part of legal name)
* Taglines or descriptors added
* Name doesn't match real-world signage

**Examples:**

* <IconX /> "Best Pizza Chicago - Fast Delivery"
* <IconCheck /> "Mario's Pizzeria"

### Address Issues

* Virtual office without staff
* P.O. Box (not allowed for most businesses)
* Residential address for ineligible business
* Address doesn't exist or is unverifiable

### Category Misuse

* Irrelevant categories selected
* Lead generation categories misused
* Multiple listings for one location
* Category spam

### Review Policy Violations

* Fake reviews purchased
* Review gating (only asking happy customers)
* Offering incentives for reviews
* Employee reviews without disclosure

### Other Violations

* Multiple listings for same business
* Listing for ineligible business type
* Impersonating another business
* Promoting illegal products/services

## Prevention

### Know the Guidelines

Read and understand:

* Google Business Profile guidelines
* Prohibited content policies
* Category-specific requirements
* Review policies

### Maintain Compliance

* Use legal business name only
* Legitimate physical address
* Accurate categories
* Honest practices

### Regular Audits

* Check for guideline changes
* Review your listing regularly
* Monitor for unauthorized changes
* Stay informed on policy updates

## Recovery Process

### Step 1: Identify the Cause

**Check for:**

* Email from Google explaining violation
* Dashboard messages or alerts
* Recent changes that might trigger suspension
* Compare against guidelines

### Step 2: Fix the Issue

**Before appealing:**

* Correct any violations
* Update business name if needed
* Verify address accuracy
* Remove policy-violating content

### Step 3: Gather Documentation

**Prepare:**

* Business license
* Utility bills showing address
* Signage photos
* Other proof of legitimacy

### Step 4: Submit Reinstatement Request

**Through GBP Dashboard:**

1. Sign into Google Business Profile
2. Select suspended listing
3. Click "Learn more" on suspension notice
4. Follow reinstatement process
5. Submit required documentation

**Through Support:**

1. Contact GBP support
2. Explain situation
3. Provide documentation
4. Request review

### Step 5: Wait and Follow Up

* Initial review: 3-5 business days
* Complex cases: 1-2 weeks
* Follow up if no response
* Be patient but persistent

## Appeal Best Practices

### Be Honest

* Acknowledge mistakes if made
* Don't try to deceive Google
* Explain corrective actions taken
* Show commitment to compliance

### Be Thorough

* Provide all requested documentation
* Include clear photos
* Answer all questions completely
* More evidence is better

### Be Professional

* Calm, factual communication
* No accusations or anger
* Focus on resolution
* Thank reviewers for their time

### Be Patient

* Process takes time
* Multiple appeals may be needed
* Don't spam requests
* Follow proper channels

## Documentation Guide

### Essential Documents

* Business registration/license
* Tax documents with address
* Lease or mortgage showing address
* Utility bills in business name

### Photo Evidence

* Exterior signage with business name
* Interior of business
* Business cards and marketing materials
* Street view context

### Additional Support

* Customer testimonials
* Media coverage
* Professional association membership
* Industry certifications

## After Reinstatement

### Immediate Actions

* Verify all information is correct
* Don't make sudden changes
* Monitor for issues
* Document the reinstatement

### Ongoing Compliance

* Regular guideline reviews
* Careful about any changes
* Monitor for unauthorized edits
* Stay conservative with optimization

### Prevent Recurrence

* Understand what caused suspension
* Implement prevention measures
* Train team on compliance
* Set up monitoring

## Special Situations

### New Business Suspension

Sometimes new listings are suspended for verification:

* Provide clear documentation
* Photos of physical location
* Business registration
* Usually resolved quickly with proper docs

### Competitor-Reported Suspension

If reported by competitor:

* Focus on proving legitimacy
* Document compliance
* Don't engage with competitor
* Let documentation speak

### Multiple Listing Suspension

If suspended for duplicates:

* Identify which listing should remain
* Remove/consolidate duplicates
* Provide documentation for primary listing
* Explain the situation clearly

## When Recovery Fails

### Consider

* Was the violation legitimate?
* Is the business model compliant?
* Are there alternative approaches?

### Options

* Create new listing (only if legitimately compliant)
* Focus on other marketing channels
* Address underlying business issues
* Seek professional help

## Key Takeaways

1. Prevention is easier than recovery
2. Fix violations before appealing
3. Document everything thoroughly
4. Be patient and professional
5. Learn from the experience

<Cards>
  <Card title="Verification Issues" href="/docs/local-seo-guide/troubleshooting/verification-issues" />

  <Card title="Common GBP Errors" href="/docs/local-seo-guide/troubleshooting/common-gbp-errors" />
</Cards>


# Verification Issues



Verification proves you own or represent the business. Problems with verification can delay your listing going live.

## Understanding Verification

### Why Verification Matters

* Proves business legitimacy
* Enables all GBP features
* Required to appear in search
* Protects against fraud

### Verification Methods

* **Postcard**: Most common, mailed to address
* **Phone**: Automated call with code
* **Email**: For eligible businesses
* **Video**: Record/live video verification
* **Instant**: For some established businesses

## Common Problems

### Postcard Never Arrived

**Possible causes:**

* Wrong address entered
* Mail delivery issues
* Postcard lost or discarded
* Incorrect postal code

**Solutions:**

1. Verify address is exactly correct
2. Check with mail handlers
3. Look in spam/junk areas
4. Request new postcard
5. Wait full 14 days before re-requesting

**Prevention:**

* Double-check address before requesting
* Inform mail handlers to watch for Google mail
* Consider mail forwarding if applicable

### Postcard Code Expired

**Issue:** Codes expire after 30 days

**Solution:**

1. Request a new postcard
2. Don't change address while waiting
3. Enter code as soon as received

### Code Doesn't Work

**Possible causes:**

* Typo when entering code
* Code from old postcard
* Multiple postcards requested
* Address changed after request

**Solutions:**

1. Double-check code entry
2. Use most recent postcard
3. Request fresh postcard
4. Contact support if persistent

### Phone Verification Not Available

**Possible causes:**

* Business type not eligible
* Phone number issues
* Google's verification options

**Solutions:**

1. Try again later
2. Ensure phone number is correct
3. Use landline if possible
4. Fall back to postcard method

### Video Verification Issues

**Requirements:**

* Clear video of exterior/signage
* Interior showing business operation
* Business documents visible
* Location must be identifiable

**Common failures:**

* Video too short or unclear
* Signage not visible
* Can't verify location
* Documents not legible

**Solutions:**

1. Follow instructions exactly
2. Good lighting and steady camera
3. Show all required elements
4. Re-record if rejected

## Service Area Business Verification

### Challenges

* No physical storefront
* Address may be residential
* Limited verification options

### Solutions

1. Use your home/office address (can be hidden)
2. Provide additional documentation
3. Be patient with process
4. Contact support if needed

### Documentation Needed

* Business license
* Service vehicle photos
* Equipment or supplies
* Customer contracts/invoices

## Multi-Location Verification

### Bulk Verification

For 10+ locations:

* Request bulk verification
* Provide spreadsheet of locations
* Google reviews and verifies
* Faster than individual verification

### Requirements

* Legitimate multi-location business
* All locations under one account
* Consistent business information
* May require additional documentation

### Process

1. Add all locations to account
2. Request bulk verification
3. Provide required documentation
4. Wait for Google review
5. All locations verified together

## Troubleshooting Specific Methods

### Postcard Verification

**Best Practices:**

* Use exact legal address
* Include suite/unit if applicable
* Correct postal code
* Inform mail recipients

**If multiple requests fail:**

1. Try different verification method
2. Contact Google support
3. Verify address is serviceable
4. Check for address issues with postal service

### Phone Verification

**Requirements:**

* Must be business phone (not personal)
* Answer within a few rings
* Automated system reads code
* Write down code immediately

**Troubleshooting:**

* Ensure phone is connected
* Disable voicemail temporarily
* Don't have calls forwarded
* Be ready to answer

### Email Verification

**Requirements:**

* Business domain email
* Not Gmail/Yahoo/etc.
* Domain matches website
* Active email address

**Troubleshooting:**

* Check spam folder
* Ensure email is correct
* Try different email at same domain
* Wait and retry

### Video Verification

**Live Video:**

* Google representative joins video call
* Show exterior, signage, interior
* Provide documentation
* Answer questions

**Recorded Video:**

* Upload recorded walkthrough
* Must meet all requirements
* Clear and stable footage
* All elements visible

## When Verification Keeps Failing

### Contact Support

1. Go to GBP help
2. Select verification issues
3. Describe your situation
4. Provide documentation
5. Request manual review

### Documentation to Provide

* Business registration
* Utility bills at address
* Lease agreement
* Photos of location
* Previous correspondence

### Escalation Path

1. Self-service options first
2. GBP support contact
3. Request escalation
4. Social media (last resort)

## After Verification

### Immediate Steps

1. Complete your profile
2. Add photos
3. Set accurate hours
4. Request reviews

### Maintain Verification

* Don't change address unnecessarily
* Keep phone number active
* Respond to any Google notices
* Monitor for issues

## Key Takeaways

1. Double-check all information before requesting verification
2. Be patient—some methods take time
3. Have documentation ready
4. Contact support if problems persist
5. Don't make changes while waiting for verification

<Cards>
  <Card title="Suspension Recovery" href="/docs/local-seo-guide/troubleshooting/suspension-recovery" />

  <Card title="Common GBP Errors" href="/docs/local-seo-guide/troubleshooting/common-gbp-errors" />
</Cards>