What are labels?
Labels are generally one to two word summaries to help give some high level descriptive detail about an event.
For example, events in the disasters category will have the label "disaster" but an event might also have the label "earthquake", "volcano" or "avalanche".
Labels are particularly helpful when looking at events in your search results list because sometimes just looking at the title of an event, it might not necessarily be clear what the event is.
You can also filter by labels to get very granular results.
If you’re looking at Public Holidays and just want to know which in your list are national/nation-wide public holidays then the label you should select would be "holiday-national".
You shouldn’t select an unrelated label, for example "observance-local" since your selected category is Public Holidays and not Observances. Similarly, you shouldn’t select the label "hurricane" when you’re looking at Public Holidays rather than the Severe Weather category otherwise you’ll end up with no results.
Match all selected labels means that when you hit that search button, each event listing in your list of results should contain all your selected labels.
For example, if you select the labels "holiday-national" and "holiday-religious" then you can expect to get results like this:
Match at least one selected label means that when you hit that search button, each event listing in your list of results should contain at least one of your selected labels.
For example, if you select the labels "holiday-national" and "holiday-religious" then you can expect to get results like:
Because labels get you down to a very granular filter, we recommend for starters searching with your main filters first such as Category, Locations, PHQ Rank and Date then when looking at your results if you see a label appearing that you want just those results for, use the Labels filter to then refine.
Alternatively, select all categories then filter just by specific labels to not be so constrained.
For a full list of labels, please see our Developer Documentation.