System Admin - Managing your organisation's Data Fields
System Admins can manage the data fields they have displaying on their organisation's Upshot account.
Data Fields can either refers to the fields found on an organisations registration form, visible via People > Add New or the fields visible when collecting the data on a head count session.
These are often a combination of Upshot default fields and an organisation's custom attendee data fields. Depending on the set up, this may also include any Facilitating Organisation fields as well if relevant.
In terms of good data practice, these fields should be relevant to what your organisation wants to report back on.
Often the initial registration form (and as such the data fields displayed) have come through consultation with an Upshot team member and members of an organisations internal team at the set up stage.
Over time though things may change, different sets of data may need to be collected, other things may become irrelevant or additional options may need to be added, this guide aims to support System Admins in this process.
- Data Display options
- Adding new attendee data fields
- Managing attendee data fields
- Changing the order of your attendee data fields
- Required fields
- Restricting custom attendee data fields to certain projects
- Custom Head count fields
- 'Searchable' fields
- Attendee sign-up form
- Key Terms
Data Display options
To amend options regarding the existing data fields on an organisations account, System Admins can go to Admin > Data Display options.
Here will be listed the default Upshot 'Core fields' and further down the page any of an organisations custom fields, under the header 'Your Fields.' Also displayed are the 'Basic Head count fields,' these are the default fields displayed when adding a head count.
For any of these fields System Admins can choose for them to be either:
- Displayed, but not required
- Displayed and required
- Not displayed
For any of an organisations custom data fields, these can also be restricted to a particular project(s). This ensures that only users who have access to a particular project see the fields relevant to them on the registration form. Note that fields restricted to particular project(s) cannot then be made required. More information about this can be found here.
If fields are set to 'Not displayed' all the data that exists underneath them is still retained and can be reported on later if needed If this needs to be viewed and reported on later, the field would need to be set to one of the two 'displayed' options.
Note that any changes to the Data Display options may not automatically be reflected in the Attendee sign-up form if used by an organisation, please revisit this under Admin > Attendee sign-up to ensure this is displayed as desired.
If relevant, any Facilitating Organisation (FO) Data Fields set by a Funder that appear at the bottom of an Upshot registration form will not be displayed here for an organisation to make amendments to. The organisation should contact their relevant FO if they feel these fields should not be displayed on their account.
Further down on this page is options regarding the display of Timeline Events on the system. More information on this can be found here.
Adding new attendee data fields
Organisations may start collecting new sets of data as time goes on. It may be the case that a core field such as Ethnicity was originally set to Not displayed on your registration form but now your organisation wants to start using and collecting this data, in this case just amend the Data Display options as described above.
In other instances this may be something completely brand new, for instance as an organisation you might want to start keeping record of how people had heard about your services, and so want to add a field called 'How did you hear about us?'
Adding new fields can be done at any point.
- Go to Admin > Attendee data fields
- On the right-hand side under Tools click Add a new attendee data field
- Here the Label is the title of this field, e.g. 'How did you hear about us?'
- Type of field - Here choose how this information is collected. Text area (free text, unvalidated), Single choice dropdown, Multiple-choice field, tickbox, date.
- Help text = Add any additional information that will help individuals complete this field. Note there is a character limit of 255 characters.
- Data Display options = you can also manage the data display options for these data fields here, choosing between: Displayed and required, Displayed, but not required, Not displayed for both Attendees (via the registration form) or Head count.
- Note that only Single-choice and Tickbox fields can be displayed as head count fields.
- Project Restrictions - Custom Data Fields can be restricted by project(s), making these fields only viewable to users associated with that project. This can help to customise the length of your registration form and limit the number of users that can view and report on certain information. To find out more about this please click here.
- Once you have selected your options click Add.
It can be helpful to quickly return to People > Add New to be sure the field created display as expected. If these are incorrect, it is possible to delete the field while there is still no data attached and then recreate.
Note, the new field will also need to be added to the Attendee sign-up form if this is in use. This can be done by going to Admin > Attendee sign-up form.
Managing attendee data fields
Organisations may choose to amend their existing attendee data fields, whether that is by renaming them, adding new options to a drop down, choosing to no longer display these fields or deleting them.
These changes can all be made by going to Admin > Attendee data fields and clicking manage under the relevant field.
Renaming
After selecting the relevant field and clicking on Manage, the Label (Name of the field) will be displayed at the top, this is a text box where the amendment can be made.
Once the change has been made click update.
Note that it is always worth keeping data integrity in mind when making this change. It would not make sense to change the wording of the field to something very different to how it was originally created, as this may not truly indicate what existing attendees have submitted answers against.
Adding new options to a drop-down list
After selecting the relevant single-choice or multiple-choice field and clicking on Manage, users will see that they can Add another option at the bottom of the screen.
Additionally, the order of options can be changed, by using the icon to click and drag the field on the right-hand side.
Options within the field can only be deleted if they have no data against them. If the option is no longer in use, but it does have existing data, it can be better to rename the option and move to the bottom of the list.
Data Display Options
After selecting the relevant field and clicking on Manage organisations can amend any of the options under Data Display options, choosing between: Displayed and required, Displayed, but not required, Not displayed for both Attendees (via the registration form) or Head count. Note that only Single-choice and Tickbox fields can be displayed as head count fields.
Custom Data Fields can be restricted by project(s), making these fields only viewable to users associated with that project. This can help to customise the length of your registration form and limit the number of users that can view and report on certain information. To find out more about this please click here.
Deleting
After selecting the relevant field and clicking on Manage can click on Available to delete? on the right-hand side under Tools.
Fields can only be deleted if there is no existing data associated to them. If the field is simply no longer used, it can be better to amend it to Not displayed. This way the existing data is retained in case it is ever needed later, while also stopping additional data being added against it and removing it from the current registration form.
If the field does need to be deleted the associated information must be removed first. Please contact support@upshot.org.uk who will be able to assist with removing this information in bulk, allowing organisations to delete the field.
Changing the order of an organisations attendee data fields
In the registration form via People > Add New, an organisations custom attendee data fields will always appear at the bottom of the page.
The order these custom fields appear though can be changed by clicking and dragging the icon highlighted in the screenshot below.
Required Fields
Fields can be made displayed and required. This can be helpful for organisations to ensure they have data consistently added against attendee profiles.
The following fields are required by the system and cannot be changed:
- First name or nickname
- Gender
Note Gender has a 'Prefer not to say' and 'Not provided' option.
These fields are required as they serve a dual purpose in the system. Ensuring that every attendee has this information added to their profile allows the inbuilt duplicate checker to cross reference profiles added to the system. More information about duplicates and the duplicate checker can be found here.
For organisations using the external Attendee sign-up form there is the flexibility of making fields required on the external form, but keep them 'Displayed, but not required' internally.
This ensures that users can still add new attendees manually to the system if they do not have full information on the attendee from a paper registration form collected, while attendees completing the form electronically are required to submit all the desired information.
Making fields required on the Attendee sign-up form only, an be done by going to Admin > Attendee sign-up and ticking the required box alongside the relevant field.
Restricting custom attendee data fields to certain projects
Custom Attendee Data Fields can be restricted by project(s).
Custom Head count fields
If you would like to add detail to your head count reporting, organisations can create Custom Head count Fields. These will allow you to split your head count by fields in addition to the Upshot default gender split and age range.
'Searchable' Fields
When searching for attendees (using the search bar in the top right) or adding attendees to registers users often search by using the first three characters of either the attendee's first and/or last name but it is helpful to know there are other fields that can be used in these search areas to return the attendees you desire.
'Search' bar
In the top right-hand corner the search bar can be used to find attendees via either their First name, Last name, Nickname, Upshot ID, Identifying notes, and Membership Number.
The information displayed when searching will be the First name, Last name and Nickname (in brackets)
When adding attendees to registers either from the session itself or the grid view, the Add existing attendee search bar can be used to find attendees via either their First name, Last name, Nickname, Upshot ID, Identifying notes, and Membership Number.
The information displayed when searching will be the First name, Last name, Nickname, Age and Identifying information.
When selected and added to the register only the First name and Last name of the attendee will show.
Identifying notes and Membership Number
Organisations may not have these default fields currently displayed on their account. This can be amended by going to Admin > Data display options.
Please note that Membership Number does not only have to be a number. It can be any selection of characters organisations desire. I.e. this could be an actual 'number' or alternatively you might want to put in another reference point, such as 'Team' or 'Email address' that you also want to be able to search for attendees by.
Attendee sign-up form
It is important to note any changes to your Attendee data fields will not always be automatically reflected in the external Attendee sign-up form.
Amendments to the options within any existing fields (such as adding a new option to a single-choice field) will automatically be updated on the Attendee sign-up form.
For other amendments, such as new fields added, existing fields set to not displayed, or a renaming of existing fields the following rules apply and action needs to be taken via the form builder page accessed via Admin > Attendee sign-up form.
- New custom attendee data fields - These will be presented on the right-hand side under Available form fields and users need to drag and drop these fields into the relevant order of their form on the left hand side. At the top of the form users should then click Save.
- Existing fields set to not displayed - If the field no longer displayed had previously been used in the organisation's attendee sign-up form, the organisation will see it listed with the following message:
As the message states, the field is no longer being displayed. Organisation's might find it helpful to remove this field from the list on the left-hand side to get a more accurate impression of what is currently being displayed. This can be done by clicking the cross highlighted above and then at the top of the form clicking Save.
- Renaming of existing fields - If a field has been amended, in terms of either a rewording of the 'label' or a change to the help text, this will automatically reflect in the Attendee sign-up form.
Note: Any amendments to the external Attendee sign-up form will not alter the URL link for the form itself, ensuring that if the link has been shared previously it will still be relevant and the same one to use.
Key Terms
Attendee Data Fields:
Facilitating Organisation:
In Upshot there are two platforms - one for facilitating organisations, often used by funders, and another for delivery organisation accounts, where the attendee and session information is inputted. Facilitating Organisations accounts can be thought of as an over-arching account linked to a number Delivery Organisation accounts. If applicable, information feeds through from the Delivery Organisation level to the higher Facilitating Organisation level for reporting purposes. However, this is not a necessity and delivery organisation accounts are not always linked to a facilitating organisation account.