International considerations

In non-English-speaking locales, there might be more than one local language. In your feeds, though, we require at least two languages: the primary language spoken in that location, referred to here as "the local language," and English. We ask for English for the following reasons:

  • It's likely that a number of people in that country also speak English.
  • Many of our internal systems are designed in English. If the feeds are in English as well, this makes it easier for us to troubleshoot and debug.

For example, the primary language in Japan is Japanese, so we require the data in Japanese and with English translations. However, if a candidate or party doesn't have official names in English (or the local language), don't add your own English (or local language) translations. We only accept official names both in English and the local language.

In countries where there are multiple local languages, we need at least the primary local language first. If the official names are available in any additional languages, you can then provide those names.

Content in English

All single-string Name fields, such as Party, need to be in English. All InternationalizedText fields need to include a Text instance with an English language translation or transliteration. These include, but aren't limited to, the names for the following entities:

  • Contests
  • Office and ReportingUnit
  • Party and Coalition
  • Person and Candidate


Abbreviations, when allowed or required, must be abbreviated in the local language. For example, the Worker's Party in Brazil would have Name values in English and Portuguese, but the InternationalizedAbbreviation field would be set to PT, for "Partido dos Trabalhadores."

Local language content

Provide translations for the names of the following entities in the local language:

  • Party And Coalition (+ Slogan)
  • Contest
  • GpUnit
  • Person (FullName)
  • Office

Don't include local translations of candidate names or the names of other people unless those translations represent a transliteration into a different character set. For example, for Japanese Prime Minister Shinzo Abe, include the Person FullName element like the following:

  <Text language="en">Shinzo Abe</Text>
  <Text language="ja">安倍晋三</Text>