Jump to content

Wikipedia:VisualEditor

Page semi-protected
From Wikipedia, the free encyclopedia
(Redirected from Wikipedia:Visual Editor)
MainTalkFAQUser GuideNamed refsUpdatesNewsletterMediaWiki MediaWiki

Enable VisualEditor. Read VisualEditor's User Guide.
VisualEditor is enabled by default for new registered editors. If it is not enabled for you, and you are logged in, go to Preferences, click Editing, check Enable the visual editor, and click Save. Or use this sandbox link for testing. Find out how to make links, add or move images, create citations, insert templates, edit tables, and more. Use Phabricator to report problems with Visual Editor. Please include your web browser, computer operating system, and Wikipedia skin (usually Vector (2022), sometimes Vector Legacy (2010)). Start a new Phabricator ticket.
As of mid-2023, editors at the English Wikipedia have used VisualEditor to make more than 25 million edits.

Welcome to the portal for VisualEditor, an editing tool developed by the Wikimedia Foundation (WMF). It allows users to contribute to Wikipedia without the prerequisite need to learn or understand the underlying language and formatting. Before the release of this tool, the only way for users to make contributions to Wikipedia was by using the 'Source editor', which requires users to understand wiki markup (also known as wikitext) in order for their intended edits to be formatted and displayed how they were intended; however, VisualEditor provides a new way for people to edit most elements of articles and pages without the need to understand any code or markup. The WMF staff hopes that this tool will encourage more readers to become editors.

Experienced editors may still prefer editing with the wikitext source editor because they find it faster, more precise, more full-featured, and less buggy. It will also be needed for editing all discussion pages. Editors who enable VisualEditor will always have the Source editor option available on every page.

VisualEditor still has many bugs and missing features. If you encounter an issue using the VisualEditor on Wikipedia.org or another Wikimedia project (i.e., not on a third-party wiki), you can report it on the MediaWiki Feedback page. WMF staff prefer that you report bugs via the Phabricator bug tracking website.

About VisualEditor

VisualEditor is a "visual" way of editing Wikipedia that allows people to contribute without having to learn wiki markup. This rich-text editor was made available as an opt-in release on the English-language Wikipedia in December 2012, in 14 other languages in April 2013, and in most other languages at the beginning of June 2013. As of April 2015, it was available by default to users of about 76% of the language editions of Wikipedias and as an opt-in beta feature to the rest, along with most non-Wikipedia projects except Wiktionary and Wikisource. On English Wikipedia, it is enabled by default for new editors.[1]

As of 2021, VisualEditor was used about half as often as the 2010 wikitext editor, and about as often as the mobile web editor. It is used about twice as often as Twinkle.

To learn more about using VisualEditor, please read the guide to VisualEditor and the list of common keyboard shortcuts. Your help with the many tasks that need to be done is appreciated. You can also receive regular status updates on your talk page by signing up for the VisualEditor newsletter.

Limitations

Current known limitations include:

  • Not available in talk or discussion namespaces – On the English Wikipedia, VisualEditor is not enabled for any talk pages, on the Template or Wikipedia namespaces, and on several of the namespaces that are rarely edited. The "Edit" button for VisualEditor is not available on pages where VisualEditor cannot be used. The Reply tool has a visual mode based on VisualEditor, as well as a wikitext mode with a live preview.
  • Incomplete editing functionality – The content of some complex formatting, including definition lists, will display and can be edited, but editors using VisualEditor cannot modify certain details. Multi-column lists are edited through the complex transclusion dialog, which is difficult. Table editing on Mobile doesn't work properly. Adding features in this area is one of the developers' priorities.
  • Requires JavaScript – If VisualEditor is not available in your browser, or if you have turned off Javascript, then you will see the buttons for the wikitext editor only.
  • Numeric reference names – Currently, VE automatically adds numeric ref names with a colon prefix, i.e., ":0", ":1", ":2", and so on. There has long been interest in having VE support named references.
  • Slower – Loading longer pages into VisualEditor can be significantly slower than the source editor for some users.[2]
  • Cannot edit a single section – VisualEditor loads and submits only entire pages. Clicking an edit link for a section will scroll to the appropriate section upon opening. In VisualEditor's model, editing sections would be paradoxically slower than editing the whole page. [Note: Opening an entire page for editing does not increase edit conflicts, which are (roughly) based on editing the same paragraph.]
  • Limited support for user scripts – Most user scripts do not work when using VisualEditor; it is up to the script's developer to add support for VisualEditor.
  • Cannot upload non-free images – At this time, images that are uploaded inside either the wikitext editor or VisualEditor are sent directly to the Wikimedia Commons, which does not accept non-free images. All images that fall under Wikipedia's non-free content policy must instead be stored on Wikipedia using the File Upload Wizard. Commons also runs a filter to reject many images uploaded by editors who have not made many prior edits to Commons, especially for small or low-resolution images.
  • Data in merged cells is deleted – If rows or columns are moved across them. Workaround: Unmerge the affected areas before moving, and merge them again afterwards.
  • Wikilink changes – May unnecessarily turn a simple link into a piped link when a change to the link text involves redirects.
  • Template issues
    • Parameters are wikitext, not rich text – VisualEditor lets you edit the parameters of template transclusions, but only as "wikitext" (so "[[Foo]]" or nested templates like "{{Foo|{{Bar}}}}", not "Foo" or "{{Foo|{{Bar}}}}").
    • Footnotes – Footnotes inside templates (most commonly, infoboxes and {{reflist}}) are not visible in the "reuse" dialog, causing discrepancies in the numbering of footnotes displayed at the bottom of the main VisualEditor editing window. Similarly, VisualEditor is not compatible with articles using list-defined references.
    • Unable to customize parameter order – VisualEditor does not give you the ability to customize the order in which template parameters are listed. This could cause problems with articles or sets of articles where there is an established, consistent order for templates, especially citation templates.
    • Changes template parameter and value alignment – Especially with infoboxes, VisualEditor can sometimes modify spacing done for parameter and value alignment purposes and add a space after each pipe. Note that this is a deliberate feature of TemplateData that can be managed in the documentation of a given template; see mw:Help:TemplateData#Custom formats for detailed information.
    • Table-formatting unawareness – Popular table cell templates (e.g. yes, no, tba, n/a) can cause issues. The reason is that these templates contain a pipe character to separate formatting and text, but VisualEditor isn't aware of this. As a result, table operations which change the table structure, such as merging/splitting cells or inserting/deleting/moving rows or columns, may not work properly.
    • Unbalanced code – VisualEditor struggles with templates that pass a bit of incomplete code, with markup, to another template or table. These may display oddly or may not be editable if selected in VisualEditor.

You can click "Review your changes" to review the wikitext changes before saving a page. Please report any problems you see, after first searching open VE tickets to make sure it hasn't been reported already..

How to help out

Help is needed to make VisualEditor as good as it can be: You can find and report bugs and ideas for improvements or lend a hand in many other tasks, such as:

  • Updating help pages – All Wikimedia Foundation projects have help pages to make contributing easier for new editors. Unfortunately, the launch of VisualEditor has made obsolete the screenshots and tutorials in these help pages, because they describe how to edit using the source editor. Therefore, the VisualEditor development team needs help updating help pages. The user guide to VisualEditor is a starting place for text for the new help pages.
  • Adding TemplateData code to template documentation pages – VisualEditor features an interactive template editor—described in more detail in the user guide—and as you'll see if you use it on Wikipedia, some templates display named parameters and nice descriptions that make the interactive template editor easy to use. However, other templates lack them, because they need TemplateData code added to their documentation pages for this feature to work. If you're interested in adding TemplateData, read the guide for it and a list of some of the most transcluded templates that may still need TemplateData added to their documentation.
  • Help new users – Even though editing with VisualEditor may be easier, learning policies and guidelines and how to interact with the community is always challenging for new editors. You can help by spending time at the appropriate venues: the Help desk, the Teahouse, and the help chatroom. Additionally, please feel free to monitor the Category of Wikipedians looking for help.
  • Report errors, and suggest improvements – Read about how to write a bug report or feature request, then start a new Phabricator ticket.

Newsletter

  1. Wikipedia:Village pump (technical)
  2. Wikipedia:Village pump (WMF)
  3. Wikipedia:VisualEditor/Feedback
  4. Wikipedia talk:Talk pages project
  5. User talk:11111s
  6. User talk:1keyhole
  7. User talk:23emr
  8. User talk:2Awwsome
  9. User talk:2NumForIce
  10. User talk:3family6
  11. User talk:3rdReconDoc
  12. User talk:5225C
  13. User talk:6033CloudyRainbowTrail
  14. User talk:Abdulraheem Gouda
  15. User talk:Abhal555
  16. User talk:Acather96
  17. User talk:Adam Cuerden
  18. User talk:Afernand74
  19. User talk:Ahm_masum
  20. User talk:Alaney2k
  21. User talk:Aleksa Milićević
  22. User talk:Alessandro57
  23. User talk:Alsee
  24. User talk:Anasskoko
  25. User talk:Anchorvale
  26. User talk:Andrew Davidson
  27. User talk:Andrewa
  28. User talk:Andrybak
  29. User talk:annibale covini gerolamo
  30. User talk:Anonymoustofu
  31. User talk:Another Believer
  32. User talk:Anthony Staunton
  33. User talk:Antoine.b
  34. User talk:AnUnnamedUser
  35. User talk:arodb
  36. User talk:Arthur Rubin
  37. User talk:Ashorocetus
  38. User talk:Atchison_clark
  39. User talk:AWwikipedia
  40. User talk:Azdrew
  41. User talk:Babymissfortune
  42. User talk:Barkeep49
  43. User talk:Barte
  44. User talk:Barzamin
  45. User talk:Bateme5
  46. User talk:Bcorr
  47. User talk:Beauty School Dropout
  48. User talk:BetterCallSaulKripke
  49. User talk:Bevo
  50. User talk:Bilby
  51. User talk:bill52270
  52. User talk:bishwa_777
  53. User talk:Blackdiamand21
  54. User talk:Blahma
  55. User talk:Block Baby
  56. User talk:BoldLuis
  57. User talk:bouktin
  58. User talk:Bunnypranav/Newsletters
  59. User talk:C-Brennan-Poole
  60. User talk:Caius G.
  61. User talk:Canadianpoliticaljunkie
  62. User talk:CAPTAIN RAJU
  63. User talk:Carl.e.Bean
  64. User talk:Cassiopeia
  65. User talk:Catx108/my news subscriptions
  66. User talk:Celine1776
  67. User talk:ceyockey
  68. User talk:Charles Edwin Shipp
  69. User talk:Charles01
  70. User talk:Checkingfax
  71. User talk:Ched
  72. User talk:ChekhovsGunman/Newsletters
  73. User talk:Chewings72
  74. User talk:Chitreshraj
  75. User talk:Christian75
  76. User talk:ckoerner
  77. User talk:ClemRutter
  78. User talk:Cocobb8
  79. User talk:CodingCyclone
  80. User talk:ConradKilroy
  81. User talk:Corn cheese
  82. User talk:Crh23
  83. User talk:CRS-20
  84. User talk:cscott
  85. User talk:Cup o' Java
  86. User talk:CWBoast
  87. User talk:CX Zoom/Newsletters/Current year
  88. User talk:Daisytheduck
  89. User talk:Damenleeturks
  90. User talk:Danish AMC
  91. User talk:danlev
  92. User talk:Danre98
  93. User talk:DarkestElephant
  94. User talk:Darklanlan
  95. User talk:Darren-M
  96. User talk:Davey2010
  97. User talk:David Gerard
  98. User talk:David Saroyan
  99. User talk:Davidbuddy9
  100. User talk:Davisonio
  101. User talk:Daxx_wp
  102. User talk:De la Marck
  103. User talk:Defan24
  104. User talk:Dekema2
  105. User talk:Dfcfozz
  106. User talk:Diaa abdelmoneim
  107. User talk:Diego Moya
  108. User talk:Discott
  109. User talk:Discount Horde
  110. User talk:Dlwilson88
  111. User talk:DLynch (WMF)
  112. User talk:Donald Trung
  113. User talk:Dtwedt
  114. User talk:DXLB Muzikant
  115. User talk:DylWyl
  116. User talk:Dyork
  117. User talk:EchidnaLives
  118. User talk:Ed6767
  119. User talk:EdSaperia
  120. User talk:Eevee01
  121. User talk:Ekhaya2000
  122. User talk:Elitre
  123. User talk:Emery Cool21
  124. User talk:Epicgenius
  125. User talk:EpicPupper
  126. User talk:Ergo Sum
  127. User talk:Esb5415
  128. User talk:Evangeline
  129. User talk:Evolution and evolvability
  130. User talk:Ezlev
  131. User talk:fabregas0414
  132. User talk:FaviFake
  133. User talk:Fench
  134. User talk:flekkie
  135. User talk:Flexdream
  136. User talk:Fluffernutter
  137. User talk:foxj
  138. User talk:Frederico1234
  139. User talk:FrenchNobility
  140. User talk:Fresternoch
  141. User talk:Froztbyte
  142. User talk:FuriouslySerene
  143. User talk:Gaia Rinaldelli
  144. User talk:Gasforth-2021
  145. User talk:Ged UK
  146. User talk:Gerald Waldo Luis
  147. User talk:Gerryyabes
  148. User talk:Goldenshimmer
  149. User talk:Goldside852
  150. User talk:GreatSculptorIthas
  151. User talk:Grumpylawnchair
  152. User talk:Ham II
  153. User talk:Hamham31
  154. User talk:Happily888
  155. User talk:HarryPogger
  156. User talk:Harvici
  157. User talk:Hazeldee0512
  158. User talk:HeartGlow30797/Subscriptions
  159. User talk:Henrikdv
  160. User talk:hibsch
  161. User talk:HJKeats
  162. User talk:Hmich176
  163. User talk:Hopefully999
  164. User talk:HouseBlaster
  165. User talk:HovigTheEditor
  166. User talk:Howicus
  167. User talk:HurricaneZeta/Newsletters
  168. User talk:Hydriz
  169. User talk:hym411
  170. User talk:HyperEagle
  171. User talk:Hypersonic man 11
  172. User talk:I Am Chaos
  173. User talk:I dream of horses
  174. User talk:I.hate.spam.mail.here
  175. User talk:Idell
  176. User talk:IkselOwk
  177. User talk:Im5yrsold
  178. User talk:Imagine Wizard
  179. User talk:Immu 01
  180. User talk:Innovative Username
  181. User talk:Interitus malorum
  182. User talk:It is a wonderful world
  183. User talk:Itcouldbepossible
  184. User talk:Ivan Humphrey
  185. User talk:James Allison
  186. User talk:Jamesjpk
  187. User talk:Jarble
  188. User talk:JB82
  189. User talk:Jcuber17
  190. User talk:JetBlast
  191. User talk:Jhertel
  192. User talk:Jimbo Wales
  193. User talk:Jindam vani
  194. User talk:JJBers
  195. User talk:JMHamo
  196. User talk:John Broughton
  197. User talk:Johnny Au
  198. User talk:Jonathan Lane Studeman
  199. User talk:JonsterMonster
  200. User talk:Josethewikier
  201. User talk:Jrf
  202. User talk:Jtamad
  203. User talk:Judgesurreal777
  204. User talk:Jyoo1011
  205. User talk:K4rolB
  206. User talk:K6ka
  207. User talk:Kasyap
  208. User talk:katcheez
  209. User talk:KEmel49
  210. User talk:Kerry Raymond
  211. User talk:Kew Gardens 613
  212. User talk:Keyacom
  213. User talk:khamar
  214. User talk:Khantstop
  215. User talk:Killarnee
  216. User talk:LaDinky
  217. User talk:Lalit82in
  218. User talk:Language Boi
  219. User talk:LeonardoIannelliCOMPUTE
  220. User talk:lfstevens
  221. User talk:Littleb2009
  222. User talk:Llew_Mawr
  223. User talk:L'Mainerque/Newsletters
  224. User talk:LogX
  225. User talk:Lomrjyo
  226. User talk:LORENZ SARMIENTO
  227. User talk:Lotje
  228. User talk:Lucky102
  229. User talk:MadGuy7023
  230. User talk:Magol
  231. User talk:Mainline421
  232. User talk:Manwuel380
  233. User talk:Masssly
  234. User talk:MatthewBurton
  235. User talk:Medo9
  236. User talk:Melymay123
  237. User talk:Meow
  238. User talk:Merfralex
  239. User talk:MetaAlphaBeta
  240. User talk:mgiganteus1
  241. User talk:MimirIsSmart
  242. User talk:Mindi Crayon
  243. User talk:Mostafa12890
  244. User talk:Moyogo
  245. User talk:MrTrains227
  246. User talk:Mruthunjaya9
  247. User talk:MrWonka
  248. User talk:Muffizainu
  249. User talk:MusikAnimal
  250. User talk:Mvolz
  251. User talk:My Pants Metal
  252. User talk:Naechrr
  253. User talk:Nate 2169
  254. User talk:NemesisAT
  255. User talk:Neo12345292
  256. User talk:NeoJade
  257. User talk:Neonorange
  258. User talk:NgocAnMaster
  259. User talk:Nicco18
  260. User talk:Nicereddy
  261. User talk:Nick Moyes
  262. User talk:Nick Wilson
  263. User talk:nigeleezdr
  264. User talk:NightWolf1223
  265. User talk:Nihiltres
  266. User talk:Nikolaih
  267. User talk:NikolaiVektovich
  268. User talk:Nkansahrexford
  269. User talk:NPRB
  270. User talk:Ocaasi
  271. User talk:Ohiowa2
  272. User talk:OhKayeSierra
  273. User talk:Oiyarbepsy
  274. User talk:OmegaAOL
  275. User talk:OodFloo
  276. User talk:Oronsay
  277. User talk:orsd
  278. User talk:Paine Ellsworth
  279. User talk:PamD
  280. User talk:patchallel
  281. User talk:Patriccck
  282. User talk:PearlSt82
  283. User talk:Pelagic, User talk:Pelagic/Newsletters
  284. User talk:Perumalism
  285. User talk:Peter Chastain
  286. User talk:Peterdownunder
  287. User talk:Philoserf
  288. User talk:PhotographerTom
  289. User talk:Pichemist
  290. User talk:PieThrowerChamp
  291. User talk:Piotrus
  292. User talk:Pizza1016
  293. User talk:Playlikeastar
  294. User talk:Plingsby
  295. User talk:Pointillist
  296. User talk:PradNelluru
  297. User talk:Pratyya Ghosh
  298. User talk:Presidentman
  299. User talk:ProcrastinatingReader
  300. User talk:ProtoDrake
  301. User talk:Prototime
  302. User talk:Pseudonymous Rex
  303. User talk:Psiĥedelisto
  304. User talk:Punetor i Rregullt5
  305. User talk:Pythoncoder/News
  306. User talk:Quadtripplea
  307. User talk:Quiddity
  308. User talk:QWER11296
  309. User talk:Qwerfjkl
  310. User talk:Rachel.dicerbo
  311. User talk:Rafaelthegreat
  312. User talk:reb1981
  313. User talk:Redalert2fan
  314. User talk:Retinarecorder
  315. User talk:Rhagfyr
  316. User talk:Rhododendrites
  317. User talk:Richard Nevell (WMUK)
  318. User talk:Robert M. Hunt
  319. User talk:Robert McClenon
  320. User talk:RoySmith
  321. User talk:Saehrimnir
  322. User talk:Sam'kelo Mpungoseh
  323. User talk:Sanyamkamat
  324. User talk:Sasuke Sarutobi
  325. User talk:ScottyWZ
  326. User talk:Sculpordwarfprunesea
  327. User talk:Shaded0
  328. User talk:Shanata
  329. User talk:shanluan
  330. User talk:Shemew
  331. User talk:Shibbolethink
  332. User talk:Signalizing
  333. User talk:Simoncaulton
  334. User talk:SivaGovind
  335. User talk:Slazenger
  336. User talk:SmartK
  337. User talk:SMcCandlish
  338. User talk:Some1
  339. User talk:Spineas
  340. User talk:Spurb
  341. User talk:Sreejiththulaseedharan
  342. User talk:SshibumXZ
  343. User talk:SSSB
  344. User talk:StudiesWorld
  345. User talk:Sue Gardner
  346. User talk:SunDawn
  347. User talk:Syed Sadique Hussain
  348. User talk:Sylvester Penn
  349. User talk:Symphonic Spenguin
  350. User talk:TapticInfo
  351. User talk:TehPlaneFreak
  352. User talk:Tenryuu
  353. User talk:TenType
  354. User talk:TerraCodes
  355. User talk:The 19th One
  356. User talk:The Anome
  357. User talk:The ed17
  358. User talk:The Land
  359. User talk:The Master of Hedgehogs
  360. User talk:The person who loves reading
  361. User talk:the wub
  362. User talk:TheFrog001
  363. User talk:TheOtherGaelan
  364. User talk:There'sNoTime
  365. User talk:TheSandDoctor
  366. User talk:Three97
  367. User talk:Thryduulf
  368. User talk:Timeshifter
  369. User talk:TimothyBlue
  370. User talk:Titan Kittisak
  371. User talk:Tom Morris
  372. User talk:Tom29739
  373. User talk:Tomorrow and tomorrow
  374. User talk:Tonymetz
  375. User talk:Toran107
  376. User talk:ToxiBoi
  377. User talk:TPFNoob
  378. User talk:TrudiJ
  379. User talk:UMAGPR
  380. User talk:UnstoppablePhoenix
  381. User talk:Valereee
  382. User talk:VeniVidiVicipedia
  383. User talk:Vishal.acet
  384. User talk:Vitaium
  385. User talk:Vpilato
  386. User talk:VQuakr
  387. User talk:Vukky
  388. User talk:VulcanSphere
  389. User talk:Waddie96
  390. User talk:Washing Machine
  391. User talk:WDM10
  392. User talk:WhatamIdoing
  393. User talk:Whiteghost.ink
  394. User talk:Wikiuser13
  395. User talk:Wil540 art
  396. User talk:Wittylama
  397. User talk:Wolbo
  398. User talk:Wouterstomp
  399. User talk:writeswift
  400. User talk:wshaggy
  401. User talk:Xbony2
  402. User talk:Yobkj
  403. User talk:Yololobia2
  404. User talk:Yoshi1423
  405. User talk:Zappingsbrew000
  406. User talk:ZLEA
  407. User talk:Zulujive
  408. User talk:Zziccardi
  409. User talk:ԱշոտՏՆՂ
  410. User talk:علاء
  411. User talk:أيوب

Userbox

You can signal to other editors your use of the VisualEditor on your userpage by using the userbox User:Psiĥedelisto/Userboxes/VisualEditor. See that page for all the options available, three of which are shown here.

Notes

  1. ^ "visualeditor-nondefault.dblist". gerrit.wikimedia.org. Retrieved 28 December 2021. (List of Wikiprojects that do not have VisualEditor enabled by default for new users)
  2. ^ For data on VisualEditor performance, see this Grafana dashboard