Help:Properties: Difference between revisions

Content deleted Content added

Inline

Latest revision as of 09:35, 21 September 2024

This page is a work in progress, not an article or policy, and may be incomplete and/or unreliable.
Please offer suggestions on the talk page.

This page in a nutshell:

Properties describe the data value of a statement
Properties, like items, have their own unique pages on Wikidata
Properties, unlike items, must first be approved by the Wikidata community before being created

Example of a simple statement consisting of one property-value pair

A property describes the data value of a statement and can be thought of as a category of data, for example "color" for the data value "blue". Properties, when paired with values, form a statement in Wikidata. Properties are also used in qualifiers.

Wikidata currently has 12,278 properties.

Properties have their own pages on Wikidata and are connected to items, resulting in a linked data structure.

Understanding properties

Properties are similar to items in a couple of ways. Like items, each property has a label, a description, and even an alias or aliases that can be added in multiple languages. Properties also have statements that help to more completely describe the property, including constraints on how the property can be used.

P106 for English, French, and Polish
Label	Description	Alias
occupation	occupation of a person	profession; job; work; career
profession	métier ou occupation d'une personne	métier; occupation
zawód	zawód osoby, zobacz także "dziedzina"	(none yet added)

However, properties do not have a section on their pages for sitelinks to other Wikimedia projects, and they also do not have external identifiers.

Each property has a data type which defines the kind of values allowed in statements with that property.

Properties aim to relate one type of entity with another type. The type of item a property should be used on is called its domain (Q112036279) and can be enforced using a subject type constraint (Q21503250). If the data type of an item is an Item, than the type of item that should be the value of the property is called is range (Q112036270) and can be enforced using a value-type constraint (Q21510865). If the data type is not an Item, the type of a value a property has can be specified with class of non-item property value (P10726).

Like items, properties also have a unique identifier. While items begin with a Q prefix and are found in the main namespace of Wikidata, properties have a P prefix and are stored in the property namespace.

Finding properties

Properties can be suggested at respective classes using properties for this type (P1963). E.g. organization (Q43229) will list all properties relevant to any organization.

See Statistics for additional summaries of existing properties.

Search

Search

Several external tools exist to list properties, for instance:

Wikidata Property Explorer

Lists

Special:AllPages/Property: (List by alphabetically sorted number)
Special:ListProperties + Get a list of properties by data type
Wikidata:List of properties
Wikidata:Database reports/List of properties/Top100
Wikidata:Database reports/List of properties/all
Template:Property lists

Creating properties

Before a new property is created, it has to be discussed and documented at Wikidata:Property proposal first. When after some time there are some supporters, but no or very few opponents, the property is created by a property creator or an administrator (see List of property creators). After creation, relevant documentation is moved to the corresponding property's talk page, where usage of the property is further discussed.

When proposing properties, keep in mind that each property should be expected to be used by at least 100 items; if a proposed property cannot be used this many times, it likely should not be added to Wikidata (of course, there are exceptions to this rule).

To propose a property, click here and choose a topic category. Click the blue button "Create request page" and then fill out the provided template with as much information as possible. Make sure to include a possible property name in English (this will be the label), a description, the data type, examples of the type of item that may bear the property, and an example of how the property would be used. Don't worry about getting everything right the first time; that's what the discussion process is for.

If you are interested in being involved at the property proposal level for a specific subject matter, consider joining or creating a WikiProject, a group of contributors who want to work together to improve a particular aspect of Wikidata. These groups often focus on how to best represent the data for a particular area of knowledge.

For more information on the property creator role, see Wikidata:Property creators#Requesting this right. To request the userright, visit Wikidata:Requests for permissions/Other rights#Property creator.

Editing properties

Warning: You need to be confirmed or autoconfirmed to edit properties.

Property entities can be edited like item entities with labels, descriptions, aliases, and statements.

Property labels should be as unambiguous as possible so that it is clear to a user which property is the correct one to use when editing items and adding statements. Properties rarely refer to commonly known concepts but they are more constructs of the Wikidata with specific meanings. Unlike items, property labels must be unique.

Property descriptions are less relevant for disambiguation but they should provide enough information about the scope and context of the property so that users understand appropriate usage of the property without having to consult additional help.

Property aliases should include all alternative ways of referring to the property.

Example:

property: P161

label: cast member

description: actor performing live for a camera or audience

aliases: film starring; actor; actress; starring

Label, description, and aliases of a property are first discussed by the community during the property proposal process. Major changes to a property should be discussed on its talk page first.

See Help:Data_type#Changing_datatype for changing the datatype of a property.

Deleting properties

If you think a property should be removed from Wikidata (for example, if is a duplicate of another property in use), you will have to make a request for its deletion. To do so, follow the steps listed at Wikidata:Properties for deletion.

Using properties

Wikidata relies on consistency. For instance, all persons should have common properties whenever possible, whether they are politicians, artists or scientists, living or historical, fictional or not. If you are unsure whether the property you are using is most appropriate for the statement, consult the property's discussion page or ask on Wikidata:Project chat. An automatically generated list of properties currently supported by Wikidata can be found at here. Community-maintained lists can also be found at Wikidata:List of properties.

Property constraints

See Help:Property constraints portal.

Bidirectional relationships and hierarchies

Wikidata does not support automatic bidirectional links (phabricator:T51165), so some properties need to be added and maintained twice. If, for example, A is a child of B on A's item page, the relation B as the parent of A also needs to be maintained on B's item page.

In general, only simple hierarchical properties should be recorded as statements. For example, record properties like child (P40)–father (P22) and/or mother (P25), but not properties like grandchild–grandparent, niece–aunt, niece–uncle, etc. Such additional relationships can be derived from the existing data.

Property misuse

Every Wikidata property is intended for a specific purpose. When a Wikidata property is used in a way that goes against the consensus of how the property is meant to be used, we speak of property misuse. Wikidata attempts to combat property misuse with property constraints and entity schemas. If a property is misused because there doesn't exist any good alternative property, a new property may be proposed.

Frequently used properties

Please see Help:Frequently used properties for guidelines and examples of using properties related to scientific taxonomies, administrative divisions, sources, Wikimedia Commons files, and more.

@@ Line 1: / Line 1: @@
 <languages/>
 {{draft}}
+{{nutshell|1=<translate><!--T:42--> Properties describe the data value of a statement</translate>|2=<translate><!--T:43--> Properties, like items, have their own unique pages on Wikidata</translate>|3=<translate><!--T:44--> Properties, unlike items, must first be approved by the Wikidata community before being created</translate>}}
+[[File:Wikidata - simple statement.svg|thumb|upright=1.5|<translate><!--T:45--> Example of a simple statement consisting of one property-value pair</translate>]]
 <translate>
 <!--T:1-->
-{{nutshell|Properties describe the data value of a statement|Properties, like items, have their own unique pages on Wikidata|Properties, unlike items, must first be approved by the Wikidata community before being created}}
+A '''property''' describes the data value of a statement and can be thought of as a category of data, for example "color" for the data value "blue". Properties, when paired with values, form a {{ll|Help:Statements|statement}} in Wikidata. Properties are also used in {{ll|Help:Qualifiers|qualifiers}}.
-[[File:Simple statement - Earth.png|thumb|upright=1.5|example of a simple statement consisting of one property-value pair]]
+<!--T:54-->
-A '''property''' describes the data value of a statement and can be thought of as a category of data, for example "color" for the data value "blue". Properties, when paired with values, form a [[Help:Statements|statement]] in Wikidata. Properties are also used in {{ll|Help:Qualifiers|qualifiers}}.
+Wikidata currently has <tvar name="count">{{pages in namespace|property}}</tvar> properties.
 <!--T:2-->
 Properties have their own pages on Wikidata and are connected to items, resulting in a linked data structure.
+==Understanding properties== <!--T:3-->
-Basic outline to understand the definition of what word
-Can be considered an example of the word and meaning to the word Properties.properties are similar to items in a couple of ways. Like items, each property has a label, a description, and even an alias or aliases that can be added in multiple languages. Properties also have statements that help to more completely describe the property, including constraints on how the property can be used.properties can be anything owned by or also represented but not limited to a person being the representative ,a jobs title a company or an esquisite gran beautiful and un imaginable valued object can represent you as a whole and therefore can make you a property to them in representation but still privately owned and completely still belinging to anyone unless married but thats described as a unionship or partnership not in anyways to be confused with being property.so while you can be employeed and payed  for that title of property to the company legally you cant be purchased or bought against your personal free will so unless you are working as a slaved hostage your noones property.also you can have something so meaningful and important it represents everything to all entirety of what and who you are for example maybe you have won something that represents you as definition of who you are or what you believe in or represent within yourself a trophy a title an award ect.you can be consisted its property based on how big it was for you but you as a being are still your personal owner and have complete rights to yourself unless your married legally your partner might consider you half theirs.but it is still to your willingness and complete wishes of wanting to be with that person job or object not under any circumstances should you'd you become an inferior worth less or not being equal to
+<!--T:47-->
+Properties are similar to items in a couple of ways. Like items, each property has a label, a description, and even an alias or aliases that can be added in multiple languages. Properties also have statements that help to more completely describe the property, including [[<tvar name="1">Special:MyLanguage/Help:Property constraints portal</tvar>|constraints]] on how the property can be used.
 <!--T:4-->
@@ Line 29: / Line 32: @@
 <!--T:5-->
-However, properties do not have a section on their pages for sitelinks to other wikimedia projects, and they also do not have external identifiers. Each property does have what is known as a {{ll|Help:Data type|data type}} which defines the kind of values allowed in statements with that property.
+However, properties do not have a section on their pages for sitelinks to other Wikimedia projects, and they also do not have external identifiers.
+<!--T:52-->
+Each property has a {{<tvar name="1">ll|Help:Data type</tvar>|data type}} which defines the kind of values allowed in statements with that property.
+<!--T:53-->
+Properties aim to relate one type of entity with another type. The type of item a property should be used on is called its {{Q|Q112036279}} and can be enforced using a {{Q|Q21503250}}. If the data type of an item is an Item, than the type of item that should be the value of the property is called is {{Q|Q112036270}} and can be enforced using a {{Q|Q21510865}}. If the data type is not an Item, the type of a value a property has can be specified with {{P|P10726}}.
 <!--T:6-->
@@ Line 43: / Line 52: @@
 ===Search=== <!--T:10-->
+<!--T:48-->
 * [//www.wikidata.org/wiki/Special:Search?profile=advanced&fulltext=Search&ns120=1 Search]
 Several external tools exist to list properties, for instance:
@@ Line 48: / Line 59: @@
 ===Lists=== <!--T:11-->
-* [{{fullurl:Special:AllPages|namespace=120}} Special:AllPages] (List by alphabetically sorted number)
+<!--T:49-->
+* [[Special:AllPages/Property:]] (List by alphabetically sorted number)
 * [[Special:ListProperties]] + Get a list of properties by data type
 * [[Wikidata:List of properties]]
@@ Line 55: / Line 68: @@
 * [[Template:Property lists]]
-==Creating properties== <!--T:12-->
+== Creating properties == <!--T:46-->
+</translate>
+{{main|Wikidata:Property creation}}
+<translate>
+<!--T:12-->
 Before a new property is created, it has to be discussed and documented at {{ll|Wikidata:Property proposal|Wikidata:Property proposal}} first. When after some time there are some supporters, but no or very few opponents, the property is created by a {{ll|Wikidata:Property creators|property creator}} or an {{ll|Wikidata:Administrators|administrator}} (see [[Special:ListUsers/propertycreator|List of property creators]]).
 After creation, relevant documentation is moved to the corresponding property's talk page, where usage of the property is further discussed.
@@ Line 63: / Line 80: @@
 <!--T:14-->
-To propose a property, click [[Wikidata:Property proposal|here]] and choose a topic category. Click the blue button "Create request page" and then fill out the provided template with as much information as possible. Make sure to include a possible property name in English (this will be the label), a description, the data type, examples of the type of item that may bear the property, and an example of how the property would be used. Don't worry about getting everything right the first time; that's what the discussion process is for.
+To propose a property, click {{ll|Wikidata:Property proposal|here}} and choose a topic category. Click the blue button "Create request page" and then fill out the provided template with as much information as possible. Make sure to include a possible property name in English (this will be the label), a description, the data type, examples of the type of item that may bear the property, and an example of how the property would be used. Don't worry about getting everything right the first time; that's what the discussion process is for.
 <!--T:15-->
-If you are interested in being involved at the property proposal level for a specific subject matter, consider joining or creating a [[Wikidata:WikiProjects|WikiProject]], a group of contributors who want to work together to improve a particular aspect of Wikidata. These groups often focus on how to best represent the data for a particular area of knowledge.
+If you are interested in being involved at the property proposal level for a specific subject matter, consider joining or creating a {{ll|Wikidata:WikiProjects|WikiProject}}, a group of contributors who want to work together to improve a particular aspect of Wikidata. These groups often focus on how to best represent the data for a particular area of knowledge.
 <!--T:16-->
+For more information on the property creator role, see [[<tvar name="1">Special:MyLanguage/Wikidata:Property creators#Requesting this right</tvar>|Wikidata:Property creators#Requesting this right]]. To request the userright, visit <tvar name="2">[[Wikidata:Requests for permissions/Other rights#Property creator]]</tvar>.
-To request to be a property creator, visit {{ll|Wikidata:Requests for permissions}}.
 ==Editing properties== <!--T:17-->
+</translate>
+{{Warning|1=<translate><!--T:40--> You need to be [[<tvar name="confirmed">Special:MyLanguage/Wikidata:Confirmed users</tvar>|confirmed]] or [[<tvar name="autoconfirmed">Special:MyLanguage/Wikidata:Autoconfirmed users</tvar>|autoconfirmed]] to edit properties.</translate>}}
+<translate>
+<!--T:41-->
 Property entities can be edited like {{ll|Help:Item|item entities}} with {{ll|Help:Labels|labels}}, {{ll|Help:Descriptions|descriptions}}, {{ll|Help:Aliases|aliases}}, and statements.
@@ Line 97: / Line 119: @@
 ==Deleting properties== <!--T:23-->
-If you think a property should be removed from Wikidata (for example, if is a duplicate of another property in use), you will have to make a request for its deletion. To do so, follow the steps listed at [[Wikidata:Properties for deletion]].
+<!--T:50-->
+If you think a property should be removed from Wikidata (for example, if is a duplicate of another property in use), you will have to make a request for its deletion. To do so, follow the steps listed at {{ll|Wikidata:Properties for deletion}}.
 ==Using properties== <!--T:24-->
 <!--T:25-->
-Wikidata relies on consistency. For instance, all persons should have common properties whenever possible, whether they are politicians, artists or scientists, living or historical, fictional or not. If you are unsure whether the property you are using is most appropriate for the statement, consult the property's discussion page or ask on [[Wikidata:Project chat]]. An automatically generated list of properties currently supported by Wikidata can be found at [[Special:AllPages/Property:|here]]. Community-maintained lists can also be found at [[Wikidata:List of properties]].
+Wikidata relies on consistency. For instance, all persons should have common properties whenever possible, whether they are politicians, artists or scientists, living or historical, fictional or not. If you are unsure whether the property you are using is most appropriate for the statement, consult the property's discussion page or ask on [[Wikidata:Project chat]]. An automatically generated list of properties currently supported by Wikidata can be found at [[Special:AllPages/Property:|here]]. Community-maintained lists can also be found at {{ll|Wikidata:List of properties}}.
 ===Property constraints=== <!--T:26-->
@@ Line 110: / Line 134: @@
 ===Bidirectional relationships and hierarchies=== <!--T:28-->
+<!--T:51-->
 Wikidata does not support automatic bidirectional links ([[phabricator:T51165]]), so some properties need to be added and maintained twice. If, for example, A is a child of B on A's item page, the relation B as the parent of A also needs to be maintained on B's item page.
 <!--T:29-->
 In general, only simple hierarchical properties should be recorded as statements. For example, record properties like {{P|40}}–{{P|22}} and/or {{P|25}}, but not properties like ''grandchild–grandparent'', ''niece–aunt'', ''niece–uncle'', etc. Such additional relationships can be derived from the existing data.
+</translate>
+== <translate><!--T:55--> Property misuse</translate> <span id="misuse"></span> ==
+<translate>
+<!--T:56-->
+Every Wikidata property is intended for a specific purpose. When a Wikidata property is used in a way that goes against the consensus of how the property is meant to be used, we speak of ''property misuse''. Wikidata attempts to combat property misuse with {{<tvar name="1">ll|Help:Property constraints</tvar>|property constraints}} and {{<tvar name="2">ll|Wikidata:WikiProject Schemas</tvar>|entity schemas}}. If a property is misused because there doesn't exist any good alternative property, {{<tvar name="3">ll|Wikidata:Property creation</tvar>|a new property may be proposed}}.
 == Frequently used properties == <!--T:30-->
@@ Line 125: / Line 158: @@
 '''For related Help pages, see:'''
 * {{ll|Help:Frequently used properties}}, for help with using specific properties
-** {{ll|Help:Basic membership properties}}, detailed explanation of three important properties:  {{P|P31}},  {{P|P279}}  and  {{P|P361}}
+** {{ll|Help:Basic membership properties}}, detailed explanation of three important properties:  {{P|P31}},  {{P|P279}}  and  {{P|P361}}</translate>
+<translate>
 <!--T:34-->
-* {{ll|Wikidata:List of properties}}, community-maintained lists of Wikidata properties   -  [[Special:AllPages/Property:]], a special page showing all properties
+* {{ll|Wikidata:List of properties}}, community-maintained lists of Wikidata properties   -  [[Special:AllPages/Property:]], a special page showing all properties</translate>
+<translate>
 <!--T:35-->
 * {{ll|Help:Statements}}, which explains what statements are and what rules they follow
 * {{ll|Help:Qualifiers}}, which explains what qualifiers are and what rules they follow
-* {{ll|Help:Items|Help:Items}}, which explains what items are and what rules they follow
+* {{ll|Help:Items|Help:Items}}, which explains what items are and what rules they follow</translate>
+<translate>
 <!--T:36-->
 * {{ll|Wikidata:Property proposal}}, to discuss new properties before they are created  -  {{ll|Wikidata:Properties for deletion}} to nominate properties for deletion
@@ Line 143: / Line 176: @@
 * {{ll|Wikidata:Identifiers}} for identifiers in Wikidata in general and identifier properties in particular
 * {{ll|Wikidata:WikiProject Properties}}
+* <tvar name="1">{{ll|MediaWiki:Wikibase-SortedProperties}}</tvar> controls the order in which properties are presented on an item
 <!--T:37-->
 '''For additional information and guidance, see:'''
+</translate>
-{{TNT|Help links}}
+{{Help links}}
-<!--T:38-->
 {{Translation categories}}
-</translate>