Template:Deprecated

From OpenStreetMap Wiki
(Redirected from Template:Discouraged)
Jump to navigation Jump to search
Public-images-osm logo.svg [[Key:{{{oldkey}}}|{{{oldkey}}}]]
Commons-emblem-hand.svg
Description
Using this tag is discouraged, use instead.
Used on these elements
should not be used on nodesshould not be used on waysshould not be used on areasshould not be used on relations (except multipolygon relations)
Status: deprecated

exclamation mark

This feature has been labeled as deprecated. The recommended replacement is: {{{newtext}}}.
The reason is documented in Deprecated features. You are still free to continue to use or interpret this tag as you see fit since OpenStreetMap does not have “banned features”.
Under no circumstances should you (semi-)automatically change “deprecated” tags to something else in the database on a large scale without conforming to the automated edits code of conduct. Any such change will be reverted.
[Edit] [Purge] Template-info.svg Template documentation

Usage

Describes deprecated tag values.

Parameters

  • oldkey= (mandatory) Deprecated key name
  • oldvalue= (optional) Deprecated value
  • newtext= (mandatory) Replacement text to link to
  • group= (optional) Group name of deprecated key
  • statuslink= (optional) Link to resource that lead to deprecated status

Additional parameter

  • status=deprecated (optional) It is suggested by at least one user to keep or add the parameter status=deprecated as this is important information that might be relevant to retain in the page content. For now, it is not known that it makes a difference. But in the future it may provide the possibility to read this information from the page, e.g. fetched by taginfo. (See also Template talk:Deprecated.)

See also

This template is dedicated for deprecated tags. It provides a description box suitable for key/value pairs.

Template parameters

ParameterDescriptionTypeStatus
Deprecated keyoldkey

Deprecated key name

Example
natural
Linerequired
Deprecated valueoldvalue

Deprecated tag value

Example
lake
Lineoptional
Replacement taggingnewtext

Text with suggested replacement tag(s)

Example
{{tag|natural|water}} + {{tag|water|lake}}
Contentrequired
An image showing a suggested rendering on a maposmcarto-rendering

An image showing a suggested rendering on a map; alternatively a page name/anchor to link to more detailed description

Fileoptional
osmcarto-rendering-sizeosmcarto-rendering-size

The size of the image set in osmcarto-rendering

Example
28px
Stringoptional
osmcarto-rendering-nodeosmcarto-rendering-node

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-node-sizeosmcarto-rendering-node-size

The size of the image set in osmcarto-rendering-node

Example
28px
Stringoptional
osmcarto-rendering-wayosmcarto-rendering-way

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-way-sizeosmcarto-rendering-way-size

The size of the image set in osmcarto-rendering-way

Example
28px
Stringoptional
osmcarto-rendering-areaosmcarto-rendering-area

an image showing a suggested rendering on a map for a node object; alternatively a page name/anchor to link to more detailed

Fileoptional
osmcarto-rendering-area-sizeosmcarto-rendering-area-size

The size of the image set in osmcarto-rendering-area

Example
28px
Stringoptional
Group of deprecated keygroup

Group name of deprecated key

Example
Water
Lineoptional
Requires tagrequires

A list of tag(s) which are necessary (often higher/lower in hierarchy) for this tag and must be set to give its actual meaning

Contentoptional
impliesimplies

A list of tag(s) that the feature implies in its defention.

Contentoptional
combinationcombination

A bulleted-list of example tag(s) that can be used in combination with this feature.

Contentoptional
seeAlsoseeAlso

a list of similar tags

Contentoptional
statusstatus

The approval status of this feature

Suggested values
deprecated
Example
deprecated
Unknownsuggested
statuslinkstatuslink

The name of the deprecation proposal page, for linking.

Page namesuggested
debugdebug

no description

Unknownoptional