Jump to: navigation, search

About this board

Edit description

Post your feedback about using the visual editor. Please report bugs involving Parsoid at Talk:Parsoid instead.

If you are reporting a problem directly on this page, please include your web browser, computer operating system, and wiki skin (usually Vector, sometimes Monobook). The feedback tool within the visual editor will include your user agent details instead.

Use this page to tell the Wikimedia developers your ideas and issues about using the visual editor. The Editing team welcomes your feedback and ideas, especially on user interface decisions and the priorities for adding new features. All comments are read, in any language, but personal replies are not guaranteed.

Please note that the Wikimedia Foundation does not provide support for installing VisualEditor on third-party wikis.

You may also want to read a guide to optimize the visual editor's experience on your site, which details work necessary on the community side (such as translating or setting up citation systems).

View open developer tasks Report a new bug in Phabricator Join the IRC channel Test the visual editor! (no account required)

By clicking "Add topic", you agree to our Terms of Use and agree to irrevocably release your text under the CC BY-SA 3.0 License and GFDL

Issues: Multiple usability issues with the media settings dialog

1 (talkcontribs)

Steps to reproduce

  1. Go to Project:Sandbox
  2. Click edit (make sure this leads to visualeditor)
  3. Click insert in toolbar
  4. Click the Media button
  5. Enter a file name that isn't an image such as audio, video (e.g. "Mozart Symphony 36 KV 425 Linz 4.oga")
  6. Click the audio or media item in the list
  7. Click advanced


  • "Change media" button
  • "Media type" heading
  • "Media dimensions /size" heading

Custom image size input boxes

  • Ability to input audio dimensions

Make full size button working

  • Actually make the audio the default size


  • Choosing this option and applying the changes sets a border


  • "change image" button
  • "image type" heading
  • "image size" heading

Custom image size input boxes

  • Can't actually set audio dimensions, as each time the text is entered it is removed by the input box (this is possible to set using wikitext)

Make full size button

  • Button doesn't seem to do anything


  • Issues
    • This changes the location of the image to the left hand side
    • Hides the border
    • Hides the caption
    • Makes it hard to actually spot where the audio is
    • Seems to change the "audio" dimensions to 0x0 px

Proposed solutions

  • Review the whole interface, and make changes to emphasize that this tool supports media, and not only images.
  • Basic Image type - this doesn't seem like it would work with audio, and it isn't entirely clear what it does when confronted with other media
  • Custom image type input boxes - enable the inputboxes and allow entry
  • "Full size" - seems to have been designed entirely for images, although it could be reset the audio dimensions to default
  • "Border" - this seems to quite simply be a very strange bug. It should just set the border if possible with audio
  • Change labels to reflect that it works with media not only images.

Notes: It seems more like it was initially designed just for images and later changed to also work for other media, yet those changes didn't take into account the different media types. It is actually pretty confusing, and a usability issue, when one is inserting non-images and the dialog keeps making notes about image type, image size, and so forth.

Reply to "Issues: Multiple usability issues with the media settings dialog"

Issue: Media insert tool contains a label that assumes that all media are images

Summary by Elitre (WMF) (talkcontribs)

Steps to reproduce

  1. Go to Project:Sandbox
  2. Click edit (make sure this leads to visualeditor)
  3. Click insert in toolbar
  4. Click the Media button
  5. Enter a file name that isn't an image such as audio, video (e.g. "example.ogg")
  6. Click the audio or media item in the list

Expected output

A button to insert "media" with the label "Use this media" .

Actual output

A button with the label "Use this image".

Elitre (WMF) (talkcontribs)

@Jdforrester (WMF), will I break something if I just edit ?

Jdforrester (WMF) (talkcontribs)

Yes (but it won't let you anyway). File a task?

Reply to "Issue: Media insert tool contains a label that assumes that all media are images"

Issue: VisualEditor allows insertion of extension tags with empty content that later show errors

Summary by Elitre (WMF) (talkcontribs)

Steps to reproduce

  1. Create a blank page with VisualEditor
  2. Insert a reference (<ref>) tag
  3. Add a space within ref tag, and insert
  4. Insert a score tag
  5. Add a space within the score tag and insert
  6. Save


VisualEditor removes the tag and leave empty space (or refuses to insert) because it doesn't contain any useful content and when saved causes errors, e.g. <ref> </ref> is output as <ref/>.


Upon saving, the both extension tags show errors with tracking categories.

Example (

Reply to "Issue: VisualEditor allows insertion of extension tags with empty content that later show errors"

Edit notice is not shown when a user switches from wikitext editor to visualeditor

Summary by Elitre (WMF) (talkcontribs)


As a user, when I click the button to switch to visualeditor I expect to see an edit notice (if it exists).

Steps to reproduce

  1. Go to
  2. Click edit (make sure this leads to wikitext editor, meta + shift + e), and see edit notice
  3. Click pencil icon
  4. Click "switch to visual editing"

Expected output

A popup with an edit notice containing some text (if it exists).

Actual output

No popup with an edit notice.

TheDJ (talkcontribs)

Note that that is an edit intro btw, which is a rather special case of an edit notice. I'm personally not able to reproduce, but i've seen more reports like this on English Wikipedia recently. Perhaps is is a race condition or something. (talkcontribs)

It probably happens consistently when the user is logged out:

A good guess is probably that the "switched" notice is higher priority than the edit notice so it gets hidden and the edit notice might get discarded. It would also be odd (and a worse user experience) for it to show both notices simultaneously. Although the edit notice should probably be higher priority than the "switched" notice.

An easy way to replicate is to use it on protected pages, and force a switch to visualeditor using a keyboard shortcut (e.g. alt + shift + v).

You can see that the API response contains the text, it is simply not used for some reason:

    "visualeditor": {
        "result": "success",
        "notices": ["<div class=\"floatleft\"><img alt=\"AnonEditWarning.svg\" src=\"//\" width=\"9\" height=\"20\" srcset=\"// 1.5x, // 2x\" data-file-width=\"9\" data-file-height=\"20\" /></div> <span style=\"color:#d33; font-weight:bold;\">You are not logged in.</span> Your <a href=\"/wiki/IP_address\" title=\"IP address\">IP address</a> will be publicly visible if you make any edits. If you <span class=\"plainlinks\"><b><a class=\"external text\" href=\"//\">log in</a></b> or <b><a class=\"external text\" href=\"//\">create an account</a></b></span>, your edits will be attributed to a user name, among <a href=\"/wiki/Wikipedia:Why_create_an_account%3F\" title=\"Wikipedia:Why create an account?\">other benefits</a>.\n", "<div id=\"semiprotectedpagewarning\">\n<p><b>Note:</b> This page has been <a href=\"/wiki/Wikipedia:Protection_policy#Semi-protection\" title=\"Wikipedia:Protection policy\">semi-protected</a> so that only <a href=\"/wiki/Wikipedia:User_access_levels#Autoconfirmed_users\" title=\"Wikipedia:User access levels\">autoconfirmed users</a> can edit it. If you need any help getting started with editing, see the <a href=\"/wiki/Wikipedia:New_contributors%27_help_page\" title=\"Wikipedia:New contributors' help page\">New contributors' help page</a>.\n</p>\n<hr class=\"fmbox-warning-ruler\" style=\"color: #BB7070; background-color: #BB7070;\"/>\n</div>\n<li class=\"mw-logline-protect\"> 16:34, 14 August 2014 <a href=\"/wiki/User:SlimVirgin\" class=\"mw-userlink\" title=\"User:SlimVirgin\"><bdi>SlimVirgin</bdi></a> <span class=\"mw-usertoollinks\">(<a href=\"/wiki/User_talk:SlimVirgin\" class=\"mw-usertoollinks-talk\" title=\"User talk:SlimVirgin\">talk</a>\u00a0| <a href=\"/wiki/Special:Contributions/SlimVirgin\" class=\"mw-usertoollinks-contribs\" title=\"Special:Contributions/SlimVirgin\">contribs</a>)</span> changed protection level for <a href=\"/wiki/Banana\" title=\"Banana\">Banana</a> \u200e\u200e[edit=autoconfirmed] (indefinite)\u200e[move=sysop] (indefinite) <span class=\"comment\">(Persistent <a href=\"/wiki/Wikipedia:Vandalism\" title=\"Wikipedia:Vandalism\">vandalism</a>: restoring protection per request)</span> <span class=\"mw-logevent-actionlink\">(<a href=\"/w/index.php?title=Banana&action=history&offset=20140814163456\" title=\"Banana\">hist</a>)</span> </li>\n<a href=\"/w/index.php?title=Special:Log&page=Banana&type=protect\" title=\"Special:Log\">View full log</a>"],

Değişiklikleri kaydetmiyor.

Summary by Elitre (WMF)

@Mehmet Ali Acar, unsure how to help you further here.

Mehmet Ali Acar (talkcontribs)
Kullanıcı temsilcisi Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; .NET4.0C; .NET4.0E; .NET CLR 2.0.50727; .NET CLR 3.0.30729; .NET CLR 3.5.30729; rv:11.0) like Gecko


Whatamidoing (WMF) (talkcontribs)

Can you tell me more? What happened when you tried to save the page? I see that uses Flagged Revisions. Are your changes showing now?

Mehmet Ali Acar (talkcontribs)

TÜİK'in yeni nüfus bilgilerine göre, 'Güncel Nüfus Bilgileri Tablosu 2016'ları İl ve ilçe sayfalarına yerleştirdim. Ancak; Afyonkarahisar, Ardahan, Diyarbakır, Eskişehir, Kocaeli, Samsun, Sivas il sayfalarında bu işlemi gerçekleştiremedim. Tabloyu sayfaya koyduktan sonra, ya da bir rakamı değiştirdikten sonra 'Değişiklikleri Kaydet' butonuna bastığımda çalışmadı. Yalnız 'kaynağı değiştir' den bilgi değişikliği kabul ediliyor. Ancak bu sayfadan tablo girişi çok zor. Yardımlarınız için şimdiden teşekkürler.~~~~

Elitre (WMF) (talkcontribs)

Bumping as I need to figure out more about this

Whatamidoing (WMF) (talkcontribs)

He wasn't able to save any edits toır that day, so there's no diff to look at. The (current version of the) demographics table looks correct when I open the page.

Please improve quality

Summary by Elitre (WMF)

Redirected to id.wp.

ALCINO SOARES (talkcontribs)

Please increase the quality of this article to include a reference that is more detailed in Indonesian Wikipedia, free encyclopedia.thank you..

Elitre (WMF) (talkcontribs)

@ALCINO SOARES , you need to contact the Indonesian Wikipedia with such a request. Thank you.

Schnark (talkcontribs)

In my opinion the insert menu in the toolbar is hard to use, and should be improved, though I don't really have good ideas about how to do so.

The main problem is, that (once you expand it) it is a really long list with no obvious order you have to really search for the tool you want to use. Just today I wanted to insert a code block on Wikipedia. Though I knew the tool must be there somewhere, I had to go through the list twice, before I spotted it. Here on the list is even longer than my screen, showing a scrollbar (though only the "Fewer" item is not visible without scrolling). Just wait some time and there will probably be even more extensions adding tools to that list.

Just some more or less random thoughts:

  • The order of the tools should be reconsidered. For example, why is "Hieroglyphs" (something most users will never use) the fifth item, coming before tools that are used more often?
  • Could the order and selection of the tools depend on the user and the context? For example, record how often a user uses a specific tool and provide his favourites more prominently. Or make it depend on the context: On a page with many formulae you are more likely to add another formula than on other pages.
  • Would a hierarchical menu (once these are possible, which currently isn't the case) improve the usability? It would make the list shorter, but on the other hand this could force you to search several submenus, making it even worse.
  • Are there other users with better ideas how to improve the insert menu? (talkcontribs)

Having used VisualEditor in non-WMF wikis, my experience was initially the same. Although that wiki didn't have as many extensions as Wikimedia wikis do. But you do get used to recognizing the icons, rather than the words in time.

The order of the tools should be reconsidered. For example, why is "Hieroglyphs" (something most users will never use) the fifth item, coming before tools that are used more often?

There is an order, it is just not obvious to some. The order of the menus is seemingly from most used items. At some point it seems that they just started appending to the list.

Could the order and selection of the tools depend on the user and the context? 

It varies by wiki, doesn't really cite a lot of stuff, so they just put the cite button into it. On wikipedias that icon is in the toolbar. Changing it by context is a really bad idea because it will just end up being confusing to users who expect the button to be somewhere but changes on some pages.

Would a hierarchical menu (once these are possible, which currently isn't the case) improve the usability? 

This is one reasonable approach to grouping similar actions, whenever that is implemented.

Are there other users with better ideas how to improve the insert menu?

Until sub-menus are implemented, there are a few tricks they can use:

  1. Use separators (horizontal lines) between items to separate similar actions
  2. It should generally have 5-7 elements per usability guidelines with a scroll bar for more, A very long drop like that is pretty bad.
  3. Group similar actions separately from frequent ones with either separators or some other visual identifier.
  4. Maybe add a new widget that allows typing to filter the list, with appropriate aliases, e.g. video, photo, music -> media
  5. Add an extra toolbar that can be toggled (and hidden) like the insert character menu, and this would contain other more frequently used icons.

Generally, it might be a good idea to look at what other non-WMF wikis have done, maybe shoutwiki or other wiki farms. Wikia for example, somewhat redesigned their tool bar adding a second toolbar and moving the media button (images & video) along with the gallery to this new toolbar. (talkcontribs)

Other desktop word processing software also places the media button, table button and even the graph button on the main toolbar. Flow for example took the minimalist approach and only added the bare minimum, although a "quote button is sorely needed" (maybe someone could make a gadget for that).

In the end it might be a good idea to do some analysis of the editor toolbar usage and move things based on the findings.

ESanders (WMF) (talkcontribs)

Apart form tools that have been 'promoted' or 'demoted' in core MediaWiki, tools are added in the order that the extensions are loaded, so there really is no order at the moment. As the tools are registered by extensions, any ordering would need to be inferred from information the extensions give us, and not from a centrally controlled list.

I'm not a huge fan of a user-stats based dynamic ordering as things moving around may be even more confusing - I may end up with different orders on every wiki I use.

Whatamidoing (WMF) (talkcontribs)

I believe that this suggestion was for user-stats-based but non-dynamic ordering of the items.

DocSpenser (talkcontribs)

I have tried to insert a template into a German Wikipedia article "Maingau" that I believe needs translating ( and it should be an article in the English Wikipedia since there is no such entry). The category is "History articles needing translation from German". I used the visual editor's insert template process but the box at the top right of the insert template box to insert the edit would never light up, or activate, so that I have failed to insert the suggested template. I have read the help several times and it indicates that the edit process is straightforward, but if the activate or insert button is not working I can't figure out what to do but notify the editors of the help document. I was logged in so I thought I had the right to edit, particularly since I was only trying to insert a template asking for translation.

Whatamidoing (WMF) (talkcontribs)

Hi @DocSpenser,

I'm trying to sort out how to reproduce this problem. It sounds like you did this:

  1. Go to (try if you don't read German easily).
  2. Choose Insert > Template from the menu.
  3. (Then what?)

Does the reply atückmeldungen#Inserting_a_template answer your question?

(Also, I'm not sure that you want to do this. I believe that translations from German into English are normally requested at the English Wikipedia.)

Reply to "Insert menu is hard to use"

Why can't the footnotes be edited where they are and must be edited by clicking their number?

Summary by Elitre (WMF)
Amire80 (talkcontribs)

When I watch new users editing with VE, I very often see them trying to edit footnotes (a.k.a. "references" or "citations") where they are. Of course, this is impossible because they can be only be edited by clicking the reference number, but is there really a good reason for it?

It actually makes a lot of sense to make them clickable and editable right where they are:

  • In general, they are just content like any other, so it should be possible to click them and edit them.
  • While editing wiki syntax, their text can be clicked and edited where it is seen on the screen.
  • While reading an article, you can click the little arrow near a reference, and the article will scroll to where its number appears in the text, so it is easy to go from a footnote's number to its location in the text. But this link doesn't work while editing in Visual editor: Clicking a footnote just selects the whole corresponding references section.
Elitre (WMF) (talkcontribs)

This one should be in Phab though, it's like one the first tasks ever filed for VE I think :)

Amire80 (talkcontribs)

It doesn't surprise me, but go find something in Phab :/

Amire80 (talkcontribs)

... Also, if it's a FAQ, it's not listed as such :)

Elitre (WMF) (talkcontribs)

Isn't this ? (also, I didn't say it's a FAQ, although we do get that request from time to time.)

Why can't the page title be selected or edited in Visual editor?

Amire80 (talkcontribs)

While editing a page in Visual editor, the page's title is grayed out and cannot be selected or edited.

Editing the title may sound extreme, but I actually saw real users trying to click the title in order to rename a page (or, as we say, move it). Having such an option, maybe with some kind of a confirmation dialog, actually makes sense to me.

But what I could really never understand is why isn't it possible not being able to select it, for example for copying to clipboard. I often find myself wanting to do it, and I cannot. I could just create a Phab task for it, but I'm asking here, because it has been so since the start, and there was probably a reason for this, but I'd like to try to understand it discuss before creating a task.

Elitre (WMF) (talkcontribs) - ?

Whatamidoing (WMF) (talkcontribs)

There have been multiple requests to deal with the "you can't move the page here" issue. But I don't remember noticing that you can't select/copy it. That'd be kind of a pain if you're writing about something with a long or complicated title. (Highly experienced people might remember that they could do {{subst:PAGENAME}} to get around that, but we need a solution that works for >99% of us.)

שימוש בכלי התרגום

Summary by Elitre (WMF)

Possibly fixed.

הנפח (talkcontribs)
User agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/55.0.2883.87 Safari/537.36


האם אפשר להשתמש בכלי התרגום בזמן עריכת ערכך קיים?

Aaharoni-WMF (talkcontribs)

לא עכשיו. אולי בעתיד הרחוק