Help:Tabular Data

Tabular data allows users to create CSV-like tables of data, and use them from other wikis to create automatic tables, lists, and graphs.

To create a new table, go to Wikimedia Commons, and create a new page in the Data namespace with a .tab suffix, such as. For now, page content can only be edited in the raw JSON format. Eventually, we hope there will be a spreadsheet-like editor to simplify data editing.

Data types
Tabular JSON data supports several basic value types:
 * - A numeric value with an optional fractional part and may use exponential E notation, but cannot include non-numbers like NaN.
 * - only allows  and   values.
 * - a text string no longer than 400 characters long. Special characters like new lines  and tabs   are not allowed.
 * - A multilingual string, represented as an object with keys being language codes (e.g. "en"), and values being a string with above limitations of 400 max chars. For example,  has string values for both English and French.

Top-level fields
Tabular data has several required and optional top-level elements:
 * The required  field must always be set to   string value. For now, tabular data only supports CC0 (Public Domain dedication) license. More license support may be available in the future.
 * The optional  field must be set to a localized string value - an object with at least one key-value, where the key is a language code (e.g. "en"), and the value is a description string.
 * The optional  field must be a Wiki markup string value that describes the source of the data.
 * The required  field must be set to a list of unique strings. Each header must begin with a letter or an underscore , and must only contain letters, underscores, or digits. This is done so that each header can be easily used from a coding environment like Lua or Vega graphs.
 * The optional  field is an optional translation for each column's header. If set, it must be a list of localized string objects. Must have the same number of list elements as the "headers" field. The list must be the same size as the list of.
 * The required  field must be a list of types, each type being either ,  ,  , or  . The list must be the same size as the list of.
 * The required  field must always be set to a list of lists. Each sub-list must have the same number of elements as headers, and must mach the value types.

Usage
There are two ways to use this data:
 * A Lua script on any wiki can get this data by calling . The function returns tabular data in almost the same format as the original JSON, except that all localized strings will be converted to regular strings, and the license field will also include a localized license name. To get the data in another language, pass language code as the second parameter. To get the data in the original, unmodified form, use "_" as the language code.
 * A Vega graph can get tabular data by using  as the data source url.

Restrictions and gotchas

 * Each string value except the  must be no more than 400 symbols long. Special characters like new lines   and tabs   are not allowed.
 * The overall size of the page may not exceed 2MB.