Globals

Some details appear on many pages: your phone number, opening hours, social links, a line in the footer. Globals keep each of them in one place. Change it once, and every page that shows it follows.

Globals come in global sets: a group of fields that belong together, like Contact or Footer, with one set of values for the whole site.

#Create a global set

1. Open Globals, under Content in the sidebar.
2. Press New Global Set, give it a name like Contact, and press Create.
3. The set opens on its fields, with one text field to start. Add the fields you need, like an email address and a phone number, and press Save in the bar at the bottom.

Fields work just like they do in collections. See Fields.

#Fill in the values

Open the set, fill in its fields and press Save, or ⌘S. Pages that show these values are updated for you.

To change the set's fields later, press Edit Fields at the top. Delete Global Set is at the end of that page.

#Show a value on your pages

1. Select a block, like a paragraph in your footer, and open Content.
2. Point at its Text and press the database icon beside the label, Connect to Data.
3. Under Globals, choose the set, then add the field's handle, so it reads like globals.contact.phone.

The starter site's footer shows the Tagline of its Footer set this way.

#In other languages

On a site with several languages, a global set holds a value for each one. Each language has a tab at the top of the set: open one to fill in its translation. Anything you don't translate shows the default language's value.

This is also how the words in your templates and components get translated: put them in a global set, and bind the blocks to it.

#For developers

#The global set file

Each set is stored as YAML in content/globals/, with its fields, its values and the values per language:

# content/globals/contact.yaml
title: Contact
icon: phone
fields:
  - handle: email
    type: email
  - handle: phone
    type: text
data:
  email: hello@acme.com
  phone: '+31 20 123 4567'
locales:
  de:
    phone: '+49 30 123 4567'

Add api: true to make a set's values public at GET /api/v1/globals/<handle>. See REST API.

#Bindings

Connect any block to a global value with the path globals.<set>.<field>. Inside a longer text, wrap it in braces:

{ "type": "link", "props": { "label": "Email us" }, "bind": { "url": "mailto:{globals.contact.email}" } }
{ "type": "paragraph", "bind": { "text": "globals.contact.phone", "visible": "globals.contact.phone" } }

In PHP, read one with cms_global('contact.phone').

#Rebuilds

Pages that use globals are rebuilt when a set changes, as long as Rebuild Automatically on Publish is on under Settings → General (it is by default).