Wikipedia:Don't use the VisualEditor: Difference between revisions

Revision as of 17:18, 14 March 2025

Latest revision as of 16:42, 22 April 2025

(8 intermediate revisions by 3 users not shown)

Line 1:

{{see also|Wikipedia:VisualEditor#Limitations}}

{{under construction}}

{{essay}}

{{nutshell|Be careful when you are using the VisualEditor, as it can sometimes create problematic changes to wiki syntax that go beyond purely [[WP:COSMETIC|cosmetic]] changes.}}

{{notice|This page is aimed more at experienced users who have yet to switch to source editing. New users will still find the VisualEditor quite useful.}}

The [[Wikipedia:VisualEditor|VisualEditor]] is a great way for new contributors to dive into editing. It allows for new userseditors to immediatelyeasily make minor changes to articles.

However, for userseditors thatwho regularly edit Wikipedia, or who want to make significant or complex changes, the VisualEditor comes with serious limitations. TheMost most regularfrequent editors should use the source editor for most edits, using the VisualEditor only for minor or specific kinds of changes.

== Differences between the VisualEditor and the source editor ==

The VisualEditor is a bit like Microsoft Word, or a bit like using Wix or GoDaddy to build a website. Just as these tools are great amongfor casual userseditors, the functionality is limited and often poor infor certainmore areasadvanced users. OnUsing the othersource hand,editor usingto aedit the wikitext markup language on a page provides far more power and control than [[WYSIWYG]] editors.

Some problems with the VisualEditor include:

* misaligning comments in templates

* changing the format of tables constructed in a specific manner

* messing with line breaks after multiline parameters and comments

* adding or removing spacing in:

** template parameter names

** lists

** headers

** tables

* adding extraneous numbers to reference names (see {{phab|T375306}})

* issues with copying and pasting ISBNs and other identifiers (see {{phab|T174303}} and {{phab|T162291}})

* deletion of HTML comments (see {{phab|T247498}})

Most of these are cosmetic changes, but they make it difficult to view what actually changed in diff view. It comes down to the fact that a WYSIWYG editor will always utilize a predefined format in programming.

The VisualEditor is a great way for new contributors to dive into editing. It allows for new users to immediately make minor changes to articles.

== Problems documented with the VisualEditor ==

However, for users that regularly edit Wikipedia, the VisualEditor comes with serious limitations. The most regular editors should use the source editor for most edits, using the VisualEditor only for minor changes.

See [https://en.wikipedia.org/w/index.php?title=Wikipedia%3ASandbox&diff=1286606399&oldid=1286606320 this] sandbox edit as an example of some problems caused by using the VisualEditor.

== Differences between VisualEditor and source editor ==

== Making the switch ==

The VisualEditor is a bit like Microsoft Word or a bit like using Wix or GoDaddy to build a website. Just as these tools are great among casual users, the functionality is poor in certain areas. On the other hand, using a markup language provides far more power and control than WYSIWYG editors.

* [[Special:Preferences#mw-input-wpvisualeditor-betatempdisable|Go to this section in Preferences]].

* Uncheck "Enable the VisualEditor".

* Click {{button|Save}}.

Alternatively, you can enable the source editor inside the VisualEditor, but that can have performance issues for long pages.

Some problems with the VisualEditor include misaligning comments in templates, messing up tables constructed in a specific manner, etc.