This page is a proposed Commons guideline, policy, or process. The proposal may still be in development, under discussion, or in the process of gathering consensus for adoption. References or links to this page should not describe it as "policy".

This proposed guideline is disputed; see Commons:Depicts.

A propriedade retrata (P180) é amplamente utilizada no Wikidata para descrever o conteúdo de determinados itens. Ela também está disponível no Wikimedia Commons para dar estrutura às descrições de mídia, como parte do projeto Dados Estruturados no Commons. As declarações retrata são usadas para descrever mais de 24 milhões de arquivos no Commons (maio de 2025).

== The importance of depicts==

Idiomas e traduções

Antes da introdução dos dados estruturados, as informações de arquivos e as categorias no Commons só podiam ser adicionadas em um único idioma, que era mais comumente o inglês. A propriedade depicts (P180) do Wikidata, entretanto, pode ser descrita em vários idiomas. A adição de declarações “retrata” aos arquivos de mídia, portanto, transforma o Wikimedia Commons em uma plataforma verdadeiramente multilíngue, onde leitores de qualquer idioma podem encontrar, entender e usar arquivos de mídia.

Capacidade de pesquisa, encontrabilidade e reutilização

As declarações “retrata” são utilizadas pelo MediaSearch para encontrar os resultados mais relevantes.

Inicialmente, o MediaSearch executa consultas que incluem declarações e legendas que usam dados estruturados. Em seguida, ele expande e pesquisa termos com base em rótulos do Wikidata (o nome mais comum pelo qual um item do Wikidata seria conhecido). Por fim, ele pode expandir ainda mais com base em categorias do Commons e informações baseadas em texto. Isso significa que, além da correspondência de texto completo, o MediaSearch inclui resultados que têm uma declaração “retrata” de qualquer entidade do Wikidata que corresponda ao termo de pesquisa do usuário. Da mesma forma, ele inclui resultados que tenham uma declaração digital representation of (P6243) relevante.

Ao tirar proveito de declarações como “retrata”, o MediaSearch funciona em qualquer idioma suportado pelo MediaWiki e não requer conhecimento de inglês. O MediaSearch também potencializa o editor visual na Wikipédia, permitindo que mais resultados de imagens, em mais idiomas, sejam exibidos para ilustrar os artigos da Wikipédia.

Além disso, as declarações “retrata” são usadas por ferramentas que ajudam os usuários a encontrar imagens relevantes para artigos não ilustrados da Wikipédia, um novo recurso em desenvolvimento. Saiba mais sobre sugestões de imagens aqui.

== Recommended best practices==

Nível de detalhe da declaração “retrata”

Recomendações gerais

O objetivo principal das declarações depicts (P180) no Commons é identificar, de forma estruturada, os itens claramente visíveis em um arquivo de mídia.

O Wikidata tem entidades em vários níveis de detalhe e em diferentes dimensões ontológicas. O MediaSearch nem sempre pode inferir de forma confiável as relações entre elas. Portanto, para otimizar um arquivo de mídia para descoberta, várias declarações depicts (P180) devem ser adicionadas, tanto gerais quanto específicas, levando em conta diferentes dimensões ontológicas.

Por exemplo, esta imagem do cão fictício Lassie deve ter as declarações dog (Q144) (classe de organismos), Rough Collie (Q38650) (raça de cão), Lassie (Q941640) (personagem fictício) e Pal (Q7126106) (o cão individual retratado).

Outro exemplo é esta imagem de uma árvore de Sequoia, que deveria ter sua declaração “retrata” como Sequoia (Q1975652) (um táxon) e tree (Q10884) (uma planta lenhosa). Embora, na linguagem cotidiana, o termo “Sequoia” possa frequentemente se referir a uma “árvore de Sequoia” (em oposição a sementes de Sequoia ou madeira de Sequoia, etc.), na ontologia do Wikidata, Sequoia é considerada uma subclasse de taxon (Q16521). Por esse motivo, a tree (Q10884) deve ser adicionada para permitir pesquisas mais precisas.

Como consequência, recomenda-se adicionar várias declarações “retrata”, tanto gerais quanto específicas, levando em conta diferentes dimensões ontológicas. Observe, entretanto, que a marcação redundante ao longo da mesma dimensão ontológica deve ser evitada sempre que possível. Por exemplo, se uma imagem mostra um cachorro, não há necessidade de adicionar toda a árvore de táxons do Domestic dog (Q20717272): Canis (Q149892), Canidae (Q25324), Caniformia (Q27414), Carnivora (Q25306), etc. Entretanto, na prática, pode acontecer que um usuário aplique uma declaração “retrata” mais geral e outro usuário apareça posteriormente e possa aplicar uma declaração mais específica. Nesse caso, a declaração “retrata” mais específica deve sempre ser adicionada. Se as duas declarações estiverem indiscutivelmente na mesma dimensão ontológica (como, por exemplo, body of water (Q15324) e lake (Q23397)), a declaração menos específica poderá ser removida. Em caso de dúvida, é preferível manter as duas afirmações. Não há necessidade de a comunidade tentar eliminar todas as declarações redundantes. As ferramentas que fazem uso dos dados são capazes de cuidar disso.

If there are multiple items clearly and deliberately depicted in the media file, all should be added as separate depicts statements, within reason. The most significant ones should be marked as "prominent" (see example below). For files that depict dozens or hundreds of items (e.g., movies) only those items which are most prominent should be listed.

If groups of the multiple depicted items are a common grouping, and have a grouped item on Wikidata, the grouped item should also be added as a depicts statement. For example File:Bonnieclyde_f.jpg should have the statement depicts: Bonnie and Clyde (Q219937) as well as depicts: Bonnie Parker (Q2319886) and depicts: Clyde Barrow (Q3320282).

Mark depicted items as prominent

Are the depicts statements equally important, or is one of them the obvious subject and the other a less relevant background detail? If so, which one is more prominent?
Is a depicts statement on one file more prominent than the same depicts statement on another?

The Sessão do Conselho de Estado (Q43485263) painting is a good example of the use of ‘mark as prominent’. There are several characters depicted in the work, most of them on the same disposition, but the main subject and focus is the female character, Maria Leopoldina of Austria (Q84239), who is also represented in a different color.

As a feature, ‘mark as prominent’ enhances the accessibility of media files for people with visual disabilities, as it is a structured way to differentiate between elements displayed in an image, especially considering that not all media files on Wikimedia Commons have a Wikidata item (or are notable enough to have one) to be described in a structured and multilingual way on that platform. When querying the structured data, 'prominent' statements can be found by searching for statements with rank "preferred".

Make sure you have selected the right Wikidata item

Wikidata is a very large database and includes many items with identical names. These items should have descriptions to guide you to the correct choice. For example, when adding a depicts statement for this photo of a banana, you may be tempted to enter "bananas". The first search result is not banana (Q503) but Bananas (Q806092), the 1971 film by Woody Allen. Wikidata items are typically singular, and typically case sensitive such that if you are looking for a fruit but the item is capitalized, it is likely incorrect. If you are unsure, just click on the item to make sure it is what you are looking for.

Good practices and advanced modelling examples

Several good practices and examples may be found on the Modeling Depiction page, in particular for the specific case of Works of Art.

== Notes==