Shared Site Settings

_data/site.yml stores addresses used in several parts of the website. Change them here instead of copying a new address into multiple pages.

Edit shared settings

File format

server:
  address:
    en-us: play.example.invalid
    zh-cn: cn.play.example.invalid

links:
  support: https://support.example.invalid
  shop: https://shop.example.invalid
  discord: https://discord.example.invalid/
  youtube: https://www.youtube.com/@Example
  twitter: https://x.com/example

The required shared links are support, shop, discord, youtube, and twitter. Each one must be a complete HTTPS address beginning with https://.

Each configured language requires a server address. An address may contain letters, numbers, dots, and hyphens. Do not include https:// because it is a game server address, not a web link.

Use a shared value in a template

For a link:

<a href="{{ site.data.site.links.support | escape }}">Support</a>

For the server address:

{{ site.data.site.server.address[site.active_lang] }}

The escape part safely prepares a link for HTML. Copy the existing pattern when adding a shared value to a template.

Verify the settings

Check the result

• Search the local website for every place the changed value appears.
• Open changed web links and confirm they reach the intended service.
• Check desktop and mobile navigation/footer locations when relevant.
• Run Running Checks.

Return to Managing Site Data.