Template:Infobox company/doc
This is a documentation subpage for Template:Infobox company. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 86,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
- ISIN (P946) (see uses)
- industry (P452) (see uses)
- logo image (P154) (see uses)
- follows (P155) (see uses)
- followed by (P156) (see uses)
- inception (P571) (see uses)
- founded by (P112) (see uses)
- dissolved, abolished or demolished date (P576) (see uses)
- headquarters location (P159) (see uses)
- country (P17) (see uses)
- total revenue (P2139) (see uses)
- point in time (P585) (see uses)
- operating income (P3362) (see uses)
- net profit (P2295) (see uses)
- total assets (P2403) (see uses)
- employees (P1128) (see uses)
- parent organization (P749) (see uses)
- official website (P856) (see uses)
This template is used to create an infobox in an article about a company.
Usage
[[File:{{{logo}}}|{{{logo_size}}}|alt={{{logo_alt}}}|upright=1]] | |
[[File:{{{image}}}|{{{image_size}}}|alt={{{image_alt}}}|upright=1]] | |
trade_name | |
Native name | native_name |
Romanized name | romanized_name |
Formerly | former_name |
Company type | type |
traded_as | |
ISIN | ISIN |
Industry | industry |
Genre | genre |
Predecessor | predecessor or predecessors |
Founded | founded |
Founder | founder or founders |
Defunct | defunct |
Fate | fate |
Successor | successor or successors |
Headquarters | hq_location, hq_location_city , hq_location_country |
Number of locations | num_locations (year) |
Area served | area_served or areas_served |
Key people | key_people |
Products | products |
Production output | production (year) |
Brands | brands |
Services | services |
Revenue | revenue (year) |
operating_income (year) | |
net income or profit (year) | |
AUM | aum |
Total assets | assets (year) |
Total equity | equity (year) |
Owner | owner or owners |
Members | members (year) |
Number of employees | num_employees (year) |
Parent | parent |
Divisions | divisions |
Subsidiaries | subsid |
module | |
Capital ratio | Basel III ratio |
Rating | Credit rating |
Website | website |
Footnotes / references footnotes |
To use this template in an article, copy the template below, then paste the template into an article.
All parameters are optional. For some parameters, blank parameter values will be supplied via Wikidata, if data is available for that parameter. Those parameters are indicated below with the text "Fallback Wikidata item". Local values provided for parameters will always override available Wikidata parameter values. Parameters without either local or Wikidata values will not be displayed in the infobox.
A note on special handling of some parameters with respect to Wikidata:
- If any location-related parameters are present in the article's infobox, no location-related information from Wikidata will be displayed.
- If either
|owner=
or|parent=
have a value in the article's infobox, neither of those parameter's Wikidata values will be displayed.
You must remove the hidden notes (both the <!--
and -->
characters) that surround certain entries in order for the data you enter to appear in the published article.
Short version
Full version
Parameters
- name
- The full, legal name of the company, correctly reproducing punctuation and abbreviations or lack thereof. The full legal name of the company may be different from the common name used for the article title.
- logo
- The company's current, primary wordmark or logo. Use the logo of the entity that is the subject of the article; the logo used may be different from the logo used on consumer products, particularly if the article is about a parent company or holding company.
- Fallback Wikidata item: logo image (P154)
- For companies that use both a wordmark and a logo, upload a file that shows the two in combination if the combined form serves as the company's primary identity mark.
- For a wordmark example, see Google; for a logo example, see Apple Inc.; for a combined logo and wordmark example see Altria.
- Upload a wordmark/logo graphic using the organization logo upload form.
- Note: Uploading trademarked corporate logos by other means or uploading corporate logos to Wikimedia Commons is likely to result in deletion of the logo.
- Format:
logo.png
- logo_size
- Optional display width of the logo in pixels. If not specified, the size varies by user preferences.
- logo_upright
- Allows logo to be scaled by a multiplier of the user's set preference. The default multiplier is one (1).
- logo_alt
- Optional verbal description of the logo for text-only browsers and visually impaired users.
- logo_caption
- Descriptive information for the logo, if necessary.
- Example:
- Logo used from 1942 to 1966
- image
- An optional second image.
- image_size
- Optional display width of the image in pixels.
- image_upright
- Allows image to be scaled by a multiplier of the user's set preference. The default multiplier is one (1).
- image_alt
- Optional verbal description of the image for text-only browsers and visually impaired users.
- image_caption
- Descriptive information for the image, if necessary.
- trade_name
- Trade name, doing business as, d/b/a or fictitious business name under which a company presents itself to the public. This parameter is used only when the company has a legally registered trade name that is different from the company's full, legal name.
- Example:
- "Cellco Partnership" is the full, legal name of the company that trades as "Verizon Wireless". This template's name parameter would, therefore, be set as Cellco Partnership, while its trade_name parameter would be set as Verizon Wireless.
- native_name
- The full, legal non-English name of the company as it appears in the company's home country language, reproducing any punctuation or abbreviations. For Chinese and Korean names' syntax, see the "Embedding" section below.
- Examples:
- ETA SA Manufacture Horlogère Suisse
- Нефтяная компания ЮКОС
- romanized_name
- Native name in Latin script. Use only if the company is based in a non-English speaking country and it has no official rendering of its native name in Latin script. If such a rendering exists, assign it to native_name and omit this parameter.
- former_name
- Former names, if a rebranding had occurred in the past.
- type
- Type of ownership in the company (not their legal form of incorporation), wiki-linked where appropriate. To list percentages owned of a private company, use the ownership parameter.
- Available types:
[[Privately held company|Private]]
[[Public company|Public]]
[[Subsidiary]]
[[Division (business)|Division]]
- traded_as
- If applicable, the primary stock exchange where the company's stock is listed, followed by that exchange's stock ticker symbol/symbols for the company (use stock ticker templates where possible; see Category:Ticker symbol templates). Information about the company's status as a component of a major index can also be added. If more than one symbol or index is involved, use
{{Unbulleted list}}
to format them. - Examples:
{{NYSE|DLB}}
{{Unbulleted list|{{NASDAQ|MSFT}}|[[Dow Jones Industrial Average]] component|[[NASDAQ-100]] component|[[S&P 500]] component}}
- ISIN
- International Securities Identification Number.
- Fallback Wikidata item: ISIN (P946)
- industry
- The primary industry or industries in which the company operates, listed alphabetically. If the company offers goods or services in more than one industry, format the list using
{{Unbulleted list}}
. - Fallback Wikidata item: industry (P452)
- Examples:
- Appliance manufacturing
{{Unbulleted list|[[Electronics design]]|[[Electronics distribution]]|[[Entertainment industry]]}}
- genre
- Used for media or publishing companies – Genres of works published by the company, listed alphabetically and wiki-linked where appropriate. If publishing is the company's primary activity, consider using
{{Infobox publisher}}
rather than this template. - If more than one entry is required here, use
{{Unbulleted list}}
to format the list. - Examples:
[[Fiction]]
{{Unbulleted list|[[Biography|Biographies]]|[[Science fiction]]|[[Western fiction|Westerns]]}}
- The field or subset of the industry the company occupies, e.g. Industry is restaurants, the genre is fast food
- predecessor
- (or predecessors) The name(s) of any predecessor(s) of the company. If the company has two or more predecessors, list them alphabetically using
{{Unbulleted list}}
. - Fallback Wikidata item: follows (P155)
- Examples:
- Apple Inc.
{{Unbulleted list|[[C. L. Best]]|[[Holt Manufacturing Company]]}}
- founded
- Date and location of the company's establishment/foundation. For date, use
{{Start date and age}}
. For the location, use a format such as [[City]], Country Add the state/province/territory for cities in the US and Canada where required by WP:USPLACENAMES and avoid linking the country per MOS:OVERLINK. Per MOS:INFOBOXFLAG, do not include flag icons. - Fallback Wikidata item: inception (P571)
- Examples:
{{Start date and age|1975|04|27}} in [[Teaneck, New Jersey]], United States
{{Start date and age|1925|12|02}} in [[Malmö]], Sweden
- founder
- (or founders) The founder/entrepreneur/s who founded the company, wiki-linked if notable. If more than one person, use
{{Unbulleted list}}
to format the entries. - Fallback Wikidata item: founded by (P112)
- Examples:
- Thomas Oliver
{{Unbulleted list|[[Paul Allen]]|[[Bill Gates]]}}
- defunct[a]
- The year (or, more specifically, if known, the date) the company became defunct/legally dissolved. Use
{{End date}}
. - Fallback Wikidata item: dissolved, abolished or demolished date (P576)
- Examples:
{{End date|2000}}
{{End date|1936|06|30}}
- fate[a]
- Reason(s) the company became defunct, or the name of the entity that acquired or merged with it.
- Examples:
Acquired by [[Cisco Systems]]
Bankrupted
Dissolved
Merged with [[Thompson Corporation]]
- successor[a]
- (or successors) The name(s) of any successor(s) of the company. If the company has two or more successors, list them alphabetically using
{{Unbulleted list}}
. - Fallback Wikidata item: followed by (P156)
- Examples:
[[Apple Inc.]]
{{Unbulleted list|[[The People's Corporation of Judea]]|[[Splitters, Inc.]]}}
- hq_location
- hq_location_city
- hq_location_country : City (for cities in the US and Canada, with the state/province/territory where required by WP:USPLACENAMES) and country of the company's headquarters location. If using hq_location_city or hq_location_country, reserve hq_location for the building, address, or business park, if these are themselves notable. Also maintain MOS:OVERLINK and MOS:INFOBOXFLAG.
- Fallback Wikidata items: headquarters location (P159) and country (P17)
- Examples:
| hq_location_city = [[Redmond, Washington]]
| hq_location_country = United States
| hq_location_city = [[Nuremberg]]
| hq_location_country = Germany
- num_locations
- Number of places at or in which the company has a [visible, public?] presence. Include the type of place (e.g. "store", "outlet") if the same for most/all instances.
- Examples:
- 815 stores
{{Unbulleted list|456 outlets/concessions|8 depots}}
- num_locations_year
- The year associated with the data presented by num_location. This only appears (as a parenthesis appended to num_locations' label) if/when num_locations also supplied.
- area_served
- (or areas_served) Geographic area or areas in which the company does business. Use the largest appropriate geographic area or areas (e.g. if a company trades in nearly every province in Canada, use e.g.
|area_served=Most of Canada
rather than listing every province). If more than one entry is required, use{{Unbulleted list}}
to present them alphabetically; and avoid wiki-linking any area or location name already linked in previous parameters. - Examples:
- Worldwide
- North America
[[New York metropolitan area]]
{{Unbulleted list|[[Contiguous United States|United States (contiguous)]]|[[Puerto Rico]]|[[United States Virgin Islands]]}}
- key_people
- Up to four key individuals closely associated with the company. If there is more than one entry, use
{{Unbulleted list}}
to format the entries. List the figures in order of organizational role importance. Give job title(s) in parentheses (round brackets); these job titles use standard English casing. If a founder is already listed in thefounder
parameter, do not list them again here as a founder; if the founder still holds an executive job with the company, you may, however, list them along with their job title (chairman, president, etc.). - Generally list prominent, current executives within the company holding key positions such as chairman, chief executive officer, president, VP of design, etc., but do not list roles below chief officer level if they are not notable. Do include top executives even not individually notable, but do not wiki-link them.
- Use popular names rather than formal names if the key figure has an existing Wikipedia article.
- For defunct companies, list the most prominent former executives.
- Example:
{{Unbulleted list|[[Tim Cook]] ([[Chief executive officer|CEO]])|[[Arthur D. Levinson]] ([[chairman]])|[[Jonathan Ive]] ([[Senior vice-president|SVP]] of [[industrial design]])|[[Steve Jobs]] (chairman, 1976–1985, 2011; CEO, 1997–2011)}}
- products
- A representative selection of the company's well-known current or former products, listed alphabetically. If there is more than one entry, use
{{Unbulleted list}}
to format the entries. - Examples:
{{Unbulleted list|[[Microsoft Windows]]|[[Microsoft Office]]}}
{{Unbulleted list|[[Bentley Continental Flying Spur|Continental Flying Spur]]|[[Bentley Continental GT|Continental GT]]|[[Bentley Mulsanne (2010)|Mulsanne]]}}
- production
- The number of units produced in the most recent year and the year prior, stating the year in parentheses. Indicate what is being measured, such as vehicles, units or devices. You may include an indicator icon to indicate the change compared to the previous year; to avoid confusion, place the indicator before the number. Note that this is intended to depict the direction of change compared to the previous year, not the actual numerical change in value.
- Example:
{{Unbulleted list|class=nowrap|{{Increase}} 2,856 vehicles (2011)|2,177 vehicles (2010)}}
- production_year
- The year associated with the data presented by production. This only appears (as a parenthesis appended to production's label) if/when production also supplied.
- brands
- Any significant brand names/imprints/etc. used by the company that differ from its name. If more than one, list using
{{Hlist}}
. - Examples:
[[...]]
{{Hlist|[[...]]|...}}
- services
- A representative selection of the company's well known current or former services offered, listed alphabetically. If there is more than one entry, use
{{Unbulleted list}}
to format the entries. - Example:
{{Unbulleted list|[[Financial services|Financing]]|[[Insurance]]|[[Maintenance, repair and operations|Maintenance]]|[[Training]]}}
- revenue
- All income that the company receives from its normal business activities, usually from the sale of goods and services to customers in the most recent year and the year prior, indicating the years in parentheses. (Revenue is referred to as "turnover" in the United Kingdom.) Wiki-link the currency unit and indicate country for common currency units like "dollar".
- Fallback Wikidata item: total revenue (P2139)
- Example:
{{Unbulleted list|class=nowrap|{{Increase}} US$512,256,128,064 (2011)|US$412,552,687,117 (2010)}}
- revenue_year
- The year associated with the data presented by revenue. This only appears (as a parenthesis appended to revenue's label) if/when revenue also supplied.
- operating_income
- Total earnings before interest and taxes recognized by the company in its most recent fiscal year and the year prior, with the applicable years in parentheses.
- Fallback Wikidata item: operating income (P3362)
- Example:
{{Unbulleted list|class=nowrap|{{Decrease}} US$256,128,064,032 (2011)|US$382,456,778,010 (2010)}}
- income_year
- The year associated with the data presented by operating_income. This only appears (as a parenthesis appended to operating_income's label) if/when operating_income also supplied.
- net_income
- (or profit) Net income or profit (revenue minus costs) realized by the company in its most recent fiscal year and the year prior, with the applicable years in parentheses.
- Fallback Wikidata item: net profit (P2295)
- Example:
{{Unbulleted list|class=nowrap|{{Steady}} US$128 million (2011)|US$128 million (2010)}}
- net_income_year
- (or profit_year) The year associated with the data presented by net_income. This only appears (as a parenthesis appended to net_income's label) if/when net_income also supplied.
- aum
- The company's total assets under management (AUM) in its most recent fiscal year and the year prior, with the applicable years in parentheses.
- This entry is used for financial services companies only. If the article subject is not a financial services company, delete this parameter from the article.
- Example:
{{Unbulleted list|class=nowrap|{{Increase}} US$213.5 million (2011)|US$175.8 million (2010)}}
- assets
- Total assets controlled by the company in its most recent fiscal year and the year prior, with the applicable years in parentheses.
- Fallback Wikidata item: total assets (P2403)
- Example:
{{Unbulleted list|class=nowrap|{{Decrease}} US$64,032,016 (2011)|US$82,456,375 (2010)}}
- assets_year
- The year associated with the data presented by assets. This only appears (as a parenthesis appended to assets' label) if/when assets also supplied.
- equity
- Total equity or net worth held in the company; shareholder equity for public companies.
- Example:
{{Unbulleted list|class=nowrap|{{Increase}} US$32,016,008,004 (2011)|US$29,752,528,004 (2010)}}
- equity_year
- The year associated with the data presented by equity. This only appears (as a parenthesis appended to equity's label) if/when equity also supplied.
- owner
- (or owners) Use this parameter to list, if applicable, ownership percentages for privately held companies. Use this field for publicly traded companies only when the owner is a long-term strategic owner such as an affiliate, founder or founder's family. Wiki-link where appropriate, and include the ownership percentage and a reference. List multiple owners in descending order of ownership percentage and use
{{Unbulleted list}}
to format the entries. If the company is majority-owned by a single entity and as such is a subsidiary or division, omit the owner field and use the parent field instead. Do not use the owner field to indicate top-level ownership if it differs from the direct parent. - Fallback Wikidata item: owned by (P127)
- Example:
{{Unbulleted list|[[Richemont]] (50%)|[[Polo Ralph Lauren]] (50%)}}
- num_employees
- Total number of people employed by the company in the most recent year and the year prior, with the applicable years in parentheses. To separate thousands (e.g. 12,200; 5,200), use a comma (,) instead of a full stop (.) per MOS:NUM.
- Fallback Wikidata item: employees (P1128)
- Example:
{{Unbulleted list|class=nowrap|{{Steady}} 127 (2011)|127 (2010)}}
- num_employees_year
- The year associated with the data presented by num_employees. This only appears (as a parenthesis appended to num_employees' label) if/when num_employees also supplied.
- parent
- The name(s) of the current and former parent companies and the time-span(s) in which they owned the subject. Do not add "independent" as the parent company to designate times without a parent company. Do not include any higher-level owners, like the parents' parent companies. If the company is not majority-owned by a single entity and as such does not have a clear parent company, use the owner field with the respective owners' percentages instead.
- Fallback Wikidata item: parent organization (P749)
- Example (for YouTube):
[[Google]]
- divisions
- The primary functional or operational business divisions of a company, listed alphabetically. These divisions align with the internal organizational structure of the company and may or may not align with the company's legally incorporated subsidiaries. If there is more than one entry, use
{{Unbulleted list}}
to format the entries. If there are more than five divisions and the article body lists them or discusses them, consider linking to that part of the article rather than listing them in the infobox. - Example (fictional telecom corporation):
{{Unbulleted list|Business sales|Consumer sales|Information technologies|Network|Regulatory|Finance}}
- subsid
- The primary legally incorporated subsidiaries owned by the company, listed alphabetically. Wiki-link each subsidiary that has its unique article. For publicly traded companies, a list of subsidiaries is disclosed in the company's annual report. If there is more than one entry, use
{{Unbulleted list}}
to format the entries. If there are more than five subsidiaries and the article body lists them or discusses them, consider linking to that part of the article rather than listing them in the infobox. - Example (for Caterpillar Inc.):
{{Unbulleted list|Caterpillar Financial Services|Caterpillar Marine Power Systems|[[Perkins Engines]]|[[Progress Rail Services]]}}
- module
- For embedding other templates (see WP:IEmbed).
- ratio
- Basel III ratio; used for banks only.
- website
- Top-level URL of the company's website, using the
{{URL}}
template. Do not include the leading www. unless the URL will not resolve without it. If the URL is retrieved from Wikidata but no longer represents the company at hand, it is preferred to demote the URL to "Deprecated rank" at Wikidata. If this is not possible, the field can be suppressed using| suppressfields=website
. - Fallback Wikidata item: official website (P856)
- Example:
{{URL|caterpillar.com}}
- footnotes
- Use to list citations that validate the data in the infobox or to note information about the terms, names, and figures used.
Financial results parameters
Financial indicators available:
Wiki-link the first occurrence of the currency unit. This is usually in the |revenue=
parameter.
Each parameter entry should include three elements: an indicator icon, the results of the most recent fiscal year and the results of the previous fiscal year.
- Example
{{Unbulleted list|{{Increase}} US$128,064,032 (2011)|US$111,586,447 (2010)}}
Indicator icons
You may include an indicator icon to indicate the change compared to the previous fiscal year; to avoid confusion, place the indicator before the number. Note that this is intended to depict the direction of change compared to the previous year, not the actual numerical change in value.
- Examples
-
{{Unbulleted list|{{Increase}} US$128,064,032 (2011)|US$111,586,447 (2010)}}
{{Unbulleted list|{{Steady}} US$128,000,000 (2011)|US$128,000,000 (2010)}}
{{Unbulleted list|{{Decrease}} US$111,586,447 (2011)|US$128,064,032 (2010)}}
- Which display as
-
- US$128,064,032 (2011)
- US$111,586,447 (2010)
- US$128,000,000 (2011)
- US$128,000,000 (2010)
- US$111,586,447 (2011)
- US$128,064,032 (2010)
Consistent notation
There are different ways to record financial results that are in the millions or billions of dollars. Pick one and use it consistently in all parameters. Use
to prevent wrapping between elements of the numbers, per MOS:NUM.
Do not express results as a decimal such as
. Instead choose a notation that will allow you to express all results for the period in whole numbers.In this example, use {{Increase}} US$963,000,000 (2010)
and apply your choice to all the financial results consistently.
Examples
Exact dollars
Revenue |
|
---|---|
| |
| |
Total assets |
|
Total equity |
|
or
Rounded billions
or
Rounded millions
but not
Do not use an inconsistent mix of the three styles depicted in the examples above. Below is an example of undesirable, inconsistent notation.
Embedding
Many different templates can be embedding within this template. For example, to add a Korean name, use {{Infobox Chinese/Korean}}
as follows
Native name | |
---|---|
Hangul | Hangul |
Hanja | Hanja |
Revised Romanization | Revised Romanization |
McCune–Reischauer | McCune–Reischauer |
Company type | Public |
Use as a child template
The embed parameter is used when embedding this infobox into another (see the Template:Infobox documentation which explains embedding and subboxes).
{{Infobox ABC
| name =
| <!-- etc. -->
| embedded = <!-- or: module= -->
{{Infobox company
| embed = yes
| <!-- etc. -->
}}
}}
Embedding other templates
The module parameter is used for embedding other templates into this infobox (see Wikipedia:Infobox modules).
{{Infobox company
| name =
| <!-- etc. -->
| module =
{{Infobox ABC
| embed = yes <!-- or: child = yes, subbox = yes-->
| <!-- etc. -->
}}
}}
Examples
Company type | Public |
---|---|
Industry | Publishing |
Genre | Corporate histories |
Founded | May 25, 1900New York City, US | in
Founders |
|
Headquarters | , US |
Number of locations | 300 stores (2011) |
Area served | North America |
Key people | |
Products |
|
Production output |
|
Services |
|
Revenue |
|
| |
| |
Total assets |
|
Total equity |
|
Number of employees |
|
Parent | Mega Corporation |
Divisions |
|
Subsidiaries |
|
Website | example |
Footnotes / references [1][2] |
- ^ Johnson 2010, p. 35.
- ^ Hancock 2008, p. 58.
Company type | Private |
---|---|
ISIN | US0378331005 |
Industry | Investment services |
Predecessor | Wilson Wikiana & Company |
Founded | (June 22, 1930Edinburgh, Scotland | ) in
Founder | William Wikiand |
Defunct | October 19, 2010 |
Fate | Acquired on January 19, 2010 |
Successor | Wikianian & Wikianian Finances |
Headquarters | , England |
Number of locations | 350 branch banks (2009) |
Area served |
|
Key people | |
Products |
|
Services | |
Revenue |
|
| |
| |
AUM |
|
Total assets |
|
Total equity |
|
Owner |
|
Number of employees |
|
Subsidiaries |
|
Website | example |
Footnotes / references [1][2] |
- ^ Lincoln 2008, p. 378.
- ^ Adams 2009, pp. 27–29.
Microformat
The HTML mark-up produced by this template includes an hCard microformat that makes an organization's details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.
- Subtemplates
- Use {{Start date and age}} for the date on which an organisation was "established", "founded", "opened" or otherwise started, unless that date is before 1583 CE.
- Use {{URL}} for an organisation's URL.
Please do not remove instances of these subtemplates.
- Classes used
The HTML classes of this microformat include:
- adr
- agent
- category
- country-name
- extended-address
- fn
- geo
- label
- latitude
- locality
- longitude
- nickname
- note
- org
- region
- street-address
- url
- vcard
nor collapse nested elements which use them.
TemplateData
See a monthly parameter usage report for Template:Infobox company in articles based on its TemplateData.
TemplateData for Infobox company An infobox for companies
|
Tracking categories
- Category:Pages using infobox company with unknown parameters (199)
- Category:Pages using infobox company with conflicting parameters (13)
- Category:Pages using infobox company with a duplicate image (6)
Notes