Template:Increase/doc

Icons to show fluctuation

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Increase in articles based on its TemplateData.

TemplateData for Increase

This is one of a series of templates to display an increase or decrease arrow icon.  {{Increase}} = {{IncreasePositive}} = {{Up}} = {{Gain}} = {{Profit}} is a green up arrow.  {{Decrease}} = {{DecreaseNegative}} = {{Down}} = {{Loss}} is a red down arrow.  {{Steady}} = {{Nochange}} = {{Same}} is a flat line for no change. Examples of situations where the use of  {{Increase}} is appropriate include:

1. The quantity involved is an entity's rank according to a property where minimizing the quantity is desirable (e.g., a country's HDI rank), is always non-negative by definition and shows an encouraging improvement (e.g., an improvement in a country’s HDI rank).
2. The quantity involved should be maximized (e.g., global literacy rate, annual revenue for a business, log probability for a likelihood function in maximum likelihood estimation), can take values from either the set of non-negative reals or the set of non-positive reals (but not both), and implies a favorable progression (e.g., an increased literacy rate, an increased revenue, a higher log probability).
3. The quantity involved should be maximized (e.g., annual income for a business), may be positive, negative or zero in general, is currently a positive number (e.g., a profit, i.e., a positive annual income, justifying the green color) and informs a constructive shift (e.g., a profit which follows either a loss or a lower profit, justifying the up arrow).

Examples of situations where the use of  {{Decrease}} is appropriate include:

1. The quantity involved is an entity's rank according to a property where minimizing the quantity is desirable (e.g., a country's HDI rank), is always non-negative by definition and shows an undesirable shift (e.g., a worsening in a country’s HDI rank).
2. The quantity involved should be maximized (e.g., global literacy rate, annual revenue or income for a business, log probability for a likelihood function in maximum likelihood estimation) and implies an unwanted deterioration (e.g., a reduction in literacy rate, a fall in revenue, a decrease in income—resulting from a reduced profit or an increased loss or a loss following a profit, a reduction in log probability).
3. The quantity involved should be minimized (e.g., a country's net carbon emission), may be positive, negative or zero in general, is currently a positive number (e.g., a net positive emission which is undesirable, justifying the red color) and informs a promising enhancement (e.g., a reduction in net carbon emission, justifying the down arrow).

Use {{IncreaseNegative}} or {{DecreasePositive}} to flip the color. Examples of situations where the use of {{IncreaseNegative}} is appropriate include:

1. The quantity involved should be minimized (e.g., road accidents, a country's net carbon emission), is not an entity's rank according to a property where minimizing the quantity is desirable, and shows an unfortunate worsening (e.g., a rise in road accidents, a rise in a country's net carbon emission).
2. The quantity involved should be maximized (e.g., annual income for a business), may be positive, negative or zero in general, is currently a negative number (e.g., a loss, i.e., a negative income, justifying the red color) and implies an encouraging improvement (e.g., a reduction in loss, i.e., a rise in income, justifying the up arrow).

Examples of situations where the use of {{DecreasePositive}} is appropriate include:

1. The quantity involved should be minimized (e.g., road accidents), is not an entity's rank according to a property where minimizing the quantity is desirable, can take values from either the set of non-negative reals or the set of non-positive reals (but not both), and communicates a favorable progression (e.g., a reduction in road accidents).
2. The quantity involved should be minimized (e.g., a country's net carbon emission), may be positive, negative or zero in general, is currently a negative number (e.g., a net negative emission, justifying the green color) and informs a desired enhancement (e.g., a reduction in net carbon emission, justifying the down arrow).

Where using neither color is preferred, use {{IncreaseNeutral}} and {{DecreaseNeutral}}.

To automatically display the appropriate symbol along with a value, use {{Fluctuation formatter}}.

Parameter		Description	Type	Status
Tooltip text	1	Changes the text displayed on hover. Default Defaults to something appropriate to the chosen template, such as "Increase". Example −5%	String	optional
size	size	Changes the size of the icon. Use when adjacent to small/large text. Default 11px	Unknown	optional

Format: inline

See also

• Template:Fluctuation formatter