Commons:QuickItem

QuickItem
Description QuickItem
Author User:Kevin Payravi / WikiPortraits
First released July 15, 2026; 6 days ago (2026-07-15)
Updated July 18, 2026
    (3 days ago)
Source GitLab repo
User:Kevin Payravi/QuickItem.js

QuickItem is a user script for creating new Wikidata items without leaving Commons. It currently shows up in two places:

This script was just launched, so please consider it to be in beta and report any issues or requests on the talk page.

Developed by User:Kevin Payravi as part of the WikiPortraits initiative.

How it works

Once installed, QuickItem adds a "create item" prompt next to the depicts input in the Upload Wizard
QuickItem link inside an unconnected Wikidata Infobox

Photos uploaded to Commons of lesser-known subjects may show a person or place that has no Wikidata item yet. Without an item, there is nothing to point a depicts statement or Wikidata Infobox at. Normally you would have to go over to Wikidata, create the item there, and come back to Commons. QuickItem handles this from within Commons itself by opening a form to create a Wikidata item without leaving the page.

QuickItem currently provides simple preset forms for these types of items:

  • Person (human)
    • General
    • Athlete
  • Location
  • Musical group

If you'd like support for other types of items, please place a request on the talk page.

Before creating an item, please check that one does not already exist. Also make sure the subject meets Wikidata's notability policy.

QuickItem only fills in the most common properties for each type. After creating an item, please visit it on Wikidata and add more properties as needed to fully flesh it out.

In the Upload Wizard

When uploading photos via the Upload Wizard, the "Main subjects visible in this work" field accepts a Wikidata item. QuickItem injects a link below that to create a new item if one exists. Once you populate the form and press "Create item", the new item's ID appears with the ability to copy and paste into the "Main subjects" box.

In Wikidata Infoboxes

When a category has a {{Wikidata Infobox}} but no connected item, the infobox shows a "no Wikidata ID found" notice. QuickItem adds a "Create new item via QuickItem" link inside that notice.

In this mode, the form also shows two locked fields showing that the Wikidata item will be automatically connected to the Commons category via the following properties:

  • a sitelink from the new item to the Commons category
  • a Commons category (P373) statement

Filling in the form

  • Pick an item type first (Person, Location, Musical group, etc.). The fields change to match the type; see Forms below for the full list.
  • Item fields such as occupation or country work by search. Start typing a name and pick from the suggestions, or enter an QID directly if you have one.
  • Labels, descriptions, and aliases have a language code box (like "en" or "de") next to them, for specifying text in multiple languages.
  • Date fields accept a year (1969), a year and month (1969-12), or a full date (1969-12-31).
  • Properties that require a reference (e.g. date of birth) have a second "source URL" box. Populate these with a URL verifying the data, if you have one.
  • Items are created with your own account, so you need to be logged in. Your Commons login carries over to Wikidata automatically.

Installation

While logged into your Wikimedia Commons account:

  1. Go to Special:MyPage/common.js
  2. Add the following code:
    mw.loader.load('//commons.wikimedia.org/w/index.php?title=User:Kevin_Payravi/QuickItem.js&action=raw&ctype=text/javascript'); // Backlink: [[Commons:QuickItem]]
  3. Save the page

Forms

This is a list of the current forms for each supported "type" of entity.

  • Person (General)
    • Instance of (P31): locked to Human (Q5)
    • Labels: multilingual, required
    • Descriptions: multilingual
    • Aliases: multilingual, comma-separated
    • Sex or gender (P21): dropdown (female Q6581072, male Q6581097, intersex Q1097630, transgender female Q1052281, transgender male Q2449503)
    • Occupations (P106): item search, repeatable
    • Date of birth (P569): date, with reference URL
    • Country of citizenship (P27): item search
    • Place of birth (P19): item search, with reference URL
    • Birth name (P1477): text, with reference URL
    • Given names (P735): item search, repeatable
    • Family name (P734): item search
    • Official website (P856): URL
    • External identifiers: property search + value, repeatable
  • Person (Athlete) (all Person fields, plus the following after Occupations)
    • Sport (P641): item search, repeatable
    • Position played (P413): item search
    • Member of sports team (P54): item search, repeatable
  • Location
    • Instance of (P31): dropdown, required (geographic location Q2221906, building Q41176, mountain Q8502, river Q4022, island Q23442, lake Q23397)
    • Labels: multilingual, required
    • Descriptions: multilingual
    • Aliases: multilingual, comma-separated
    • Country (P17): item search
    • Located in administrative unit (P131): item search
    • External identifiers: property search + value, repeatable
  • Musical group
    • Instance of (P31): locked to Musical group (Q215380)
    • Labels: multilingual, required
    • Descriptions: multilingual
    • Aliases: multilingual, comma-separated
    • Inception (P571): date
    • Location of formation (P740): item search
    • Genre (P136): item search, repeatable
    • Record label (P264): item search, repeatable
    • Country of origin (P495): item search
    • Official website (P856): URL
    • External identifiers: property search + value, repeatable
Category:Commons user scripts
Category:Commons user scripts