Tallybox GuidebookManual
Built on Tallybox v1.4.0 · captured 2026-11-11
Administration
Guide 6.2

Change settings

Settings are a short list of named values that change how Tallybox behaves. Only a Super Admin can see or change them.

Who can do thisSuper Admin

A setting is one named value, such as how many seconds pass between dashboard refreshes or the fee added to a vote bundle. The system sets them up for you. Day to day you rarely touch them, and you should change one only when you know what it does.

A wrong value changes how the whole system behaves. Settings apply everywhere at once. Note the old value before you change it, and never change one you do not recognise.

Read the settings

  1. Choose Settings in the Administration menu
  2. Read the Key, Type and Value columnsThe key is the setting's name. The type says what kind of value it holds, for example a whole number, a decimal number, a choice from a list, text, a yes or no switch, or an image.
  3. Search by key, or filter by Type
The Settings list with ten of fifteen settings. Columns are Key, Type and Value. Rows include dashboard.refresh.live_seconds with value 10, dashboard.refresh.standard_seconds with value 60 and two poll fee settings. Each row has View and Edit. A New setting button is at the top right.
  1. New setting: adds a setting. You will rarely need it.
  2. Search: finds a setting by its key.
  3. Type: what kind of value it holds.
  4. Value: what it is set to now.
  5. View: read one setting on its own page.
  6. Edit: change the value.

Change a value

  1. Choose Edit on the setting
  2. Change the ValueThe field matches the type: a switch, a number, a list or text. A helper line under the field says what values are allowed.
  3. Choose Save changes
The View page for the setting dashboard.refresh.live_seconds. It shows Key, Type Integer and Value 10, with an Edit button at the top right.
  1. Key: the setting's name. It cannot be changed after the setting is created.
  2. Type: the kind of value.
  3. Value: the current value.
  4. Edit: opens the form to change the value.

Two settings you may meet often set how many seconds pass between dashboard refreshes while Auto-refresh is on, one for live use and one for everyday use. Each accepts 5 to 300. You can also change them from the Dashboard's Refresh intervals button. See Read the dashboard. The poll fee settings set the extra charges added to votes and are explained where polls are set up.

Add a setting

  1. On the Settings page, choose New setting
  2. Type the Key, then choose the TypeThe field under it changes to match the type. The key cannot be changed once it is created.
  3. Fill in the Value and choose CreateChoose Create & create another to add a second one straight away.
The Create Setting form. Key is empty with a note that it cannot be changed once created. Type is set to String. A Value field is required, and an Image value upload box sits beside it. Create, Create and create another, and Cancel buttons are below.
  1. Key: the name the system looks for. A new key does nothing unless the system already uses it.
  2. Type: choose what kind of value this is.
  3. Value: required for most types.
  4. Image value: used only when the type is Image. Ignore it otherwise.
  5. Create: saves the setting.
A new key only helps if the system already looks for it. Adding a setting with a made-up name changes nothing. Add one only when you have been told the exact key to use.

Remove settings

On the Edit page, choose Delete at the top. To remove several, tick them on the list, choose Bulk actions, then Delete selected, and confirm. Removing a setting the system relies on can switch a feature off or change its behaviour, so only remove one you added yourself.