SEO Settings

Search Engine Optimization (SEO) settings help your pages rank better in search results and appear correctly when shared on social media. This guide covers page-level and site-level SEO configuration.

Every page has basic SEO metadata:

• Title: Appears in search results and browser tabs (set in page settings)
• Description: Appears in search result snippets (set in page settings)
• Slug: The URL path for the page

To configure advanced SEO settings for a page:

1. Navigate to the page editor
2. Click Settings → SEO
3. Configure the SEO options
4. Click Save

Open Graph tags control how your page appears when shared on social media (Facebook, LinkedIn, etc.).

• website: General web pages
• article: News articles, blog posts
• blog: Blog-specific content

• Image size: Use images at least 1200×630 pixels
• Image format: Use JPG or PNG
• Image content: Ensure images are relevant and high-quality
• Test shares: Use Facebook's Sharing Debugger to preview

Twitter Card tags control how your page appears when shared on Twitter/X.

• summary: Small image card (default)
• summary_large_image: Large image card (recommended for visual content)

• Use large images: summary_large_image gets more engagement
• Image size: Use images at least 800×418 pixels for large cards
• Test cards: Use Twitter's Card Validator to preview

Canonical URLs tell search engines which version of a page is the "official" one. This prevents duplicate content issues.

• Multiple URLs for same content: If the same content is accessible via different URLs
• Syndicated content: If you republish content from another site
• Parameter variations: If URLs have query parameters that don't change content

1. Navigate to SEO settings for the page
2. Enter the canonical URL in the Canonical URL field
3. Click Save

Example: If your page is accessible at both /blog/post and /blog/post?ref=twitter, set the canonical URL to https://yourdomain.com/blog/post.

Robots meta directives control how search engines index and display your page.

• noindex: For private pages, thank-you pages, or duplicate content
• nofollow: For pages with untrusted user-generated links
• noarchive: For time-sensitive content that shouldn't be cached
• nosnippet: For pages where you don't want search engines showing excerpts

1. Navigate to SEO settings for the page
2. Select the directives you want to apply
3. Click Save

JSON-LD (JavaScript Object Notation for Linked Data) provides structured data to search engines, enabling rich results like article cards, breadcrumbs, and knowledge panels.

The CMS automatically generates JSON-LD for:

• WebPage schema: Basic page metadata (title, description, URL)
• Organization schema: Site-level organization data (if configured)
• BreadcrumbList schema: Breadcrumb navigation (for pages with parent pages)

You can add custom JSON-LD for specialized content types:

1. Navigate to SEO settings for the page
2. Click Add JSON-LD
3. Select a schema type or enter custom JSON
4. Fill in the required fields
5. Click Save

For news articles and blog posts:

For blog posts:

For product pages:

Use Google's Rich Results Test to validate your JSON-LD: https://search.google.com/test/rich-results

The robots.txt file tells search engines which pages to crawl.

1. Navigate to Sites → Select your site
2. Click Settings → SEO
3. Edit the Robots.txt content
4. Click Save

You can customize the robots.txt to:

• Block specific paths: Disallow: /admin/
• Block specific bots: User-agent: BadBot followed by Disallow: /
• Set crawl delay: Crawl-delay: 10

Example:

The sitemap lists all published pages on your site, helping search engines discover content.

The CMS automatically generates and updates sitemap.xml:

• On publish: Adds the page to the sitemap
• On unpublish: Removes the page from the sitemap
• On site rebuild: Regenerates the entire sitemap

After publishing your site:

1. Google Search Console: Add your site and submit the sitemap URL
2. Bing Webmaster Tools: Add your site and submit the sitemap URL

Sitemap URL: https://yourdomain.com/sitemap.xml

Configure site-level organization data:

1. Navigate to Sites → Select your site → Settings → SEO
2. Click Configure Organization
3. Fill in the organization details:
   • Name: Organization name
   • URL: Organization website
   • Logo: Organization logo URL
   • Social Profiles: Links to social media profiles

1. Click Save

This data appears on all pages and helps search engines understand your organization.

• Unique titles: Each page should have a unique, descriptive title
• Compelling descriptions: Write descriptions that encourage clicks
• Keyword placement: Include target keywords naturally in titles and descriptions
• Content quality: Focus on high-quality, original content

• Mobile-friendly: Ensure pages work well on mobile devices
• Fast loading: Optimize images and minimize page weight
• HTTPS: Use HTTPS for all pages (handled automatically by the CMS)
• Clean URLs: Use descriptive, readable slugs

• Title length: Keep titles under 60 characters
• Description length: Keep descriptions under 160 characters
• Image optimization: Use appropriately sized images with descriptive alt text
• Structured data: Add JSON-LD for rich results

• OG images: Always set Open Graph images for better social shares
• Test shares: Preview how pages appear when shared
• Consistent branding: Use consistent images and messaging

Monitor your site's search performance:

1. Add your site to Google Search Console
2. Submit your sitemap
3. Monitor:
   • Search queries driving traffic
   • Pages with the most impressions
   • Click-through rates
   • Index coverage issues

Track page performance:

• Page views
• Bounce rate
• Time on page
• Conversion rates

See AI Crawler Analytics for AI-specific analytics.

The Site Settings screen has a Header scripts field. Anything you paste here is injected verbatim as the last thing inside the <head> of every published page (and the site's error page). Typical uses:

• Google Analytics / GA4 or Plausible snippets.
• Google Tag Manager loader (<script>…</script> + <noscript> fallback).
• Search Console / Bing / Ahrefs verification meta tags.
• Custom <link rel="preconnect"> or preload hints.

Notes:

• The content is emitted as-is — the CMS does not sanitise or escape it. Only paste snippets from sources you trust.
• Because the block sits after <title>, meta tags, JSON-LD and the page's inline <style> block, meta/link tags placed here override anything the CMS generated above.

If a page isn't appearing in search results:

1. Check robots directives: Ensure noindex is not set
2. Check robots.txt: Verify the page isn't blocked
3. Submit sitemap: Submit your sitemap to search engines
4. Wait: New pages can take days or weeks to appear
5. Check Search Console: Look for indexing errors

If search results show incorrect metadata:

1. Update page metadata: Ensure title and description are correct
2. Republish the page: Publish to update the live page
3. Request re-indexing: Use Google Search Console to request re-indexing
4. Wait: Search engines may take time to update

If social shares don't look right:

1. Check OG tags: Verify Open Graph settings are correct
2. Republish the page: Publish to update metadata
3. Clear cache: Use Facebook Sharing Debugger or Twitter Card Validator to clear cache
4. Test again: Share the page again to see updated preview

• Creating Pages — Set page titles and descriptions
• Publishing — Publish pages to update SEO metadata
• AI Crawler Analytics — Monitor AI crawler activity