Module talk:Mapframe

Module:Mapframe is permanently protected from editing because it is a heavily used or highly visible module. Substantial changes should first be proposed and discussed here on this page. If the proposal is uncontroversial or has been discussed and is supported by consensus, editors may use {{edit template-protected}} to notify an administrator or template editor to make the requested edit.

This is the talk page for discussing improvements to the Mapframe module, and the related Maplink template.

Put new text under old text. Click here to start a new topic.
New to Wikipedia? Welcome! Learn to edit; get help.

Archives: 1, 2: 5 months

view · edit

Frequently asked questions (see also: mw:Help:Extension:Kartographer)

Q1: Where to file a bug report when there is a problem with the base map? (e.g. a missing lake)

A1: If the problem also occurs on OpenStreetMap, it needs to be fixed there. If the problem is only on Wikimedia's maps, it can be reported on Phabricator (you can log in with you Wikipedia account). See mw:How to report a bug for instructions (for the tags, use Maps). (Alternatively, you can try mw:Help talk:Extension:Kartographer)

Q2: Where to report other bugs or problems with the maps?

A2: This may be a problem with the Wikipedia module, or it may be an underlying software bug (there are lots of those).

If the problem also occurs when using plain <mapframe>...</mapframe> tags, then it should be reported on Phabricator (you can log in with you Wikipedia account). See mw:How to report a bug for instructions (for the tags, use Maps). (Alternatively, you can try mw:Help talk:Extension:Kartographer)
If the problem only occurs with Wikipedia's template/module, or you're not sure, report it here. (Alternatively, you can try Wikipedia:Village pump (technical))

Q3: Why does the thumbnail map render as a static image when viewing pages, but is interactive when editing pages?

A3: On Wikipedia, and most wikis other than Wikivoyage, the emdeded thumbnail is a static map, and the full screen map needs to be opened before the map can be zoomed or panned. This is for for performance reasons, and to present some content if javascript is disabled, and for printing.
That preview mode shows an interactive map is a bug, phab:T203863 (and also a performance issue). Further explanation can be found in the comments on phab:T202793.

Q4: Why is a line or shape feature from OpenStreetMap not being shown?

A4: There are several possible causes:

The feature on OSM needs to be tagged with the Wikidata id, per mw:Help:Extension:Kartographer/OSM. It is not enough to just set OpenStreetMap relation ID (P402) on the Wikidata item.
Only certain OSM relations (those with type=multipolygon, type=route, type=waterway and type=boundary) can be used, and not others like buildings and public transport master routes. See mw:Help:Extension:Kartographer/OSM#Limitation and phab:T156433.
It can take 1 or 2 days after tagging on OSM before the data is available here.
Wikimedia occasionally has problems replicating OSM data (e.g. phab:T218097), or intentionally disables replication due to other problems (e.g. phab:T243609)

Q5: Why are line, shape, or point features are not shown after editing or adding a map, even though they were shown in the page preview?

A5: This is a bug related to generating thumbnail map images. It should fix itself in an hour or two. See phab:T269984 for details.

Q6: A page using mapframe's |raw= parameter is showing error messages of "The time allocated for running scripts has expired." What can be done?

A6: If the amount of raw data to be processed is too large, that timeout message may be shown. You can try moving the raw data to Commons (example) or replacing the mapframe template with the equivalent wikitext using Special:ExpandTemplates (example)

To help centralize discussions and keep related topics together, Template talk:Maplink and related subpages redirect here

Template not functioning in Bukit Dumbar

Maplink in Bukit Dumbar's infobox was OK a few days back, but became blank by yesterday. Q# was already linked from the start. I attempted a boundary fix in OSM a few hours ago. Not sure if anyone here could help on this? hundenvonPG (talk) 06:32, 21 March 2025 (UTC)[reply]

The lag syncing the diffs from OSM to wikimaps seems really high but is within tolerance - may need to wait it out. The shape of the location seems to be in place otherwise. I updated the page to create a basic map until then. Regs, The Equalizer (talk) 11:01, 21 March 2025 (UTC)[reply]

Thanks The Equalizer

hundenvonPG (talk) 04:34, 23 March 2025 (UTC)[reply]

Thumbnail rendering issue in José Salvador Alvarenga

Point 1 and most of the line not visible, something to do with the 180th meridian line. Same issue on the fr and zh pages. Also is there a way to make the 180 line not visible? Sohryu Asuka Langley Not Shikinami (talk) 05:28, 29 April 2025 (UTC)[reply]

@Sohryu Asuka Langley Not Shikinami This is a bug. Only happens in "View mode". But I propose you to take some screenshot of OSM map, for this track, modify that and upload it using template OpenStreetMap in WikiCommons. Best regards. Hooman Mallahzadeh (talk) 06:19, 29 April 2025 (UTC)[reply]

How not dispay top right square for "Show in full screen"

Hi, is there anyway to avoid showing top right while square ([ ]) for "Show in full screen"? Sometime this square disrupts the map. Thanks, Hooman Mallahzadeh (talk) 13:41, 5 May 2025 (UTC)[reply]

Don't think you can. Just increase the height of the frame to accommodate the map. Regs, The Equalizer (talk) 20:10, 7 May 2025 (UTC)[reply]

@The Equalizer Implementation of "Hide" does not seem so hard. Just add an argument named "|hide square=yes" and then in the span of OSM map apply this style "display: none;".

Hiding this square is very useful for many Wikipedia maps, especially for small ones. So it worths implementation. Thanks, Hooman Mallahzadeh (talk) 04:01, 8 May 2025 (UTC)[reply]

I thought the box is also a subtle hint that it's a clickthrough and scalable, not just a static picture. But propose the removal via Phab if desired. The Equalizer (talk) 18:34, 8 May 2025 (UTC)[reply]

@The Equalizer No need for request of Phabricator. We should set "display:none;" CSS property for ".mw-kartographer-fullScreen" class. I tested it successfully in the inspector view my inspector of my browser.

I think it can be implemented by modifying this template only.

Line 1108 add

		displaysquare = util.getParameterValue(args, "displaySquare") or L10n.defaults.displaySquare,

and line 962 add

if options.displaySquare == "no" then
    local whiteSquare = assert(document:getElementsByClassName("mw-kartographer-fullScreen"))
	whiteSquare:css("display", "none")

Hooman Mallahzadeh (talk) 04:03, 9 May 2025 (UTC)[reply]

I think this square is not required at all, therefore we can remove it as a default setting. Because there exists a tooltip for this purpose. Hooman Mallahzadeh (talk) 14:27, 9 May 2025 (UTC)[reply]

Failure to set frame-align=none

As the alignment of thumbnail images can be set to none (see Help:Pictures), its reasonable to let this module get support as well. Unfortunately, if I set |frame-align=none, I see this notice: <mapframe>: Attribute "align" has an invalid value. -- Great Brightstar (talk) 10:29, 20 May 2025 (UTC)[reply]

This map does not allow thumbnail-sized images yet. See this archived discussion from 2023, and a similar archived discussion from March 2025. – Jonesey95 (talk) 00:48, 22 May 2025 (UTC)[reply]

Edit request 28 May 2025

This edit request has been answered. Set the |answered= parameter to no to reactivate your request.

Description of suggested change: On line 94, change "paramter" to "parameter."

Diff:

ShoneBrooks (talk) 15:00, 28 May 2025 (UTC)[reply]

Completed. P.I. Ellsworth , ed. ^{put'er there} 20:29, 28 May 2025 (UTC)[reply]

Display in title

There's this comment in the code, saying "[display=title] makes maplink wikitext that will be located in the top-right of the title of the page (the same place where coords with display=title are positioned)." That does not seem to work: the styles associated with id=coordinates cannot do that. Is this option even useful? I'm wondering if it should be removed from the template's documentation, it seems misleading. Ponor (talk) 20:30, 10 June 2025 (UTC)[reply]

This edit will put the display=title marker in the indicator area, which seems to work for all desktop skins, as can be seen at Template:Maplink/sandbox (as long as the module sandbox change is on). Is that what we want? Ponor (talk) 21:21, 10 June 2025 (UTC)[reply]

This edit request has been answered. Set the |answered= parameter to no to reactivate your request.

A naive search shows that there aren't that many articles that use {{mapframe|display=title}}, maybe no more than 50. So I think it's safe to make this change. With it

the module and template will do what they're supposed to do with |display=title: the inline+title markers won't be shown next to each other in Vector-2022 ([1]) nor the 'title' one will be placed on top of the infobox in Vector ([2])
the 'title' marker will be placed as the last of the indicators (the code added is mostly from that page)
the resulting html code seems clean, and in line with what {{coord}} already does

	Vector 2022	Vector	Monobook	Timeless
TM:Maplink	[3] N	[4] N	[5] Y	[6] Y
TM:Maplink/sandbox	[7] Y	[8] Y	[9] Y	[10] Y

Thanks, Ponor (talk) 13:50, 11 June 2025 (UTC)[reply]

Done Thanks, I had noticed this being broken a while ago and just did not want to deal with it at all. Izno (talk) 02:48, 28 June 2025 (UTC)[reply]

Inconsistent map box

The same source produces a correct result on User:OceanLoop/sandbox/map but not Indian Creek (Elwha River tributary): the frame is not positioned properly. Does anyone know why this happens? OceanLoop (talk) 00:55, 24 July 2025 (UTC)[reply]

Fixed. Regs, The Equalizer (talk) 19:10, 24 July 2025 (UTC)[reply]

How avoid text that appears when hover mouse cursor over the map?

Site of Cook's death in Kealakekua Bay

In Talk page at Talk:Death_of_James_Cook#Comments_from_Noleander I put a map. I've replicated the map here. When the mouse cursor is hovered over the map (desktop computer; Windows OS, Firefox browser) a popup window appears containing the text "The intuitive WP:UE/WP:COMMONNAME page title for this would probably be Death of James Cook. Just saying." which is the text (unreleated to the map) at the top of that Talk page.

That text popup window does not appear here, in this Talk page, when hovering over the map.

Does anyone know why that text is appearing? and if there is a way to prevent that popup from appearing? Noleander (talk) 18:29, 10 August 2025 (UTC)[reply]

Likely have the Wikipedia:Tools/Navigation popups gadget switched on in your preferences, as that line is the very first topic on the talk page. Regs, The Equalizer (talk) 19:21, 10 August 2025 (UTC)[reply]

You are correct ... that fixed it. Thanks. Noleander (talk) 19:36, 10 August 2025 (UTC)[reply]

{{maplink}} could probably set the 'nopopups' class to avoid that navigation popups triggers. —TheDJ (talk • contribs) 08:10, 11 August 2025 (UTC)[reply]

If there is a way to disable this popup issue, permanently, by a change to the maplink template, that would prevent this issue from arising in the future for other editors & readers ... so it seems like a good idea. Noleander (talk) 12:33, 11 August 2025 (UTC)[reply]