Skip to content

Site Options

Creates global fields — contact details, social links, branding, anything site-wide — and makes them readable through dynamic tags. Set a value once and it updates everywhere it's used, instead of being edited in a dozen templates.

Its own admin menu

Unlike most toolkit functions, enabling Site Options adds a top-level Site Options menu to the admin sidebar rather than living under Voxel Toolkit. It has two screens:

ScreenPurpose
Site OptionsEnter the values
Configure FieldsDefine which fields exist and what type each one is

The Configure button on the Functions screen takes you straight to Configure Fields.

Setting it up

  1. Enable Site Options under Voxel Toolkit → Functions.
  2. Go to Site Options → Configure Fields and define your fields — each gets a name and a type.
  3. Go to Site Options and fill in the values.
  4. Reference them in templates with a dynamic tag.

Using the values

@site(options.field_name)

field_name is the field's name from Configure Fields. Field names are sanitised when saved, so a field entered as "Contact Email" becomes something like contact_email — use the stored name in the tag.

The tag works anywhere Voxel accepts dynamic data: Elementor widgets, email templates, and post type settings.

What to use it for

  • Contact details — phone, email, address shown in a header, footer, and contact page
  • Social links — one place to update every profile URL
  • Branding — a logo or tagline reused across templates
  • Announcements — a banner message you can change without editing templates

Anything appearing in more than two templates and changing occasionally is a good candidate.

Troubleshooting

The Site Options menu isn't there

It only appears when the function is enabled. Turn it on under Voxel Toolkit → Functions, then reload the admin.

The tag outputs nothing

  • Confirm the field name in the tag matches the saved name, not the label you typed
  • Confirm a value is saved under Site Options, not just defined under Configure Fields — defining a field and filling it in are separate steps
  • Confirm the function is still enabled

Which templates use a tag?

Voxel Toolkit → Tag Usage scans the site for dynamic tag usage. Check it before renaming or removing a field so you know what will break.

Built by Code Wattz.