1. What is Named Entity Recognition (NER)?

Named entity recognition (NER) refers to the task of identifying and extracting named entities from a text. Named entities are words or groups of words of interest that may include people,
places, dates and times, amounts, and more.

2. Entity Class Definition

The table below details all entity classes that are used for this task.

# Entity Class Definition Subclasses

o DATE
o TIME
o DATETIME
1 DATE_TIME A time, date, interval, or duration.
o DURATION
o INTERVAL
o RECURRING
o CURRENCY
o PERCENTAGE
o DIMENSION
2 QUANTITY Something that can be counted or measured. o AGE
o TEMPERATURE
o NUMBER
o QUANTITY
o GPE
o NON-GPE
3 LOCATION Anything that can be pin-pointed to a specific geographic location. o FACILITY
o LOCATION

4 PERSON People, including fictional ones.

5 ORGANIZATION Companies, agencies, institutions, etc.

Any product or service that can be purchased or consumed as a

6 PRODUCT
whole or as a part of a whole.

Something that happened or will happen; an occasion or social

7 EVENT
gathering with some sense of time attached to it.

3. How to Annotate Text

Each entity class has up to three sublevels. These levels are called "Tag 1", "Tag 2", and "Tag 3" in these guidelines. The same span of text can be annotated using multiple tags from different
levels or from different entity classes, as applicable.

TAG TYPE DESCRIPTION EXAMPLE

TAG 1 entities The largest span of text eligible for annotation. "15-hour" "Sunday evening to Monday morning"
"15" "hour"
TAG 2 entities
A shorter or equal part of text to be annotated after the selection
"Sunday evening" "Monday Morning"
of Tag 1, if available.
"Sunday" "evening" "Monday" "morning"
TAG 3 entities A shorter or equal part of text to be annotated after the selection "Sunday"
of Tag 2, if available. "Monday"

4. Subclass Definition

The data selected for annotation may fall into one of the two categories listed in the table below. During data collection, only documents belonging to the Core/Fully Qualified Context category
should be accepted. No Edge Cases should be included in the dataset. If auditors encounter Edge Cases during auditing, they should flag the entire document as invalid.

Type Definition Action

Examples which are straightforward and have full or sufficient

Core/Fully Qualified Context Documents containing core/fully qualified context should be annotated
context to make a decision about tagging without ambiguity.

Examples which are ambiguous and where the context is unclear or

Edge Cases missing altogether. The entity cannot be resolved or more than one Documents containing edge cases should be rejected
tag could be used.

5. Ambiguous and Edge Cases

Below are some examples of ambiguous cases with the indication of whether or not they should be treated as edge cases or valid documents. Please read the documents carefully when you do
annotation and assign the correct tags taking context into proper consideration.

# Type Example Description

Edge Case “2020” could refer to a year, currency, or a quantity. There is not sufficient
2020 was too much!
1 context to resolve this entity. This is not a valid document.
Edge Case “Jan” can refer to January or be the name of the person. Context does not
Show me Jan's payslips.
2 clarify this. This is not a valid document.
Edge Case It is not clear what “12.30” refers to. It could be currency or time.
Lunch at Tony's for 12.30
3 This is not a valid document.
“Sydney” could be the name of the person or the city. However, context suggest
Ambiguous - Context dependent Where is Sydney’s office? I need to talk to her urgently. that Sydney is the name of a person. It can be annotated as PERSON.
4 This is a valid document.
Although there is no explicit indication that “20” refers to money, the verb “paid
Ambiguous - Context dependent ” provides sufficient content to determine what it stands for. It should be
I paid 20 for parking
annotated as CURRENCY.
5 This is a valid document.
 General Rules for Annotation
Below are some general rules that apply to all/most entity classes. Annotations in the below examples illustrate the specific rule under consideration: text in bold marks correct annotations, text in red marks text
that should not be annotated. Any other text or span of text that is eligible for annotation but not covered by the specific rule is not highlighted.
# Rule Description Examples
1 The Tag should match the context Example 1:
Oscar-winning music composer A R Rahman gets a street named after him in Markham, Ontario, Canada and
the board reads Allah-Rakha Rahman st .
The first mention would be PERSON while the second one should be tagged as FACILITY because it refers to the
name of the street, not to the person.

Example 2:
Listen to Madison Avenue on Spotify!
In this document "Madison Avenue" is not a street name in this example, but the name of a band, and therefore
it should be tagged as ORG and not as FACILITY.

Example 3:
Twitter, Inc . is an American social media company that operates the microblogging and social networking
service Twitter .
The first mention of "Twitter" refers to the company name and should therefore the annotated as ORG, while the
second mention refers to its service, which should be annotated as PRODUCT.

2 Double Annotation For some specific cases, two tags from different Example 1:
entity classes can be used to annotate the same We had to stand in line for 3 hours to get in!
word or span of text. "3 hours" should annotated both as QUANTITY and as DURATION.

Example 2:
Halloween is a time for pumpkin carving, dressing up, and trick or treating!
Both tags DATE and EVENT can be used.

3 Typos and grammar errors Words/phrases can be annotated in a valid Example 1:

document even if they are misspelled. I sliced 5 potatos in less than one minute!

Example 2:
The results will be announced today on 1 pm .
Although the spelling/grammar is incorrect, the selected words in these examples can be safely annotated since
the context is clear.
4 Punctuation Do not include punctuation in the annotation Example 1:
unless it is within the span of text to be annotated A new trade pact is expected to accelerate the flow of goods between China , Japan , South Korea , and
or required by the context. Australia .

Example 2:
The press conference took place on Thu, April 7, 2022, 9:00 AM – 5:00 PM in New York City, NY, United
States .
Punctuation in Example 1 separates different entities in a list, so it should not be annotated. Punctuation in
Example 2 is annotated because it lies within the span of text to be annotated.

Example 3:
Scotland 's Tom Stoltman has retained his World's Strongest Man title.
The first apostrophe should not be included in the annotation because the two entities should be annotated
separately, while the second one is part of a proper name, so it should be included in the annotation.

Example 4:
Let's examine the Bank of Japan (BOJ) 's monetary policies ( 2010-2020 ) .
Acronyms in parentheses following the extended name should be considered a full annotation, so the
parentheses are included in the annotation. Do not annotate parentheses in cases where only the content within
the parentheses should be annotated.

Example 5:
Initially called the " Book Club ", the bank was renamed as Siam Commercial Bank in 1906.

5 Articles, prepositions, conjunctions Do not include articles, prepositions, conjunctions Example 1:

unless they lie within the span of text to be The U.S. Bureau of Labor Statistics accounted for 13 million people working in the hospitality and leisure
annotated. industry as of December 2020 .

Example 2:
Literally was expected to be delivered with prime shipping on nov 24th, received it the 29th and after installing
it showed -14°C.

Example 3:
Australia and Trinidad and Tobago formally established diplomatic relations in 1974

6 Indefinite articles The indefinite article "a/an" should not be Example 1:

considered in the annotation of QUANTITY, unless They live in a house by the sea
the focus is clearly on the quantity. This should NOT be annotated as QUANTITY.

The indefinite article "a/an" can be annotated Example 2:

when it refers to a DURATION time span. Unless you're trying to be a body builder , you don't need to consume a gram of protein per pound of
bodyweight
In this example, "a body builder" should not be flagged as QUANTITY, while "a gram" can be annotated as
DIMENSION.

Example 3:
I have a cup of coffee a day, maybe two if I had a bad night of sleep .
In this example "a cup" refers to the number of cups, so it can be annotated as QUANTITY, while the quantity is
not the main focus in "a bad night of sleep".

Example 4:
You can now book a year long cruise that visits all continents.
The span of text "a year" can be annotated for DURATION but it does not qualify for QUANTITY.

7 Repetitions If the same word/phrase is repeated multiple Example 1:

times in a document, annotate all applicable Ok, first you don’t need to say London UK , it is just London . Like New York is New York or Washington is
mentions. Washington .

Example 2:
If you are first you are first , if you are second, you are nothing.

8 Adjectives Do not annotate adjectives, unless they are part of Example 1:

a proper name or a full concept. I need to buy new tires for my car.
Tires can be flagged as PRODUCT, but "new" should not be included in the annotation.

Example 2:
They attended a crowded conference at a big hotel in the city center.
Conference should be annotated, but the adjective "crowded" is irrelevant.

Example 3:
Over the past few years, three new food chains have popped up in the Big Apple .
Big Apple is a proper noun and the adjective should be part of the annotation.

Example 4:
With film usage and adoption on the rise, we wanted to resurrect the debate of digital photos versus analog
photos .
The adjectives in this example are relevant and should be annotated.

Example 5:
Sunlight is caught by the solar panels and converted into usable electricity.
Solar panel is a full concept and should be annotated entirely.
 Entity Class DATE_TIME
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

17th DATE
Day only Schedule a meeting for the 17th 17th DAY N/A
meeting EVENT
Aug MONTH
We met on Aug 3rd Aug 3rd DATE N/A
3rd DAY
Month + Day
15th DAY
The event will take place on 15th March 15th March DATE N/A
Day + Month March MONTH
birthday EVENT 2 MONTH
Her birthday is on 2/28 N/A
2/28 DATE 28 DAY
01 MONTH

It happened on 01/31/2018 01/31/2018 DATE 31 DAY N/A

Any combination of 2018 YEAR

Month + Day + Year Argentina ORG 18th DAY
Calendar date Argentina won the final on 18th December
final EVENT December MONTH N/A
2022
Please refer to the table in the Appendix tab for
the list of supported date formats. 18th December 2022 DATE 2022 YEAR

An extraordinary amount of rain fell in January January MONTH N/A

Month only DATE
January
MONTH
8 UNIT
8 consumer trends QUANTITY
1. DATE YEAR N/A 8 consumer trends that will shape retail in N/A
Year only consumer trends UNIT_TYPE
2023
2023 DATE
DAY
2023 YEAR
Month + Year
April MONTH
They married in April 2005 April 2005 DATE N/A
2005 YEAR
Year + Month
Do not annotate words like It's a beautiful day N/A N/A N/A
"day", "month", "year" as DATE
when they are not associated with
a specific date or do not have a 366 UNIT
A leap year has 366 days 366 days QUANTITY N/A
sense of time attached to them
days UNIT_TYPE

Written in full or abbreviated Monday Monday DAY N/A

Days of week The ship sails on Monday DATE
Monday, Tue., Wed

appointment EVENT
"next" / "last" / "this" + day of next Friday DAY N/A
Relative Day of week The appointment is next Friday
week
next Friday DATE
Yesterday
Today today today DAY N/A
Date Phrases I am busy today DATE
Tomorrow
The day after tomorrow
Christmas day DATE
Thanksgiving I spent time with my family on Christmas Christmas day DAY N/A
Festivals/Holidays
Christmas, etc. day
Christmas EVENT

ANNOTATION
TAG 1 TAG 2 TAG 3

DEFINITION TYPES EXAMPLES

Shorter or Shorter or
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

Lunch EVENT
12-hour clock, including am/pm N/A N/A
Lunch is at 1:30 PM.
if present
1:30 PM TIME
Lunch EVENT
24-hour clock Lunch is at 13:30. N/A N/A
13:30 TIME
meeting EVENT
12-hour ambiguous Schedule a meeting for eight o'clock. N/A N/A
eight o'clock TIME
2. TIME N/A N/A Time of day meeting EVENT
Time Zones The meeting is scheduled at 12 CET. N/A N/A
12 CET TIME
Time Phrases midnight TIME N/A N/A
The subway runs until midnight.
morning afternoon evening etc
breakfast EVENT
Relative Time I will have breakfast right now. N/A N/A
right now TIME
Do not annotate if the time
indication is not clear and it is not I will have breakfast later. breakfast EVENT N/A N/A
resolvable to a specific time

ANNOTATION
TAG 1 TAG 2 TAG 3

DEFINITION TYPES EXAMPLES

Shorter or Shorter or
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

MONTH
Friday DATE
DATE YEAR Date + Time They went out on a Friday night Friday night DATETIME Friday DAY
night TIME
DAY A combination of DATE and TIME
3. DATETIME Monday DAY
Please refer to the sections for the DATE and
TIME tags for further details 10 pm TIME 28th DAY
We met at 10 pm on Monday, 28th July, 10 pm on Monday, 28th DATETIME
TIME N/A Time + Date
2021 July, 2021
Monday, 28th July 2021 DATE July MONTH

2021 YEAR

ANNOTATION
TAG 1 TAG 2 TAG 3

DEFINITION TYPES EXAMPLES

Shorter or Shorter or
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

two UNIT
two hours DURATION N/A
Number + Time I will be there for two hours
QUANTITY
hours UNIT_TYPE

10 UNIT
10 days DURATION N/A
Number + Date It took 10 days to finish the task
QUANTITY
days UNIT_TYPE

A length or duration of time

Start and end are not defined explicitly and the
exact time cannot be identified. I will be going for few days few days DURATION N/A N/A
4. DURATION N/A N/A
DURATION should be tagged also as QUANTITY
when it is represented by a number + unit type Generic time phrases that are a week DURATION
(see QUANTITY tab for details) NOT accompanied by words like It was a week long trip N/A N/A
"next", "last", "this" and therefore trip EVENT
cannot be resolved to a precise
date but have a sense of time weekend DURATION
attached to them. He spent the weekend playing video games N/A N/A
video games PRODUCT
winter DURATION 55 UNIT
To keep your plants alive over the winter,
N/A
maintain the temperature at 55°F.
55°F TEMPERATURE °F UNIT_TYPE
Do not annotate as DURATION Winter Olympic Games EVENT
time phrases that are part of a The Winter Olympic Games are a multisport
N/A N/A
proper noun, that are too generic, event for sports practiced on ice and snow. multisport event EVENT
or if there is no sense of time
attached to them. Summers are getting hotter on average. N/A N/A N/A

ANNOTATION
TAG 1 TAG 2 TAG 3

DEFINITION TYPES EXAMPLES

Shorter or Shorter or
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

START
10th 10th DAY
DATE
10th to the 12th of
I want to book a flight from the 10th to the
August INTERVAL 12th DAY
12th of August END
12th of August
DATE
START Between two points of August MONTH
N/A time/date
END
The first point will be marked with START
START, the second point with january DATE
january MONTH
END. Payslips january-march january-march INTERVAL
DATE, TIME and DURATION tags march END
march MONTH
should be used as appropriate DATE

START
5 pm TIME
TIME N/A I need to be there from 5 pm to 6 pm 5 pm to 6 pm INTERVAL N/A
6 pm END
TIME

MONTH Phrases/Words that refer to a Belfast GPE Belfast CITY

DATE YEAR range of time (usually more What's on in Belfast this weekend? weekend DAY
DAY than one day) this weekend INTERVAL weekend DATE

Annotate these phrases if they

are resolvable to an actual date.
An interval / range of time For example, if they are first quarter of 2023 INTERVAL first quarter DURATION
accompanied by "last", "next", This resort is set to open in the first quarter
2023 YEAR
If applicable: NOTE: TAG 2 labels START/END can be used "this". of 2023.
first NUMBER first UNIT
5. INTERVAL MONTH combined with the TIME, DATE and DURATION
N/A tags, where applicable. More examples:
YEAR
DAY A document can have only the START tag or only "first quarter of 2019"
the END tag. "last weekend" rise in the gas price EVENT
"mid-march"
"this month" The rise in the gas price has been obvious
gas PRODUCT beginning of March START March MONTH
"next month" since the beginning of March.
"1980s" beginning of March INTERVAL
"last season" last part of the 19th INTERVAL
"first half of 2016" It wasn't until the last part of the 19th 19th century DURATION
century
century that mistreatment of animals came N/A
to be against the law in the United States. United States COUNTRY
United States GPE
START
5 pm TIME
meeting EVENT
2 hours DURATION
Schedule a meeting from 5 pm for 2 hours 5 pm for 2 hours INTERVAL N/A
2 UNIT
2 hours QUANTITY
DURATION N/A
hours UNIT_TYPE
START + DURATION or
DURATION + END 2 weeks DURATION

exhibition EVENT 2 UNIT

April MONTH
The exhibition will remain open to the public
2 weeks until 24th April INTERVAL weeks UNIT_TYPE
for 2 weeks until 24th April.
15 DAY
2 weeks QUANTITY 24th April END
DATE

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

A recurring date
MONTH lunch EVENT
(daily, weekly, yearly, on Tuesdays, Sunday DATE Sunday DAY
DATE YEAR I have lunch with my family every Sunday.
every January, every Christmas,
DAY every Sunday RECURRING
etc.)

A recurring time medicine PRODUCT

You need to take the medicine every morning TIME N/A
TIME N/A (every 15 minutes, at 2 pm daily,
morning when you wake up.
each evening, etc.) every morning RECURRING

Monday DATE
every Monday for 2 RECURRING
2 hours DURATION
6. RECURRING A recurring date, time, duration, or interval A recurring duration We would regroup every Monday for 2 hours Monday DAY
DURATION N/A
(ex. every day for 4 hours) hours to report progress.
2 UNIT
2 hours QUANTITY
hours UNIT_TYPE
day DATE

10 to 19 INTERVAL
START A recurring interval 10 START
INTERVAL (ex. every Wednesday from 10 The shop is open every day from 10 to 19. every day from 10 to 19 RECURRING
10 TIME
END am to 15 pm) 19 END
19 TIME
 Entity Class QUANTITY
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

$200 CURRENCY $ UNIT_TYPE

I paid $200 for the flight ticket N/A
flight ticket PRODUCT 200 UNIT

Digits
$75 Canadian CURRENCY $ UNIT_TYPE
I spent $75 Canadian at Staples for copy
Staples ORG 75 UNIT N/A
paper.
copy paper PRODUCT Canadian UNIT_TYPE
Any amount/unit (or both)
representing any currency in the two hundred UNIT
Text They won two hundred dollars at the two hundred dollars CURRENCY
world. N/A
lottery.
dollars UNIT_TYPE
UNIT
Please refer to the Appendix tab for a
1. CURRENCY N/A list of the supported currencies. Pesos CURRENCY Pesos UNIT_TYPE
UNIT_TYPE Only UNIT_TYPE I had no Pesos when I landed in Mexico. N/A
Mexico GPE Mexico COUNTRY
Tag UNIT to be used for the number
Tag UNIT_TYPE to be used for the Staples ORG
currency name/symbol
48.53 UNIT
I have some office supply receipts from receipts PRODUCT
N/A
Staples totaling 48.53 in Canadian dollars.
Canadian dollars UNIT_TYPE
48.53 in Canadian CURRENCY
dollars
Disjointed entities
business lunch EVENT
182.45 UNIT
Macys ORG
For the business lunch at Macys I paid
7.55 UNIT N/A
182.45 plus a tip of 7.55 EUR
182.45 CURRENCY
EUR UNIT_TYPE
7.55 EUR CURRENCY

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

20 UNIT
Simple He scored 20%. 20% PERCENTAGE N/A
% UNIT_TYPE

US COUNTRY
A fraction or a part of whole having a
number attached. -0.6 UNIT
UNIT US GPE
2. PERCENTAGE UNIT_TYPE N/A % UNIT_TYPE
Tag UNIT to be used for the number The number of people employed in the -0.6% PERCENTAGE
Tag UNIT_TYPE to be used for the six UNIT 2017 YEAR
Negative Hotels & Motels industry in the US declined
percentage sign + nouns if any by -0.6% on average over the six years six years DURATION
years UNIT_TYPE 2022 YEAR
between 2017 and 2022 QUANTITY
2017 START
2017 and 2022 INTERVAL
DATE
2022
END
DATE

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

25.19 UNIT
The box weighed 25.19 KG 25.19 KG DIMENSION N/A
KG UNIT TYPE
Melbourne International FACILITY
Airport
Melbourne CITY
Melbourne International Airport lies 10 miles Melbourne GPE
10 UNIT N/A
away from the hotel
10 miles DIMENSION
miles UNIT_TYPE

Simple hotel FACILITY

One UNIT

One cup QUANTITY cup UNIT_TYPE

cantaloupe melon balls PRODUCT 177 UNIT

One cup of cantaloupe melon balls weighs
N/A
Any numeric value associated with a 177g. In that amount, you get 60 calories.
177g DIMENSION g UNIT_TYPE
measuring unit from any system (e.g.,
kg, grams, cm, miles, calories etc.). 60 calories DIMENSION 60 UNIT

UNIT calories UNIT_TYPE

Exception: do not annotate measuring
3. DIMENSION UNIT_TYPE N/A 2/3 UNIT
units covered by other tags (i.e. DIMENSION
He is underweight by 2/3 of a pound 2/3 of a pound N/A
temperature, age)
pound UNIT TYPE
Tag UNIT to be used for the number 1100 UNIT
Tag UNIT_TYPE to be used for the unit of
measure miles UNIT_TYPE

100 UNIT
Disjointed entities 1100 miles DIMENSION
At 1100 miles the engine started going into 200 UNIT
regen mode every 100 to 200 miles. My fuel 100 to 200 miles DIMENSION
economy went from 20.8 to 9.8 mpg. miles UNIT_TYPE
20.8 to 9.8 mpg DIMENSION
20.8 UNIT

9.8 UNIT

mpg UNIT_TYPE

Do not annotate if the

UNIT_TYPE is not They had to walk many kilometers every day day
every day RECURRING day DATE DAY
associated with a numeric go to school.
value.

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2
27 UNIT
I am 27 years old 27 years old AGE N/A
UNIT + UNIT_TYPE years UNIT TYPE
At three months of age, kittens are three UNIT
physically and emotionally ready for three months AGE N/A
The age of a person, animal, or independence from their mom and siblings. UNIT TYPE
months
object.
UNIT UK GPE
4. AGE UNIT_TYPE N/A UK COUNTRY
Tag UNIT to be used for the number In the UK children normally start school after
Tag UNIT_TYPE to be used for the school ORG N/A
they turn 4.
counter 4 UNIT
Only unit 4 AGE

I own a two century old house in the two century

two century old AGE UNIT N/A
countryside

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

Greenland STATE
Greenland GPE
Include the minus sign for In Greenland, the mean temperature is
-40 UNIT N/A
negative values probably -40°F reduced to sea-level.
-40°F TEMPERATURE
°F UNIT_TYPE

Any value expressing a temperature

and the unit of measure used (F, 1.5 UNIT
Celsius, etc.).
UNIT 1.5 degrees Celsius TEMPERATURE
5. TEMPERATURE UNIT_TYPE N/A degrees Celsius UNIT_TYPE
Tag UNIT to be used for the number 14 percent PERCENTAGE
14 UNIT
Tag UNIT_TYPE to be used for the unit of At 1.5 degrees Celsius warming, about 14
measure Simple percent of Earth's population will be exposed Earth NON-GPE
percent UNIT_TYPE N/A
to severe heatwaves at least once every five
years heatwaves EVENT
five years DURATION
once every five years RECURRING
five UNIT
five years QUANTITY
years UNIT_TYPE

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

In letters There are five of us five NUMBER five UNIT N/A

In digits 42 is the answer to all questions 42 NUMBER 42 UNIT N/A

Am I the first? first NUMBER first UNIT N/A

Any standalone number without Ordinal numbers France GPE

6. NUMBER UNIT N/A UNIT_TYPE France COUNTRY
France is the second economy of the
second NUMBER
European Union.
second UNIT
European Union ORG
half NUMBER half UNIT
Numeric expressions Half of the money is for you, half is for me. N/A
half NUMBER half UNIT

First, you have to eat. N/A N/A N/A

Do not annotate when a
number does not refer to a
quantity If you are a business or professional user, visit
the Apple Store for Business or call 0800 058 Apple ORG N/A N/A
2222.

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span of TAG 1 TAG 2 TAG 3
equal selection equal selection
text
after TAG 1 after TAG 2

20 UNIT
I bought 20 apples and placed them in a QUANTITY
20 apples N/A
basket on the table.
apples UNIT_TYPE

Things quantified in numbers that do Ten people QUANTITY Ten UNIT

not fall into any of the categories above. Objects, people, etc. Ten people attended the meeting. N/A
meeting EVENT people UNIT TYPE
dozen roses QUANTITY dozen UNIT
NOTE: The indefinite article "a/an"
should NOT be annotated as QUANTITY roses PRODUCT roses UNIT_TYPE
unless it clearly gives an answer to the
UNIT question "how many" (please refer to I went to the market and bought a dozen half a dozen QUANTITY half a dozen UNIT
General Rules tab for more examples) roses, half a dozen eggs, and a pair of N/A
7. QUANTITY N/A
UNIT_TYPE shoes. eggs PRODUCT eggs UNIT_TYPE
QUANTITY should not be used for
standalone numbers. Standalone pair of shoes QUANTITY pair UNIT
numbers should be tagged as NUMBER.
shoes PRODUCT shoes UNIT_TYPE
Tag UNIT to be used for the number
Tag UNIT_TYPE to be used for the 1/3rd UNIT
I owed him 1/3rd of his money. 1/3rd of his money QUANTITY N/A
counter
money UNIT TYPE
Disjointed entity England COUNTRY
It has been said that in England there were England GPE
no fewer than 200 such establishments 200 UNIT N/A
that met a growing social need. 200 such establishments QUANTITY
establishments UNIT TYPE
New York CITY
New York GPE
Combined with DURATION I lived in New York for 3 years 3 UNIT N/A
3 years QUANTITY
DURATION years UNIT TYPE
 Entity Class LOCATION
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or
DEFINITION TYPES EXAMPLES
Largest span TAG 1 TAG 2 TAG 3
equal selection equal selection
of text
after TAG 1 after TAG 2

$ UNIT_TYPE
$35 dollars CURRENCY
35 UNIT
I spent $35 dollars in Toronto on taxis to
Toronto GPE N/A
get to the meeting.
dollars UNIT_TYPE
meeting EVENT
Toronto CITY
Simple Blazes EVENT

wildfires EVENT California STATE

Blazes could pump a record amount of
climate-warming CO2 into the atmosphere,
California GPE Turkey COUNTRY N/A
with wildfires also plaguing California,
Turkey and Canada.
Turkey GPE Canada COUNTRY
COUNTRY
Names of countries, villages, cities, Canada GPE
STATE states, provinces, prefectures, and other
1. GPE N/A
forms of municipalities. Barcelona GPE Barcelona CITY
Tag2 STATE applies to
CITY
administrative regions within a Barcelona is the capital and largest city of
Catalonia GPE Catalonia STATE
Country. The name may vary the autonomous community of Catalonia,
N/A
depending on the country (i.e. as well as the second most populous
second NUMBER second UNIT
community, region, prefecture, municipality of Spain.
etc.)
Spain GPE Spain COUNTRY

Do not annotate generic words

like "city", "village", "world". Only Hum GPE Hum CITY
Hum in Croatia is considered the smallest
the specific mentions of cities N/A
village in the world.
and villages should be Croatia GPE Croatia COUNTRY
annotated.

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span TAG 1 TAG 2 TAG 3
equal selection equal selection
of text
after TAG 1 after TAG 2

Mount Everest NON-GPE

Mount Everest, located in Nepal and Nepal GPE Nepal COUNTRY

China, is usually said to be the highest N/A
mountain on Earth. China GPE China COUNTRY

Earth NON-GPE

Lake Baikal NON-GPE

Lake Baikal in Russia is the world's deepest
Russia COUNTRY N/A
lake
Russia GPE
Natural locations

Bondi Beach NON-GPE

Bondi Beach is a popular surf spot in
N/A N/A
Oceania.
Oceania NON-GPE

Location names - celestial bodies, stars, Kashmir Valley NON-GPE

continents, mountains, oceans, coasts, The Kashmir Valley, also known as the Vale Kashmir GPE Kashmir STATE
rivers, lakes, borders, districts of Kashmir, is an intermontane valley in Vale of Kashmir NON-GPE
2. NON-GPE N/A N/A Kashmir, India India GPE India COUNTRY
Ex. the Mississipi River, Europe, Brighton Kashmir, India LOCATION
Beach, Long Island, the Sun, Greenwich
Village are all examples of NON-GPE.
Sun NON-GPE
The Sun is always shining on half the Moon.
Moon NON-GPE
Celestial bodies This means there is no dark side of the
N/A N/A
Moon, just a side facing away from the
Moon NON-GPE
Earth.
Earth NON-GPE
Greenwich Village NON-GPE

Lower Manhattan in LOCATION

New York City

Greenwich Village is a neighborhood on Lower Manhattan NON-GPE

the west side of Lower Manhattan in New
York City, bounded by 14th Street to the New York City GPE
Districts or specific locations New York City CITY N/A
north, Broadway to the east, Houston Street
to the south, and the Hudson River to the 14th Street FACILITY
west.
Broadway FACILITY

Houston Street FACILITY

Hudson River NON-GPE

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span TAG 1 TAG 2 TAG 3
equal selection equal selection
of text
after TAG 1 after TAG 2

October MONTH

Statue of Liberty FACILITY 28 DAY

October 28, 1886 DATE 1886 YEAR

The Statue of Liberty was dedicated on
October 28, 1886, designated as a National
1924 DATE 1924 YEAR N/A
Monument in 1924 and restored for her
centennial on July 4, 1986.
centennial EVENT July MONTH
Buildings, airports, stations,
infrastructures (bridges and July 4, 1986 DATE 4 DAY
streets), monuments, oil fields,
golf courses, zoos, shopping 1986 YEAR
centers, etc.)
Naturally, visiting Abbey Road is still a
Abbey Road FACILITY
popular tourist activity.

Beijing Capital FACILITY

International Airport
Beijing CITY
Beijing Capital International Airport is the N/A
primary international airport serving Beijing. Beijing GPE
Beijing CITY
Beijing GPE

Lalu Yadav PERSON

3. FACILITY N/A N/A Names of man-made structures
Delhi AIIMS FACILITY
Ailing Lalu Yadav was shifted to Delhi Delhi CITY
AIIMS from Ranchi Hospital after his Delhi GPE N/A
Public organizations - schools, condition deteriorated. Ranchi CITY
universities, charities, museums, Ranchi Hospital FACILITY
libraries, hospitals, etc. -
whenever their location is a Ranchi GPE
relevant part of the context.
Harvard University FACILITY
If location is not relevant, flag it
only as ORG. Please see the United States COUNTRY
United States GPE
ORGANIZATION tab to compare Harvard University is the oldest institution Cambridge CITY
examples. of higher learning in the United States and Cambridge GPE
Charles River NON-GPE
its campus lies along the Charles River in Massachusetts STATE
Flagging these entities both as Cambridge, Massachusetts, a few miles west Massachusetts GPE
Cambridge, LOCATION
FACILITY and ORG is also of downtown Boston. Boston CITY
Massachusetts
acceptable if you are unable to Boston GPE
determine if the focus is on the
downtown Boston NON-GPE
location or on the organization.
Sydney CITY
Sydney GPE
Sydney Opera House FACILITY
Sydney CITY
The Sydney Opera House is a multi-venue Sydney GPE
Sydney GPE
performing arts center in Sydney, New
New South STATE
South Wales, Australia. New South Wales GPE
Sydney, New South Wales
Wales, Australia LOCATION
Australia GPE
Australia COUNTRY

ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span TAG 1 TAG 2 TAG 3
equal selection equal selection
of text
after TAG 1 after TAG 2

123 UNIT
John
PERSON
Main Street FACILITY
123 Main Street, New
LOCATION New York CITY
Full address John posted a parcel at 123 Main Street, York, NY 10030
New York GPE
New York, NY 10030.
NUMBER NY STATE
123
NY GPE
NUMBER
10030
10030 UNIT
Como GPE Como CITY
Lake Como NON-GPE
Lecco GPE Lecco CITY
Lake Como is in the provinces of Como
provinces of Como and LOCATION
and Lecco in Lombardy, Northern Italy
Lecco in Lombardy, Lombardy GPE Lombardy STATE
Northern Italy
Italy GPE Italy COUNTRY
Combinations of GPE/NON- meeting EVENT Ramada Plaza Hotel FACILITY
GPE/FACILITY The meeting will be held at the Ramada
Plaza hotel in the Garden district of Ramada Plaza hotel in LOCATION Garden District NON-GPE Toronto CITY
To be used for full address, combinations Toronto. the Garden district of
COUNTRY
GPE of smaller units of GPE/ NON_GPE/ Toronto Toronto GPE
4. LOCATION STATE
FACILITY, if present, and relative Oracle office FACILITY
CITY
locations.
Going for a walk in park nearby the Oracle Oracle office in
LOCATION Oracle ORG Redwood City CITY
office in Redwood City. Redwood City
Redwood City GPE
Spain GPE

Southern Spain LOCATION April MONTH

This incredible ski resort in southern Spain
Regional and subregional areas Spain COUNTRY
will stay open until April 18th 2022.
April 18th 2022 DATE 18th DAY

2022 YEAR

Prussia LOCATION
Prussia was a feudal state, later a kingdom, START
and finally a republic in Central Europe Central Europe NON-GPE early modern times DURATION 1945 YEAR
Fictional and historical places existing from early modern times to 1945.
early modern times to INTERVAL END
1945 1945 DATE
Middle Earth is the fictional world that the
Middle Earth LOCATION N/A N/A
characters of the Lord of the Rings reside in.
 Entity Class PERSON
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span of
text
equal selection equal selection TAG 1 TAG 2 TAG 3
after TAG 1 after TAG 2

Call Dave from accounting Dave PERSON N/A N/A

First name only John PERSON
Mr. John is on his way to home N/A N/A
home FACILITY

Brown PERSON
Dr. Brown lives in London London CITY N/A
London GPE
Last name only
Smith PERSON
Mrs. Smith went to the mall yesterday yesterday DAY N/A
yesterday DATE

Joseph Robinette Biden

PERSON N/A N/A People's names Jr. PERSON
Joseph Robinette Biden Jr. is an American 46th UNIT
Full Name politician who is the 46th and current N/A
46th NUMBER
president of the United States United States COUNTRY
United States GPE
one UNIT
Every time Pinocchio tells a lie, his nose Pinocchio PERSON
N/A
grows one inch longer.
Fictional names or religious inch UNIT_TYPE
one inch DIMENSION
figures
Jesus PERSON
Jesus died at 33. 33 UNIT N/A
33 AGE
Charles III PERSON
King Charles III took over the throne
Do not annotate roles, titles,
following the death of Her Majesty Queen death EVENT N/A N/A
and honorifics.
Elizabeth II.
Elizabeth II PERSON
 Entity Class ORGANIZATION
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span of
text
equal selection equal selection TAG 1 TAG 2 TAG 3
after TAG 1 after TAG 2

Apple Inc. ORG

Apple Inc. today announced a number of
today DAY N/A
changes coming to the App Store.
today DATE
Names of companies Jeff Bezos PERSON
Jeff Bezos, Blue Origin Crew, launch Into
Blue Origin ORG
Space.
Space NON-GPE

United States GPE

United States Congress ORG

The United States Congress is the
federal government ORG
bicameral legislature of the federal United States COUNTRY
government of the United States and N/A
United States GPE
consists of the House of Representatives United States COUNTRY
and the Senate.
House of the ORG
Politics - government agencies, Representatives
political parties, terrorist
organizations, government Senate ORG
bodies (ministries, councils,
courts, political unions of
countries.)
WHO ORG

first NUMBER
WHO is hosting the first global gathering of
leaders focusing exclusively on health in first UNIT N/A
gathering EVENT
Small Island Developing States.
Small Island Developing ORG
States

1636 DATE
Dating back to 1636, Harvard University is 1636 YEAR
Companies, political bodies, regarded as one of the most prestigious in Harvard University ORG N/A
ORG N/A N/A
sport or cultural institutions, etc the world. one UNIT
Public organizations - schools, one NUMBER
universities, charities, museums,
libraries, hospitals, etc. 1.4 million UNIT

If the entities come with details Mayo Clinic ORG people UNIT_TYPE
about their location, they should
be flagged as FACILITY. 1.4 million people QUANTITY year DATE
Mayo Clinic cares for more than 1.4 million
Flagging these entities both as each year RECURRING 50 UNIT
people each year with serious or complex
FACILITY and ORG is also year YEAR
illnesses from all 50 U.S. states and 140
acceptable if you are unable to 50 U.S. states QUANTITY U.S. states UNIT_TYPE
countries.
determine if the focus is on
location or on the organization. U.S. GPE U.S. COUNTRY

140 countries QUANTITY 140 UNIT

countries UNIT_TYPE
Auckland Symphony ORG
Orchestra
Music - musical companies, Auckland CITY
The Auckland Symphony Orchestra is New
bands, choirs, opera companies, N/A
Zealand’s largest community orchestra. Auckland GPE
orchestras, etc. New Zealand COUNTRY
New Zealand GPE
World Cup EVENT
World Cup event is organized by the sport's
governing body, the International Cricket N/A N/A
International Cricket
Council (ICC)
Council (ICC) ORG
Sport - team names , city names January of 2018 DATE
referring to a sport team, sport
governing bodies In January of 2018, Barcelona made
Barcelona ORG January MONTH
Liverpool an offer that they couldn't refuse
N/A
for the Brazilian playmaker Philippe
Liverpool ORG 2018 YEAR
Coutinho.
Philippe Coutinho PERSON
Do not annotate the generic
terms "organization" or The company closed down. N/A N/A N/A
"company".
 Entity Class PRODUCT
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span of
text
equal selection equal selection TAG 1 TAG 2 TAG 3
after TAG 1 after TAG 2

iPhone 13 PRODUCT
I bought iPhone 13 last night. N/A N/A
last night TIME
Craft PRODUCT
₹ UNIT_TYPE
Nike Air Force 1 '07 Craft costs around
Nike ORG N/A
₹10,300.
10,300 UNIT
₹10,300. CURRENCY
Intel Celeron processor PRODUCT
The device is powered by an Intel Celeron
N/A N/A
processor.
Intel ORG
Product Names with brand PRODUCT
names Covaxin

India GPE

NUMBER
Covaxin is India’s first indigenous COVID-19 first
India COUNTRY
vaccine developed by Bharat Biotech in
COVID-19 vaccine PRODUCT N/A
collaboration with the Indian Council of
first UNIT
Medical Research (ICMR).
Bharat Biotech ORG

Indian Council of ORG

Medical Research
(ICMR)
nut PRODUCT
Any product or service that can The contents of the nut are edible as in the
N/A N/A
PRODUCT N/A N/A be purchased or consumed as a coconut.
coconut PRODUCT
whole or as a part of a whole.
toothpastes PRODUCT

sunscreens PRODUCT
Generalized products without
brand names Health Products Framework include
toothpastes, sunscreens, contact lens contact lens solution PRODUCT
N/A N/A
solution, pain relievers, antiperspirants
and disinfectants. pain relievers PRODUCT

antiperspirants PRODUCT

disinfectants PRODUCT
100% PERCENTAGE 100 UNIT
I wish there was a 100% effective cancer
Products that do not exist yet N/A
vaccine.
cancer vaccine PRODUCT % UNIT_TYPE
$200 CURRENCY $ UNIT_TYPE
I paid $200 for a haircut and it is so bad. N/A
haircut PRODUCT 200 UNIT
Mental Health Matters ORG
Services (MHM)
Mental Health Matters (MHM) offers a
telephone counseling service and talking telephone counseling PRODUCT N/A N/A
therapies in some areas. service

talking therapies PRODUCT

Do not annotate the generic
This product sells out fast. N/A N/A N/A
term "product".
 Entity Class EVENT
ANNOTATION
TAG 1 TAG 2 TAG 3

Shorter or Shorter or DEFINITION TYPES EXAMPLES

Largest span of
equal selection equal selection TAG 1 TAG 2 TAG 3
text
after TAG 1 after TAG 2

START
1700
Third Maratha War EVENT DATE 1700 YEAR
Third Maratha War was fought between
1700–1702.
1700-1702 INTERVAL END 1702 YEAR
1702
DATE

21 DAY
International Yoga Day EVENT 21 June DATE
International Yoga Day is celebrated on 21
June MONTH
June every year.
21 June every year RECURRING year DATE
year YEAR

Rugby World Cup EVENT

The Rugby World Cup is a men’s
N/A N/A
international tournament. men’s international
tournament EVENT

Christmas EVENT
25th DAY
DATE
Christmas is celebrated on 25th December. N/A
December MONTH
25th December DATE
The New Orleans Jazz
and Heritage Festival is
Specific event names - also one of the best
historical events, sports events, music festivals in the
national holidays, cultural events, The New Orleans Jazz and Heritage world. EVENT New Orleans CITY
educational events, festivals, Festival is also one of the best music N/A
country wide events, festivals in the world. New Orleans GPE one UNIT
international events, conferences,
seminars, community events, one NUMBER
political events, etc.
music festivals EVENT

International EVENT
Conference on 2021 YEAR
A thing that happened or will Engineering &
happen, any occasion or social International Conference on Engineering 08 MONTH Florida STATE
EVENT N/A N/A Technology (ICET-21)
gathering with some sense of time & Technology (ICET-21) was held on
attached to it. 2021-08-24 in Florida, USA. 24 DAY USA COUNTRY
2021-08-24 DATE

Florida, USA LOCATION Florida GPE

USA GPE
1970 YEAR
1970 DATE
Pakistan GPE
1970 Bhola cyclone EVENT
India GPE Pakistan COUNTRY
The 1970 Bhola cyclone was a devastating
tropical cyclone that struck East Pakistan cyclone EVENT
West Bengal GPE India COUNTRY
and India's West Bengal on November 11,
1970. East Pakistan and LOCATION
November MONTH West Bengal STATE
India's West Bengal

November 11, 1970 DATE 11 DAY

1970 YEAR
John PERSON
John hosted a birthday party at his
N/A N/A
residence.
birthday party EVENT
General events -
birthdays, parties, weddings, The Covid-19 Pandemic resulted in the loss
Covid-19 Pandemic EVENT N/A N/A
pandemic, climatic events, etc. of many lives.
wedding reception EVENT
The wedding reception had great food. N/A N/A
food PRODUCT
A purely professional event, the product
launch is in charge of promoting a new product launch EVENT N/A N/A
product.
speaker presentation EVENT
Business-related event A speaker presentation is one of the most
one UNIT N/A
common forms of B2B event marketing.
one NUMBER
A conference was held last weekend to conference EVENT
teach struggling writers how to improve weekend DATE weekend DAY
their skills. last weekend INTERVAL
Do not annotate the generic
The event was a great success. N/A N/A N/A
term "event".
 Supported Currencies Supported Date and Time Formats
Country Variants Utterances should: Quantity Templates General form Example
Contain only major unit: 10
United States Major unit: #,###.##: 123,456.00 dd-mmm-yy 28-Oct-90
dollars
Contain only minor unit: 10
US Dollar # ###,##: 1 000,25 dd-mmm-yyyy 28-Oct-1990
cents a combination of
Contain
USD major and minor unit: 10 yen #.###,##: 1.000,25 mm/dd/yy 10/28/90
10 sen
Plural units: 10 dollars, 10
$ #,##,###.##: 1,23,456.00 mm/dd/yyyy 10/28/1990
pennies, etc.
Unit before/after quantity: 10
US$ # ###.##: 12 345.00 28.10.90
dollars, $10, usd 10. dd.mm.yy
Have space/no space between
buck unit and quantity: 100usd, 100 #'###.##: 1'234'567.89 28.10.1990
dd.mm.yyyy
usd
A "/" between quantity and
Minor unit: currencyunit: 100/INR , yyddd 90301
AUD$/200 Sri Gadde.
Positive/negative quantity: -
cent yyyyddd 1990301
1000$
Major unit: yy/mm/dd 90/10/28
EURO Zone Countries:
Austria, Belgium, Cyprus, Estonia, Euro yyyy/mm/dd 1990/10/28
Finland, France, Germany, Greece, EUR q Q yy 4 Q 90
Ireland, Italy, Latvia, Lithuania, e q Q yyyy 4 Q 1990
Luxemburg, Malta, the Netherlands, € mmm yy Oct-90
Portugal, Slovakia, Slovenia, Spain Minor unit: mmm yyyy Oct-1990
cent ww WK yy 43 WK 90
Japan Major unit: ww WK yyyy 43 WK 1990
Japanese Yen (name of the day) SU
JPY (name of the month) JAN
yen hh:mm 1:02
¥ hh:mm:ss.s 02:34.7
Minor unit: mm:ss 2:34
sen mm:ss.s 02:34.7
Great Britain Major unit: dd hh:mm 28 01:02
Pound dd hh:mm:ss.s 28 01:02:34.7
Sterling dd-mmm-yyyy hh:mm 28-Oct-1990 02:34
gbp dd-mmm-yyyy hh:mm:ss.s 28-Oct-1990 01:02:34.7
£ yyyy-mm-dd hh:mm 1990-10-28 01:02
Minor unit: yyyy-mm-dd hh:mm:ss.s 1990-10-28 01:02:34.7
penny yyyy 1990
China Major unit:
Renminbi
CNY
yuan
Chinese yuan
¥
RMB
Minor unit:
jiao
India Major unit:
INR
₹
Rs
Re
rupee
indian rupee
Minor unit:
paise
Canada Major unit:
Canadian Dollar
CAD
$
C$
Can$
CND$
dollar
Minor unit:
cent
South Korea Major unit:
Korea Won
won
₩
KRW
Minor unit:
jeon
Australia Major unit:
Australian Dollar
$
A$
AU$
dollar
AUD
aus dollar
Minor unit:
cent
Mexico Major unit:
Mexican Peso
MXN
$
MX$
Mex$
peso
Minor unit:
centavo
Switzerland Major unit:
Swiss Franc
CHF
Fr
SFr
franc
franken
Minor unit:
rappen
Singapore Major unit:
Singapore Dollar
SGD
$
S$
SGD$
dollar
sing-dollar
sing
Minor unit:
cent
Fr (Franc)
Other NZ$
BR$
HK$