Get GAXPRO
Configuration

Configuration: _data/config.yaml Reference

Complete reference for _data/config.yaml in GAX Pro: navigation, footer, brand, widgets, and social links.

Configuration: _data/config.yaml Reference

Where Configuration Lives

All site-wide settings are in one file:


_data/config.yaml

This file controls the navigation, footer, brand identity, social links, and widget text. You do not edit templates to change these — you edit the config file, and the templates read from it.

How Templates Use the Config

Every template in templates/ reads from _data/config.yaml through the config variable. For example, the header partial uses:


GAX
PRO

When you change a value in config.yaml, it updates on every page that uses it. No template editing needed.

Top-Level Fields

The first block of config.yaml sets site metadata:


title: "GAX Pro — Premium SEO Themes for Go Static Sites"
description: "Premium SEO-ready themes for Go static sites."
keywords: "go static site themes, premium ssg themes, seo ready themes"
author: "GAX Pro Core Team"
url: "https://gaxpro.axcora.com"
lang: "en"
locale: "en_US"
favicon: "/favicon.ico"
image: "/og-card.png"
image_alt: "GAX Pro — premium SEO-ready themes"
robots: "index, follow"

These fields feed the SEO tags, Open Graph tags, and the browser tab title. Change them once, and every page uses them unless the page has its own frontmatter.

Brand Block

The brand block sets the logo and home link:


brand:
  name: "GAX"
  suffix: "PRO"
  tag: "Go 1.27"
  home_url: "/"
  logo_aria: "GAX Pro home"

name and suffix are displayed together in the header. tag is a small label near the logo. home_url is where the logo links to.

Navigation is split into three blocks:


nav:
  primary:
    - label: Themes
      url: "https://www.hockeycomputindo.com/"
      external: true
    - label: Projects
      url: /projects/
    - label: Blog
      url: /blog/
  mobile:
    - label: Themes
      url: "https://www.hockeycomputindo.com/"
      external: true
    - label: Projects
      url: /projects/
  cta:
    label: "Get Premium Theme"
    url: "https://creativitaz.gumroad.com/l/gaxpro"
  • primary — the desktop navigation menu
  • mobile — the mobile navigation menu (can differ from desktop)
  • cta — the call-to-action button in the header

To add a new menu item, add a label and url pair. If the link goes to an external site, set external: true.

To remove a menu item, delete its block. The templates adjust automatically.

The social block sets the URLs used in the footer:


social:
  github: "https://github.com/mesinkasir/gax"
  site: "https://gaxpro.axcora.com"
  free: "https://gax.axcora.com"
  themes: "https://www.hockeycomputindo.com/"
  fiverr_web: "https://www.fiverr.com/creativitas/create-your-custom-website-and-app"
  fiverr_ssg: "https://www.fiverr.com/creativitas/design-your-modern-website-using-jekyll"

These are referenced by name in the footer template. To add a new social link, add it here and reference it in templates/partials/footer.gax.

Widget Blocks

Widgets are reusable text blocks shown at the top of collection pages (blog list, projects list, services list):


widget:
  services:
    label: "Theme & Website Services"
    title: "Custom website, theme setup, and SEO."
    desc: "Need a custom build or theme customization?"
    button: "View Services"
  projects:
    label: "Premium Themes"
    title: "SEO-ready themes for Go static sites."
    desc: "Pre-built themes with clean markup and SEO defaults."
    button: "Browse Themes"
  blogs:
    label: "Theme & SSG Guides"
    title: "How to launch a site with a premium theme."
    desc: "Practical guides on theme setup and deployment."
    button: "Read Guides"

Each widget has a label, title, description, and button text. Change the text to match your site. The button URL is defined in the template, not in the config.

The footer block has several parts:


footer:
  about: "GAX Pro offers premium SEO-ready themes for Go static sites."
  status: "GAX Engine v2.4.0"
  copyright: "© 2026 GAX Pro Core Team & Axcora."
  badges:
    - "SEO-ready themes"
    - "Single binary engine"
    - "No node_modules"
  columns:
    - title: Themes & Product
      links:
        - label: Premium theme (buy)
          url: "https://creativitaz.gumroad.com/l/gaxpro"
          external: true
  • about — the text shown in the footer
  • status — a small status line
  • copyright — the copyright notice
  • badges — short labels shown in the footer
  • columns — link columns, each with a title and a list of links

To add a link column, add a new title and links block. To remove one, delete it.

Editing Tips

Keep quotes around strings with special characters — colons, hash marks, and brackets in YAML need quotes.

Indentation matters — YAML uses spaces, not tabs. Two spaces per level is standard.

Validate after editing — if the site fails to build after editing config.yaml, the YAML syntax is wrong. Use an online YAML validator to check.

Test changes locally — run ./gax and refresh the browser to see changes before deploying.

Common Errors

Build fails after editing config — YAML syntax error. Check indentation and quotes.

Menu item does not appear — the block is not indented under nav.primary or nav.mobile.

Footer link goes to the wrong URL — check the url field. Internal links start with /, external links start with https://.

Site title does not update — the page has its own title in frontmatter, which overrides the config title.

Next Step

Configuration is set. Next, set up the homepage:

Need Help?