> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Optimize Your Site for SEO

> Improve search engine rankings with Hiveku's built-in SEO tools

Hiveku ships with everything you need to rank: an AI that can audit and fix your site, a dashboard that tracks your performance in Google, and per-page controls for titles, descriptions, and structured data.

<CardGroup cols={3}>
  <Card title="Easiest" icon="wand-magic-sparkles">
    Ask the AI to audit and fix
  </Card>

  <Card title="Data-driven" icon="chart-line">
    SEO Dashboard with Google data
  </Card>

  <Card title="Hands-on" icon="code">
    Edit meta tags directly
  </Card>
</CardGroup>

## Turn On SEO Enhancements

Before you do anything else, enable the SEO integration so pages get Open Graph, Twitter Card, and JSON-LD markup automatically.

<Steps>
  <Step title="Enable the integration">
    Go to **Hosting > Integrations** and toggle **SEO Enhancements** on.
  </Step>

  <Step title="Deploy">
    The markup is injected at build time. Click **Deploy** once enabled.
  </Step>
</Steps>

<Tabs>
  <Tab title="AI Chat">
    ## Option 1: Ask the AI

    The fastest way to improve SEO is to let the AI audit and fix your site.

    <Steps>
      <Step title="Open the AI chat">
        Click the **AI** tab in your project.
      </Step>

      <Step title="Ask for an audit">
        Try prompts like:

        ```
        Audit my site for SEO issues and fix the top five.
        ```

        ```
        Generate unique meta titles and descriptions for every page.
        ```

        ```
        Write an SEO report with recommendations I can act on.
        ```
      </Step>

      <Step title="Review and deploy">
        The AI proposes changes, you approve them, and deploy.
      </Step>
    </Steps>

    <Tip>
      Ask for a *comprehensive AI search report* for a deeper audit including Core Web Vitals, internal linking, and content gaps.
    </Tip>
  </Tab>

  <Tab title="SEO Dashboard">
    ## Option 2: SEO Dashboard

    Go to **Marketing > SEO** for the data-driven view. This requires Google Search Console connected.

    <Steps>
      <Step title="Connect Google Search Console">
        Follow [/how-tos/connect-gsc](/how-tos/connect-gsc) to link your GSC property. Once connected, impressions, clicks, CTR, and position data flow into the dashboard.
      </Step>

      <Step title="Run a site audit">
        Click **Run Audit**. The audit checks:

        * Title tags (length, uniqueness)
        * Meta descriptions (length, presence)
        * Heading hierarchy (one H1 per page)
        * Alt text on images
        * Internal linking
        * Canonical tags, robots, sitemap

        Each issue comes with a one-click fix or a prompt you can send to the AI.
      </Step>

      <Step title="Research keywords">
        Go to **Marketing > SEO > Keyword Research**. Enter a seed term and get search volume, difficulty, and related keywords to target.
      </Step>

      <Step title="Track rankings">
        Add keywords you care about. Hiveku tracks your position in Google daily and charts it over time.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual">
    ## Option 3: Edit Meta Tags Directly

    For pinpoint control, edit each page's title and description.

    <Steps>
      <Step title="Open Content > Pages">
        In your project sidebar, click **Content**, then the **Pages** tab.
      </Step>

      <Step title="Edit a page">
        Click a page and update:

        * **Title** — appears in Google results and browser tab (50-60 chars)
        * **Meta description** — appears under the title in Google (150-160 chars)
        * **Featured image** — used for Open Graph and Twitter Card previews
      </Step>

      <Step title="Or edit frontmatter in code">
        For MDX pages:

        ```mdx theme={null}
        ---
        title: "Your Page Title"
        description: "A short, compelling description."
        ogImage: "/og-image.png"
        ---
        ```
      </Step>

      <Step title="Deploy">
        Click **Deploy**. New meta tags go live with the next build.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## SEO Best Practices

* **One H1 per page** — the primary topic, matched to what users search for
* **Descriptive alt text** on every image — helps both accessibility and image search
* **Internal links** — connect related pages so Google can crawl them
* **Fast load times** — compress images, enable caching, use Hiveku's CDN
* **Mobile-friendly layout** — more than half of search is mobile
* **Unique titles and descriptions** per page — no duplication across the site
* **Schema markup** — automatic when SEO Enhancements is on

## Verifying It Works

Once your pages are deployed and the sitemap is submitted, Google Search Console should show impressions within a few days. Brand-new sites can take 2-4 weeks to start ranking competitively.

## Troubleshooting

<AccordionGroup>
  <Accordion title="My site isn't indexed">
    Submit your sitemap in Google Search Console (**Sitemaps > Add sitemap**). Your sitemap is at `https://yoursite.com/sitemap.xml` by default. Also check that `robots.txt` doesn't disallow crawling.
  </Accordion>

  <Accordion title="Rankings are low for a new site">
    SEO is slow. Brand-new domains need weeks to months to build authority. Focus on publishing quality content consistently and earning a few backlinks — rankings will follow.
  </Accordion>

  <Accordion title="Google can't see my content">
    If your content renders client-side with JavaScript, Googlebot may not pick it up reliably. Switch to server-rendered (SSR) or static (SSG) output for indexable pages — ask the AI to convert: *"Make my landing page statically rendered for SEO"*.
  </Accordion>

  <Accordion title="Duplicate title/description warnings">
    Run the site audit (Marketing > SEO) or ask the AI: *"Find pages with duplicate titles or descriptions and make them unique"*.
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Connect GSC" icon="link" href="/how-tos/connect-gsc">
    Wire up Google Search Console for ranking data
  </Card>

  <Card title="Analytics" icon="chart-bar" href="/how-tos/track-analytics">
    See how SEO traffic behaves once it lands
  </Card>
</CardGroup>