Wikipedia:VisualEditor

---

• Main page
• Feedback at MediaWiki
• Sandbox (no account required)

---

About

---

• Documentation:
  • Introductory tutorial
  • User guide
  • Keyboard shortcuts
  • Frequently Asked Questions (or at MediaWiki)
• Development:
  • Roadmap up to 2017
  • Updates (2013-2023)
  • Weekly status reports (2015-2016)

---

Help out

---

• Update the help pages
• Add template data (Tutorial)
• Translate and localize documentation

---

Research

---

• Main research page

---

Other

---

• Why are the developers building this? (2013)
  • User Test Data (2013)
• Customization
• Known problems
• Requests for Comments (RfCs): Jul 2013 a, Jul 2013 b, Jul 2015, Sep 2015

Welcome to the portal for the VisualEditor, a new way of editing Wikipedia being developed by the Wikimedia Foundation. Editing Wikipedia has, in the past, required people to learn some wikimarkup, for most changes to articles. In 2001, this was acceptable; in 2013, it drives away some contributors. VisualEditor allows people to edit without having to learn wikimarkup and will, it is hoped, encourage more readers to become editors.

By the end of July 2013, the VE team expects VE to be available to editors on almost all Wikimedia projects.

Experienced editors may well prefer editing wikitext directly, finding it faster and more precise. Editing articles purely in wikitext is still and will remain an option; the Wikimedia Foundation has absolutely no plans to remove this. Both editing options are accessible from the toolbar above each article and user page.

The VisualEditor is a new, "visual" way of editing Wikipedia that will let people contribute without having to learn wikimarkup. It has been available as an opt-in "alpha" release on the English-language Wikipedia since December 2012, in 16 other languages since April 2013, and in almost all other languages since the beginning of June. As shown below, the VE team expects to deploy this to almost all Wikipedias by the end of July, making it available for all editors without their opting in, starting with the English-language Wikipedia on 1 July.

For those interested in using VisualEditor, there is a guide to doing so, as well as a list of common keyboard shortcuts. If you're interested in helping with the deployment, there are lots of tasks that needed to be done. You can receive regular status updates on your talk page by signing up for the VE newsletter.

At the moment, the VisualEditor has a large number of bugs. While some bugginess was inevitable, the current level is unacceptable and the developers' goal is to eliminate as many of these bugs as quickly as possible. Some entirely new features are still yet to be built. If you encounter an issue, then please report it on the Feedback page.

Current limitations include:

• Articles and User pages only – The VisualEditor is only enabled for the article and user namespaces (the latter allows editors to make changes in a personal sandbox). In time, VE will include the specialised editing tools needed for non-article pages, but the developer focus has been on articles. On pages other than those in the article and user namespaces, the "Edit" button will take editors to the old (wikitext) editor.
• Limited browser support – VisualEditor currently works only in the most modern versions of Firefox, Chrome and Safari. A volunteer is working on Opera support, and the developers aim to have support for the latest versions of Internet Explorer once they release the VisualEditor more widely.
• Only supports the Vector and Monobook skins. [3]
• Cannot edit a single section. VisualEditor only loads and submits entire pages.
• Despite above, must hover over "Edit" link for sections in order to get the Edit source tab for that section. This does not work on touchscreens, and is inaccessible to those who use screenreaders. This is in contrast to recommended practices of the Web Content Accessibility Guidelines that Wikipedia aims to uphold.^[1]
• Slow loading - Loading longer pages into VisualEditor takes more time than the old wikitext editor, though significantly less time than at the initial rollout of VE. Large articles may take 15 seconds or so to load.
  • Pages for which the VisualEditor is an option carry roughly 2% more Javascript, which is about 0.5% of the total page load. Furthermore, this only has to be loaded once and is cached for use on all pages (until your cache expires, usually once a week).
• Slow scrolling – Pages can take a long time to respond to attempted scrolling down or up on even relatively good computers with good internet connections.
• Incomplete editing functionality – The content of some "complex" formatting, including tables and definition lists, will display and can be edited, but editors using VE cannot modify the structures or add new entries, such as an additional row for a table. Adding features in this area is one of the developers' priorities.
• Relatively weak referencing support (albeit getting better).
• Cannot copy-paste from one page to another without losing italics, bold, wikilinks, and other markup. In particular, footnotes and templates cannot be copy-pasted. Adding this functionality is a high-priority enhancement.
• Odd-looking – The developers are currently struggling with making the HTML that VE produces look like what editors are used to seeing, so styling and so on may look a little (or even very) odd. Developer time is being spent on improving this, but their focus remains on ensuring that the VisualEditor does not alter wikitext unexpectedly.
• Cannot view hidden comments – Users using VisualEditor cannot view hidden comments, which often contain notes that are helpful in editing specific sections of articles.
• Template within template - (e.g. {{Template1|{{Template2}}}}) Unlike the Visual Mode editor of Wikia, which will be disabled if a template is containing another template, VisualEditor of Wikimedia allows such usage and will display the preview properly. The only problem is that the template within can only be used in the source mode style, meaning you need to write the full source code of the inner template manually in the parameter entry window of the outer template.

Because of these limitations and the many remaining bugs in Visual Editor, the developers recommend that VE users click "Review your changes" before saving a page, and report any problems they see.

Help is needed to make the VisualEditor as good as it can be: You can find and report bugs while using the software 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 VE 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 to templates – The 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 have named parameters and nice descriptions that make it easy to use. However, other templates lack them because they need "TemplateData" before this feature will work. If you're interested in adding TemplateData, then read the guide to it and the list of the most important templates to add it to.
• Help new users – The successful launch of VisualEditor might result in many more new editors than usual, and even though editing may be easier, learning policies and guidelines and how to interact with the community will still be challenging. Please try to spend some 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.

Sign up here! Just add * {{user|Your username}} below.

• Lacolchadetu senscape (talk · contribs)
• Jimbo Wales (talk · contribs)
• 3family6 (talk · contribs)
• Alessandro57 (talk · contribs)
• Flexdream (talk · contribs)
• Defan24 (talk · contribs)
• Wrybit (talk · contribs)
• Cisco9078 (talk · contribs)
• cj1340 (talk · contribs)
• Judgesurreal777 (talk · contribs)
• Alaney2k (talk · contribs)
• J.Dong820 (talk · contribs)
• Drali1954 (talk · contribs)
• Doberek (talk · contribs)
• Ekhaya2000 (talk · contribs)
• Tentinator (talk · contribs)
• Buffbills7701 (talk · contribs)
• ctxppc (talk · contribs)
• Captain Assassin! (talk · contribs)
• Pratyya Ghosh (talk · contribs)
• Charles Edwin Shipp (talk · contribs)
• Blok Glo (talk · contribs)
• JordanKyser22 (talk · contribs)
• Auric (talk · contribs)
• Chiefmartinez (talk · contribs)
• Zhaofeng Li (talk · contribs)
• CRC43 (talk · contribs)
• Aashwath_001 (talk · contribs)
• patchallel (talk · contribs)
• Susanne Ramharter (talk · contribs)
• Neo12345292 (talk · contribs)
• Simoncaulton (talk · contribs)
• benzband (talk · contribs)
• Coal town guy (talk · contribs)
• Farshid7 (talk · contribs)
• Smuckola (talk · contribs)
• Corn cheese (talk · contribs)
• ~Siriusly (talk · contribs)
• vfrickey (talk · contribs)
• Gerryyabes (talk · contribs)
• Johnny Au (talk · contribs)
• Quadtripplea (talk · contribs)
• Signalizing (talk · contribs)
• Cekli829 (talk · contribs)
• fabregas0414 (talk · contribs)
• JMHamo (talk · contribs)
• gordon4752 (talk · contribs)
• PearlSt82 (talk · contribs)
• Jacopo Werther (talk · contribs)
• Freedman1 (talk · contribs)
• Charles01 (talk · contribs)
• lion_trainer (talk · contribs)
• Lineagekeeper (talk · contribs)
• Spacenut42 (talk · contribs)
• danlev (talk · contribs)
• Perumalism (talk · contribs)
• Aleksa Milićević (talk · contribs)
• Coolgama (talk · contribs)
• Wahrmund (talk · contribs)
• Discott (talk · contribs)
• Paine Ellsworth (talk · contribs)
• Nascar1996 (talk · contribs)
• Codename Lisa (talk · contribs)
• mgiganteus1 (talk · contribs)
• XapApp (talk · contribs)
• Andrewa (talk · contribs)
• Robert McClenon (talk · contribs)
• Imagine Wizard (talk · contribs)
• BJMendelson (talk · contribs)
• Bcorr (talk · contribs)
• Ocaasi (talk · contribs)
• Lucky102 (talk · contribs)
• Loggats (talk · contribs)
• John Broughton (talk · contribs)
• ScottyWZ (talk · contribs)
• ProtoDrake (talk · contribs)
• Diaa abdelmoneim (talk · contribs)
• Dom497 (talk · contribs)
• JB82 (talk · contribs)
• ConradKilroy (talk · contribs)
• Sreejiththulaseedharan (talk · contribs)
• TehPlaneFreak (talk · contribs)
• Ged UK (talk · contribs)
• hym411 (talk · contribs)
• David Gerard (talk · contribs)
• Bilby (talk · contribs)
• Pseudonymous Rex (talk · contribs)
• OrangesRyellow (talk · contribs)
• Arctic Kangaroo (talk · contribs)
• Quiddity (talk · contribs)
• Faizan (talk · contribs)
• Miya (talk · contribs)
• Numbermaniac (talk · contribs)
• Alexander95015 (talk · contribs)
• Hair (talk · contribs)
• Shanata (talk · contribs)
• Martijn Hoekstra (talk · contribs)
• Stratocaster27 (talk · contribs)
• Joe Decker (talk · contribs)
• Ewiz88 (talk · contribs)
• PamD (talk · contribs)
• jduranboger (talk · contribs)
• metsfreak2121 (talk · contribs)
• Diego Moya (talk · contribs)
• Froztbyte (talk · contribs)
• Odisha1 (talk · contribs)
• JetBlast (talk · contribs)
• MirandaStreeter (talk · contribs)
• Christian75 (talk · contribs)
• EdSaperia (talk · contribs)
• Jc86035 (talk · contribs)
• Bevo (talk · contribs)
• JohnCD (talk · contribs)
• GermanJoe (talk · contribs)
• orsd (talk · contribs)
• MatthewBurton (talk · contribs)

Wikimedia Commons has media related to VisualEditor.

• The mediawiki.org page about the VisualEditor, including the regular status reports
• The mediawiki.org page about Parsoid, the bidirectional wiki parser behind VisualEditor and its regular status reports