Wikipedia:VisualEditor
This help page is a how-to guide. It details processes or procedures of some aspect(s) of Wikipedia's norms and practices. It is not one of Wikipedia's policies or guidelines, as it has not been thoroughly vetted by the community. |
Enable VisualEditor. | Read VisualEditor's User Guide. | Report a problem with VisualEditor. |
Log in, uncheck Temporarily disable the visual editor while it is in beta, optionally change Editing mode to Show me both editor tabs, and save your preferences. 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. | Please include your web browser, computer operating system, and Wikipedia skin (usually Vector, sometimes Monobook). |
- Main page
- Feedback at MediaWiki or local feedback
- Sandbox (no account required)
- Why are the developers building this?
- Documentation:
- Development:
- Customization
- Known problems
- Requests for Comments (RfCs): Jul 2013 a, Jul 2013 b, Jul 2015, Sep 2015
Welcome to the portal for VisualEditor, a way of editing Wikipedia being developed by the Wikimedia Foundation (WMF) that does not require editors to learn wiki markup. Until VisualEditor, editors had to learn wiki markup to make most edits. VisualEditor will allow people to edit many types of pages without having to learn wikitext markup, and WMF staff hope that it encourages more readers to become editors.
Even after the eventual anticipated full-feature release of VisualEditor, experienced editors still may prefer editing wikitext because they find it faster and more precise. Editing articles purely in wikitext is and will remain an option that the Wikimedia Foundation has no plans to remove. Even editors who enable VisualEditor will have the wikitext option available from the toolbar for each page and section.
VisualEditor still has many bugs and missing features. If you encounter an issue, you can report it on the Feedback page, but be aware that that page is not actively monitored by WMF staff. WMF staff prefer that you report bugs via the Phabricator bug tracking web site.
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.
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 – In the English Wikipedia, VisualEditor is not enabled for any talk pages, in the Template or Wikipedia namespaces, and in several of the namespaces that are rarely edited. The "Edit" button for VisualEditor is not available on pages where VisualEditor cannot be used.
- Template 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}}}}"). - 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.
- Some browsers not supported – VisualEditor works in almost all relatively modern (last three years)[needs update] versions of Chrome/Chromium, Firefox, Edge, Internet Explorer, Safari, Opera, Midori, Falkon (formerly Qupzilla), SeaMonkey and WebPositive (approximately 95% of all users). VisualEditor will never work in some browsers that do not follow web standards, including Android 2.3 or Internet Explorer 8 or prior. 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.
- Footnotes inside templates – 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.
- Unbalanced templates – 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.
- Slower – Loading longer pages into VisualEditor can take 60 seconds or more for some users.
- 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.]
- 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.
- Unaware of table formatting done by templates - 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 the 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.
- 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.
You can click "Review your changes" to review the wikitext changes before saving a page. Please report any problems you see.
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 full launch of VisualEditor will make obsolete the screenshots and tutorials in these help pages, because they describe how to edit using the markup 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.
Newsletter
- Click here to sign up for the VisualEditor newsletter! Just add
# {{#target:User talk:YOUR USERNAME HERE}}
to the appropriate part of the list. - Prior issues of the newsletter can be found at Wikipedia:VisualEditor/Updates. Updates are sent out infrequently.
- This list is for the English Wikipedia only. If you want this newsletter delivered to a different wiki, then sign up on the global list at m:VisualEditor/Newsletter.
- You can unsubscribe at any time by removing your name from this list.
- Wikipedia:Village pump (WMF)
- User talk:Оркрист
- User talk:ԱշոտՏՆՂ
- User talk:2Awwsome
- User talk:3family6
- User talk:Acather96
- User talk:Adam Cuerden
- User talk:Ahm_masum
- User talk:Alaney2k
- User talk:Aleksa Milićević
- User talk:Alessandro57
- User talk:Alsee
- User talk:Ammarpad
- User talk:Anasskoko
- User talk:Anchorvale
- User talk:Andrew Davidson
- User talk:Andrewa
- User talk:annibale covini gerolamo
- User talk:Anonymoustofu
- User talk:Another Believer
- User talk:Anthony Staunton
- User talk:AnUnnamedUser
- User talk:arodb
- User talk:Arthur Rubin
- User talk:Aschmidt
- User talk:Ashorocetus
- User talk:Atchison_clark
- User talk:AWwikipedia
- User talk:Babymissfortune
- User talk:Barte
- User talk:Barzamin
- User talk:Bcorr
- User talk:Beauty School Dropout
- User talk:Bevo
- User talk:Bilby
- User talk:bill52270
- User talk:bishwa_777
- User talk:Blackdiamand21
- User talk:Blahma
- User talk:BoldLuis
- User talk:bouktin
- User talk:Captain Assassin!
- User talk:CAPTAIN RAJU
- User talk:CASSIOPEIA
- User talk:C-Brennan-Poole
- User talk:ceyockey
- User talk:Charles Edwin Shipp
- User talk:Charles01
- User talk:Checkingfax
- User talk:Ched
- User talk:Chewings72
- User talk:Christian75
- User talk:ckoerner
- User talk:ClemRutter
- User talk:Coal town guy
- User talk:ConradKilroy
- User talk:Corn cheese
- User talk:Crh23
- User talk:CRS-20
- User talk:cscott
- User talk:Cup o' Java
- User talk:CWBoast
- User talk:Damenleeturks
- User talk:DarkestElephant
- User talk:Darklanlan
- User talk:Davey2010
- User talk:David Gerard
- User talk:David Saroyan
- User talk:Davidbuddy9
- User talk:Davisonio
- User talk:Daxx_wp
- User talk:De la Marck
- User talk:Defan24
- User talk:Dekema2
- User talk:Dfcfozz
- User talk:DGG
- User talk:Diaa abdelmoneim
- User talk:Diego Moya
- User talk:Discott
- User talk:Dlwilson88
- User talk:DLynch (WMF)
- User talk:Donald Trung
- User talk:Dtwedt
- User talk:EdSaperia
- User talk:Ekhaya2000
- User talk:Elitre
- User talk:Epicgenius
- User talk:Ergo Sum
- User talk:Esb5415
- User talk:Evangeline
- User talk:Evolution and evolvability
- User talk:fabregas0414
- User talk:Fench
- User talk:flekkie
- User talk:Flexdream
- User talk:Fluffernutter
- User talk:foxj
- User talk:Frederico1234
- User talk:Fresternoch
- User talk:Froztbyte
- User talk:FuriouslySerene
- User talk:Gaia Rinaldelli
- User talk:Ged UK
- User talk:GermanJoe
- User talk:Gerryyabes
- User talk:Goldenshimmer
- User talk:GreatSculptorIthas
- User talk:Ham II
- User talk:Hamham31
- User talk:Harej
- User talk:Henrikdv
- User talk:hibsch
- User talk:HJKeats
- User talk:Hmich176
- User talk:Howicus
- User talk:Hydriz
- User talk:hym411
- User talk:IAmKing18
- User talk:Icqa
- User talk:IkselOwk
- User talk:Im5yrsold
- User talk:Imagine Wizard
- User talk:Immu 01
- User talk:Innovative Username
- User talk:Interitus malorum
- User talk:Ivan Humphrey
- User talk:J.Dong820
- User talk:Jacopo Werther
- User talk:Jadair10
- User talk:James Allison
- User talk:Jamesjpk
- User talk:Jamesx12345
- User talk:Jarble
- User talk:JB82
- User talk:jduranboger
- User talk:JetBlast
- User talk:Jhertel
- User talk:Jimbo Wales
- User talk:JimStage
- User talk:JJBers
- User talk:Jlmarco
- User talk:JMHamo
- User talk:Joe Decker
- User talk:Joerasmussen
- User talk:John Broughton
- User talk:Johnny Au
- User talk:Jonathan Lane Studeman
- User talk:JonsterMonster
- User talk:JordanKyser22
- User talk:Jrf
- User talk:Jtamad
- User talk:Juanktroid96
- User talk:Judgesurreal777
- User talk:Junflr
- User talk:Justin86789
- User talk:K4rolB
- User talk:K6ka
- User talk:Kasyap
- User talk:katcheez
- User talk:kateecherry
- User talk:Ke42sou
- User talk:Ken987654156
- User talk:Kerry Raymond
- User talk:khamar
- User talk:Kharkiv07/Notifications
- User talk:Kingsho
- User talk:Kristephanie
- User talk:Lacolchadetu senscape
- User talk:Lalit82in
- User talk:laughtermaster
- User talk:LeonardoIannelliCOMPUTE
- User talk:LewisMCYoutube
- User talk:lfstevens
- User talk:LikeLifer
- User talk:Lineagekeeper
- User talk:lion_trainer
- User talk:Llew_Mawr
- User talk:Loggats
- User talk:LogX
- User talk:looking4ufo
- User talk:LORENZ SARMIENTO
- User talk:Lotje
- User talk:Lucky102
- User talk:Lukaslt13
- User talk:Luke1337
- User talk:Macowell
- User talk:MadGuy7023
- User talk:Magboned
- User talk:Magol
- User talk:Mainline421
- User talk:MarkZusab
- User talk:Martijn Hoekstra
- User talk:Masssly
- User talk:MatthewBurton
- User talk:Mbcap
- User talk:Medo9
- User talk:Meow
- User talk:mgiganteus1
- User talk:Mikebilz
- User talk:Mindi Crayon
- User talk:minzy4u
- User talk:MirandaStreeter
- User talk:Miya
- User talk:MoarSmtp
- User talk:Mohammad Mahdi Malayeri
- User talk:Mohau
- User talk:Mohit1294
- User talk:Mostafa12890
- User talk:Moyogo
- User talk:Mpconnick
- User talk:MrTrains227
- User talk:MrWonka
- User talk:Muffizainu
- User talk:MusikAnimal
- User talk:Mvolz
- User talk:Natalie.Desautels
- User talk:Nate 2169
- User talk:Neo12345292
- User talk:Neonorange
- User talk:NepaliHelper
- User talk:Ngoc Trang Nguyen
- User talk:nha4601
- User talk:Nicco18
- User talk:Nicereddy
- User talk:Nick Moyes
- User talk:Nick Wilson
- User talk:Nicoya1967
- User talk:nigeleezdr
- User talk:Nihiltres
- User talk:Nikolaiho
- User talk:Nkansahrexford
- User talk:No qwach macken
- User talk:NunoDocksvira
- User talk:Ocaasi
- User talk:OhKayeSierra
- User talk:Oiyarbepsy
- User talk:OrangesRyellow
- User talk:Oreotoast
- User talk:orsd
- User talk:Otto Knell
- User talk:Paine Ellsworth
- User talk:PamD
- User talk:Pandg2
- User talk:patchallel
- User talk:patel.bhupesh
- User talk:Patriccck
- User talk:Patrickbeardmore
- User talk:Paul.j.richardson
- User talk:paulxxxxxx54
- User talk:PearlSt82
- User talk:Pelagic, User talk:Pelagic/Newsletters
- User talk:Penguin9541
- User talk:Perumalism
- User talk:Peter Chastain
- User talk:Peterdownunder
- User talk:Philoserf
- User talk:PhotographerTom
- User talk:PieThrowerChamp
- User talk:Piotrus
- User talk:Pizza1016
- User talk:Plingsby
- User talk:Pointillist
- User talk:Prabash.A
- User talk:PradNelluru
- User talk:Pratyya Ghosh
- User talk:Presidentman
- User talk:ProtoDrake
- User talk:Prototime
- User talk:Pseudonymous Rex
- User talk:Punetor i Rregullt5
- User talk:Purplesally17
- User talk:Pythoncoder/News
- User talk:Quadtripplea
- User talk:Quenhitran
- User talk:quicknss
- User talk:Quiddity
- User talk:QWER11296
- User talk:Rachel.dicerbo
- User talk:Raftab
- User talk:Raptros155
- User talk:reb1981
- User talk:Redalert2fan
- User talk:redschuart
- User talk:Retinarecorder
- User talk:Rhododendrites
- User talk:Richard Nevell (WMUK)
- User talk:Richard vlamynck
- User talk:Robert M. Hunt
- User talk:Robert McClenon
- User talk:Rockbrarian
- User talk:Roosegarden
- User talk:rororolalala
- User talk:RoySmith
- User talk:Ruud Koot
- User talk:Sachi bbsr
- User talk:Saehrimnir
- User talk:SaimS
- User talk:Sam'kelo Mpungoseh
- User talk:Sanyamkamat
- User talk:Sarah Gallienne
- User talk:Sasuke Sarutobi
- User talk:ScottyWZ
- User talk:Shaded0
- User talk:Shanata
- User talk:ShyEager
- User talk:SideLincoln99
- User talk:Signalizing
- User talk:Simoncaulton
- User talk:SivaGovind
- User talk:Slazenger
- User talk:SmartK
- User talk:SMcCandlish
- User talk:Some1
- User talk:Sourov0000
- User talk:Spektre1
- User talk:Spineas
- User talk:Spurb
- User talk:Sreejiththulaseedharan
- User talk:SshibumXZ
- User talk:StudiesWorld
- User talk:Sue Gardner
- User talk:Sunny bharat
- User talk:Superangulon210
- User talk:Supercell121
- User talk:SuperHero2111
- User talk:Suriddha Munshi
- User talk:Susanne Ramharter
- User talk:Symphonic Spenguin
- User talk:Taradle
- User talk:Tayear9220
- User talk:TehPlaneFreak
- User talk:Tenryuu
- User talk:TenType
- User talk:TerraCodes
- User talk:The 19th One
- User talk:The Anome
- User talk:The ed17
- User talk:The Land
- User talk:The Phase Master
- User talk:the wub
- User talk:TheBeastdot
- User talk:TheEternalFlame
- User talk:TheFrog001
- User talk:Thegreatrituraj
- User talk:TheMillionRabbit
- User talk:TheOtherGaelan
- User talk:There'sNoTime
- User talk:TheSandDoctor
- User talk:Thiago200002
- User talk:Three97
- User talk:Thryduulf
- User talk:Timeshifter
- User talk:Tkmlz
- User talk:Tom Morris
- User talk:Tom29739
- User talk:Toran107
- User talk:ToxiBoi
- User talk:TPFNoob
- User talk:TrishaNewell
- User talk:Ttrbwki413
- User talk:Tyjayanth
- User talk:Tyt0791
- User talk:Ugog Nizdast
- User talk:Upotrebi klikere
- User talk:VeniVidiVicipedia
- User talk:Vishal.acet
- User talk:Vpilato
- User talk:VQuakr
- User talk:Waddie96
- User talk:Waliy sherpa
- User talk:Wc5bk6
- User talk:WDM10
- User talk:WendigoUK
- User talk:WhatamIdoing
- User talk:Whiteghost.ink
- User talk:WhoShotNiceGuyEddie
- User talk:Wiki3310
- User talk:WikiClive
- User talk:Wikiuser13
- User talk:Wittylama
- User talk:Wolbo
- User talk:Woodstop45
- User talk:Wouterstomp
- User talk:writeswift
- User talk:wshaggy
- User talk:Xa
- User talk:Xbony2
- User talk:Yololobia2
- User talk:Zhaofeng Li
- User talk:ZLEA
- User talk:Zulujive
- User talk:Zziccardi
- User talk:علاء
- User talk:3oWh pF0wHz
- User talk:6033CloudyRainbowTrail
- User talk:666frz
- User talk:A ri gi bod
- User talk:Abinaya roshini
- User talk:ad mous12
- User talk:Adrienne1982
- User talk:Afrocreole
- User talk:Aozz101x
- User talk:arnold.kevin729
- User talk:Aryan hindustan
- User talk:Asfak786
- User talk:BenevolentUncle
- User talk:Bibliothecary
- User talk:BIG_RizZ
- User talk:BikashKumar11
- User talk:BioFilip
- User talk:Bjmendelson
- User talk:Blok Glo
- User talk:BlueScreen
- User talk:Bouowmx
- User talk:Buffbills7701
- User talk:Bundledape
- User talk:camelnuaa
- User talk:Cekli829
- User talk:Chaleyer61
- User talk:Chiefmartinez
- User talk:ChirayuAkotiya
- User talk:Chitreshraj
- User talk:cj1340
- User talk:Cky2250
- User talk:Coolgama
- User talk:Cryptic C62
- User talk:Da Glitchers
- User talk:danlev
- User talk:davidhrobertson
- User talk:Davidzicoman
- User talk:Deubug
- User talk:divansantana
- User talk:Double Plus Ungood
- User talk:Drali1954
- User talk:Drichter1
- User talk:Dudel250
- User talk:EastDimeBoxFrank
- User talk:Einottaja
- User talk:Emekaborisama
- User talk:Ewiz88
- User talk:Farshid7
- User talk:Fauban
- User talk:FDLeyda
- User talk:Fisubar
- User talk:Freedman1
- User talk:gcjasoliya
- User talk:ghimire111
- User talk:Goodenough4wiki
- User talk:gordon4752
- User talk:gschmirgal
- User talk:Hal.MacGregor
- User talk:HasanMasud_PUST
- User talk:hawraalmana
- User talk:Hazeldee0512
- User talk:Hobbes Novakoff
- User talk:hsbandrgb
- User talk:Hyperspace0
External links
Wikimedia Commons has media related to VisualEditor. |
- The mediawiki.org page about VisualEditor, which links to historical regular status reports from 2011 through 2016.
- The mediawiki.org page about Parsoid, the bidirectional wiki parser behind VisualEditor, and historical regular status reports from 2011 through 2014.
- A 2015 study on VisualEditor's effect on newly registered editors