Skip to main content
Configuration File: config/seo.ts

Overview

The SEO configuration controls all search engine optimization across your website:
  • Global SEO settings (site URL, name, default images)
  • Page-specific meta tags and descriptions
  • Game-specific SEO for individual game pages
  • Open Graph for social media sharing
  • Twitter Cards configuration
  • Robots and indexing settings
  • Verification codes for search consoles
Configuration file: config/seo.ts

Quick Start

1

Set global settings

Open config/seo.ts and update:
2

Configure page SEO

Update titles and descriptions for each page
3

Test with meta tag preview

Visit https://metatags.io to preview how pages look on social media

Global SEO Settings

Key Fields

  • siteUrl: Your website’s base URL (used for canonical URLs)
  • defaultOgImage: Fallback image for social sharing (1200x630px)
  • titleSeparator: How to separate page title from site name
  • robots: Control search engine crawling behavior
  • verification: Add verification codes from search console tools

Page-Specific SEO

Define SEO for each page:

SEO Best Practices

Title (50-60 characters ideal):
  • Include main keyword near the start
  • Make it compelling and clickable
  • Don’t stuff with keywords
Description (150-160 characters ideal):
  • Write for humans, not robots
  • Include a call-to-action
  • Mention key benefits or features
Keywords:
  • Comma-separated phrases
  • Less important for modern SEO
  • Focus on natural content instead

Game-Specific SEO

Customize SEO for individual game pages:
If a game isn’t listed, it uses the game config’s name and description automatically.

Open Graph Images

Social media preview images should be:
  • Size: 1200x630 pixels
  • Format: JPG or PNG
  • Location: /public/ folder
  • Content: Logo, tagline, and relevant imagery
  • Text: Large and readable (minimum 20% of image)
Place images in /public/:

Helper Functions

The config includes helper functions (you don’t need to edit these):
These are used automatically by Next.js pages.

Complete Example


Best Practices

General SEO

  1. Unique titles/descriptions - Every page should be different
  2. Include keywords naturally - Don’t force them
  3. Write for humans first - Make it compelling
  4. Keep it concise - Respect character limits
  5. Update regularly - Refresh content as offerings change

Open Graph

  1. Create custom images - Generic images get ignored
  2. Test before deploying - Use metatags.io preview
  3. Include branding - Logo should be visible
  4. Optimize file size - Compress images (<500KB)

Technical

  1. Use HTTPS siteUrl - Required for canonical URLs
  2. Set correct locale - en_US, en_GB, etc.
  3. Add verification codes - Once verified in search consoles
  4. Monitor robots.txt - Ensure it doesn’t block important pages

Troubleshooting

Social media not showing custom image

  1. Clear social media cache:
  2. Verify image is exactly 1200x630px
  3. Check image URL starts with https://
  4. Ensure image is in /public/ folder

Page not indexed by Google

  1. Check robots.index is true
  2. Submit sitemap to Google Search Console
  3. Verify robots.txt doesn’t block page
  4. Check for noindex meta tag on page

Wrong title showing

Title format: pageTitle | siteName If seeing wrong title, check:
  1. pageSeo has correct title for the page
  2. titleSeparator is set correctly
  3. Browser cache (hard refresh: Ctrl+Shift+R)

Description too long

Keep descriptions under 160 characters. Check length: