Help:Table format

Jump to: navigation, search
Table format
Outputs the result in a table.
Further Information
Provided by: Semantic MediaWiki
Added: 0.4
Removed: still supported
Requirements: none
Format name: table
Enabled by default: 
Indicates whether the result format is enabled by default upon installation of the respective extension.
Authors: Markus Krötzsch
Categories: misc
Table of Contents

The result format table is used to format query results as tables. It is Semantic MediaWiki's default way of formatting query results for all queries that have one or more additional printout statements. It is almost identical to the broadtable format.



Parameter Type Default Description
source text empty Alternative query source
limit whole number 50 The maximum number of results to return
offset whole number 0 The offset of the first result
link text all Show values as links
sort list of texts empty Property to sort the query by
order list of texts empty Order of the query sort
headers text show Display the headers/property names
mainlabel text no The label to give to the main page name
intro text empty The text to display before the query results, if there are any
outro text empty The text to display after the query results, if there are any
searchlabel text ... further results Text for continuing the search
default text empty The text to display if there are no query results
  • The parameter "headers=hide" is specifically useful for hiding the header of tables (in most other cases, it is enough to use empty printout labels to hide the titles of printout statements).

Format specific

Parameter Type Default Description
class text sortable wikitable smwtable An additional CSS class to set for the table
transpose yes/no no Display table headers vertically and results horizontally
sep text empty The separator for values
Important noteImportant Note:
  • Semantic MediaWiki 3.0.0 introduced a set of predefined classes supporting a datatable output1 which allows to search the table and to display more results without bloating the display of the table on the wiki page.23. Possible options for parameter "class" are: datatable, datatable compact, datatable cell-border or the combination datatable compact cell-border.4. This class makes use of the "DataTables" table plug-in for jQuery5.
  • Using these classes produces a basic output as offered by the "Datatables" result format provided by the "Semantic Result Formats" extension which also makes use of the "DataTables" table plug-in for jQuery. The latter is however more powerful in its usage.2


Tables have a special feature for sorting their contents by any of the columns in the table. See Selecting pages for general comments on sorting and a comparison to the wiki's query result sorting. Browsers without JavaScript enabled will not see the buttons for sorting at all.


 [[Located in::Germany]] 
 |?Area#km²=Size in km²

This produces the following output:

CityPopulationSize in km²
Berlin3,520,061891.85 km²
344.343 sqmi
Munich1,353,186310.43 km²
119.857 sqmi
Frankfurt679,664248.31 km²
95.872 sqmi
Stuttgart606,588207.36 km²
80.062 sqmi
More examples

Applying CSS formatting

As of Semantic MediaWiki 1.6.2 the native MediaWiki sortable tables are used. Thus this format now provides several ways for custom formatting to be applied to tables:

  • One or more overall CSS classes can be set for the table, using the "class=" parameter.
  • Each column in the table gets a class name that derives from the column name. For instance, if a column is titled "Capital city", the column's class will be "Capital-city".
  • Rows in the table each get either the class "row-odd" or "row-even", depending on whether the row is odd or even.

In this way, specific formatting, like colors and font sizes, can be set across a single table, or for a specific column, or can be set for alternating rows. The recommended way to set any custom CSS in the wiki is by modifying the page "MediaWiki:Common.css".

Example for alternating row colours

The example below will result in the display of alternating rows.

/* even and odd in tables */
.smwtable .row-even {
    background-color: #fff;
.smwtable .row-odd {
    background-color: #cde6ea;

Data value type attributes

Semantic MediaWiki 1.9.0 introduces type related attribution allowing to apply specific formatting rules based on the datatype uses (data value types like "_dat", "_num" etc.) used in a column.6

The class attribute is a concatenated string that includes "smwtype" + "datavalue typeId" resulting in "smwtype_dat" for the data value of datatype "Date". If you want all numeric representations (prerequisite is that the property selected for display is of datatype "Number") in a table to be formatted on the right side, you would need to add:

/* DataValue type formatting */
.smwtable .smwtype_num {
    text-align: right;


This documentation page applies to all SMW versions from 1.6.2 to the most current version.
Other versions: 0.4 – 1.6.1       Other languages: defrzh-hans

Help:Table format en 1.6.2


  1. ^  Semantic MediaWiki: GitHub pull request gh:smw:2420
  2. a b  Semantic MediaWiki: GitHub issue comment gh:smw:2420:294453317
  3. ^  Semantic MediaWiki: Sandbox example sb:smw:2420:1
  4. ^  Semantic MediaWiki: Sandbox example sb:smw:2420:2
  5. ^  " - A tables plug-in for jQuery.
  6. ^  Semantic MediaWiki: Gerrit commit gerrit:smw:53520