Search

Event Attributes

Rachael Norris
Rachael Norris
  • Updated

You can set up Event Attributes to store extra information about Events on your Spektrix system.

In this article, we’ll cover how to create an Event Attribute, assign an Attribute to an Event and provide some example use cases.

Before getting started with Event Attributes, take a look at:

 

Why use Event Attributes?

You can use Event Attributes to store extra information about Events. 

When setting up Events, Event Attributes will be displayed as additional fields. You can even make the Attribute required to ensure this information is always completed. 

You can apply Event Attributes retrospectively by editing an Event, or at the time of creating a new Event.

Once an Event Attribute is applied, it can be used to power:

Example use cases

Event Attributes are commonly used to group Events into categories or to signify the Event has a particular value.

For example, you might want to group your Events into 'Genres' for Reporting purposes or to display Events grouped by Genre on your website. To do this you could apply an Event Attribute to your Events.

For Genre, you may want to use a Dropdown List to list the different Genres available. For example, 'Comedy', 'Musical', 'Classical', etc:


 

Another example of how you could use an Event Attribute, would be to assign an Attribute to an Event to include in a Member priority booking period. By doing this you can then use the Attribute to power the Priority Booking Event Criteria to include or exclude certain Events.

To signify that an Event should be included you might want to use a checkbox Attribute named something like Included in Priority Booking. You would then check the box of each of the Events you want included in the Priority Booking period:

 

Some other common Event Attribute examples include:

  • Festival: For example, Family Festival or Literary Festival.
  • Season: For example, 2024-25 Season or Spring/Summer 2025.

 

How to create an Event Attribute

To create a new Event Attribute, navigate to the Settings Interface > Attributes > Event.

TIP: You'll need the Settings Administrator user role to create and edit Attributes. If you don’t have this permission, ask the administrator in your organisation.

Click the New Attribute Definition button.

Attribute Definition

Next, you’ll be asked to input information to define the parameters of your Attribute.



Complete the following information.

  • Name: give the Attribute a clear and descriptive name. Attribute names cannot include special characters (, . - & ! / etc.). Your Attribute name cannot be longer than 50 characters.

TIP: Consider if your Attribute will be visible to customers on your website when choosing the name of your Attribute.

WARNING: You cannot change the name of an Attribute once you have created it. You’ll need to create a new Attribute.

  • Type: choose the Attribute type.

  • Description: use this field to make it clear to other members of your team what the purpose of this Attribute is. This description will only be visible in the Admin Interface.

  • This Attribute is visible in your API integrations: check this box to make this Attribute available to the API.
  • This Attribute is always required: check this box to make this Attribute mandatory.

    Required Attributes will appear with a red line. You’ll need to enter information in order to proceed:

REMINDER: Check box Attributes can never be set to required, as they work on a binary yes/no response. This means that leaving the box unchecked is a valid response.

  • This Attribute is protected: this option is greyed out as you cannot protect Event Attributes.

  • Length: choose the maximum number of characters that can be entered, or set the exact number of characters which have to be entered to proceed. A text field can contain a maximum of 255 characters.

  • Allow users to enter free text for this Attribute: this option is only available for Dropdown List Attributes.

  • Unique Value: check this box if you require a unique value to be entered every time.

  • Artifax Event Mapping field: this will allow you to map fields if you are using the Artifax Event Importer.

Once you are happy with the information inputted, click Create Attribute Definition.

Attribute Values

If you choose a Dropdown List, you will then need to add in the Values. 

Type each of your values for this Attribute on a separate line. Each line appears as a value in this Attribute’s Dropdown List:

    • Select the Attribute you want edit. 
    • Go to Attribute Values.
    • To add a new Attribute Value click New Attribute Value.
    • You can rearrange the Values by clicking and dragging them from the grey dots on the left:

    • Clicking the grey trash can icon will delete the Attribute value.
    • Click on the name of the Attribute value to edit.

    WARNING: Editing the name of an Attribute Value will replace all existing values with the new value. If your website integration uses this Attribute then this may prevent your website from working properly.

    • Click Update Attribute Value if you are happy to proceed.

     

Event Attributes in the Admin Interface

Once created, your new Event Attribute will appear in the Admin Interface > Events.

In this example you can see the Genre and Festival Attributes on the Event set up page.

To apply an Attribute to an Event you would fill in the Event Details as you would when setting up an Event.

If you want to add an Attribute value to an Event you have already created, you can edit the Event and apply the Attribute:

 

Event Attributes online

Event Attributes are not visible to Customers. They can be used as part of your API or iframe website integration. For example, if you choose to display Events grouped by an Event Attribute such as Genre.

Confirmation Text and Account Code

You can apply Confirmation Text Attribute to an Event to display extra information in your plain text confirmation emails that are generated when someone makes a purchase. If you're using Classic Checkout, Confirmation Text will also display to customers on the Order Summary page. 

Account Code Attributes can also be added to Events for use in Reporting.

 

Further Reading

To continue learning about Event Set Up, take a look at the following articles:

You can find more articles on Setting Up and Editing Events in the Set up Events, Offers, Subscriptions and Merchandise section of the Support Centre.