Custom fields

custom fields give you the ability to store custom data for the most important objects in your account, like orders, contacts and events in its simplest form it allows you to store extra data with a contact let's say you want to keep track of who is subscribed to your newsletter you can easily add a checkbox that is shown whenever you add or edit a contact custom fields are treated internally exactly the same way as regular fields, so there is no performance penalty for using them several datatypes are available simple string, int or date types, but also checklist or optionset types custom fields for orders and contacts can be configured to be shown during the checkout process this makes it possible to ask the buyer extra info during the checkout proces, either on the order or on the contact level use cases for this are for example "where do you know us from?" (for an order) "newsletter opt in" (for a contact) as custom fields are also exposed via the ticketmatic api it also enables you to control external systems via custom field data an example for this is that you could list all currently published events on your website via a (custom) cms integration if a custom field called "genre" is added to "event", your cms could also list the "genre" of the "event" on your website this way all your "event" related data is stored in one place custom fields are managed in the custom fields module in the settings app click the button below to go there getting started setting up a new custom field let's add a new customfield for "contact" the custom field's name will be "newsletter" and it will indicate if the contact is subscribed to your newsletter to create this custom field execute the following steps go to the "settings app" click on "custom fields" (in the "system" section) in the "contact field" section, click on "add" fill in the name "newsletter" fill in the key "newsletter" this key will be seen whenever an object is requested via the api or when the public data model is used (to define a new "filter" for example) indicate if the field is required, in this case it's not needed to enable this set the data type to "boolean" set the visibility to "backoffice" this means that the custom field will be visible in the backoffice applications click "save" if you go back to the list of custom fields you can see the new custom field in the "contact" section when you add a new contact you will see the new "newsletter" field in the "extra" section on the right side of the screen the field will also appear when you edit an existing contact custom fields you can define custom fields for following items contact delivery scenario event event location order payment method payment scenario price type product ticket custom fields visibility for each custom field, the visibility can be defined hidden the custom field is only available through the api or the public data model it will not be visible in the applications this can be used to integrate with external services backoffice the custom field is available in the backoffice applications, so users can view and edit the value of the custom field checkout the custom field is available during the checkout process this visibility is only possible for custom fields of type order or contact read only in sales views the custom field is read only available for users during sales this visibility is only possible for custom fields of type event when setting the visiblity to checkout , you can further refine when the custom field will be shown by selecting the sales channels and optionally provide an availability script writing availability scripts docid 1pi6ql7ecem9bryn4dbvv availibility custom fields of type read only in sales views can be used to provide event information to users during sales the event information will be available during box office sales and external sales read only sales info custom field types the table below lists all the possible custom field types, the best way to use them and how they are represented in the ui to see how they are returned via the api, check the api documentation https //www ticketmatic com/docs/api/coreconcepts/customfields type usage ui element string small amounts of text (under 255 characters) simple text input field integer whole numeric value, for instance 0, 1, 238 but not 234 23 number input field date date, for instance 2015 03 23 12 30 date input field will show a datepicker with time input boolean checkbox checkbox text larger amounts of text (larger than 255 characters) simple text input field text (with formatting) larger amounts of text (larger than 255 characters) allows basic markdown formatting (headers, bold/italic, links) text input field multi language string small amounts of translatable text (under 255 characters) translations are enabled via the translations workflow text input field (+translation workflow) multi language text larger amounts of translatable text (larger than 255 characters) textarea (+translation workflow) decimal numeric value, for instance 2347 234 number input field single select choose a single option from a list of values dropdown single select (option set) choose a single option from a list of values list of radio buttons multi select choose one or more options from a list of values dropdown with ability to select multiple values multi select (checklist) choose one or more options from a list of values list of checkboxes custom field values some types of custom fields allow you to select one or more options from a list of possible values these values are defined in a separate module custom field values for each custom field you can specify whether the values should be ordered alphabetically or with a custom sort order that you define using custom fields from the backoffice applications custom fields are easy to use from the backoffice applications each time a contact, order or event is edited the ui will show the defined custom fields in a specific section a user will not see the difference between regular and custom fields from the api or the public data model it's also possible to fetch the data behind the custom fields via the ticketmatic api if you request a contact, order or event via the api it will also contain a set of fields that start with c , these are all custom fields the custom field are also autmatically exposed through the public data model for example, the previously created custom field "newsletter" will be added to the contact object whenever you request it via the api the key for this customfield will be c newsletter because we filled in "newsletter" as key you can find more information about custom fields in our api here you can query the public data model for example like this select id,c newsletter from tm contact