Path of Exile 2 Wiki:Troubleshooting known issues

Issues on this wiki that are known to the admins/sysops and possible solutions on how to fix it. Consider the talk page if you want something added.

Templates/module issues specific to this wiki

Item

Items not showing up in queries, lists, item tables and other places

Can occur due to:

1. caching issues
2. invalid queries
3. template errors

Fixing item caching issues

Please see Path of Exile Wiki:Known issues#Fixing caching issues - changes (if needed) should be applied to the item's main page and the page(s) not showing the items.

Fixing invalid queries

The general process here is to check whether your query uses the correct conditions.

Some tips:

• If the query is performed by the template you're using and not by yourself, make sure to check the template's documentation first
• If an item isn't included in the query, but you think it should be check the item's page and the properties on the page. Adjust your query if needed or check for caching issues
• Adjust the query terms to be more broader or more precise
• If hitting query limits, consider creating a concept or simplifying the query
• You can also query for queries on a page to troubleshoot/identify the problem

Fixing template errors

Template errors will prevent the templates from performing correctly. In some cases there are shown on purpose to avoid people using invalid data, but may also be caused by errors in the template itself.

If you can't fix the error right away, check the documentation of the template.

If the error appears in the code of the template itself and if you're unable to fix it , please create a new section on the template talk page and/or notify the template authors/wiki admins on their user pages.

Mediawiki

Page is not added to transcluded categories from pages with <includeonly>

The symptom is generally that the page shows the category correctly at the bottom, but is not actually added to it.

Solution:

• null-edit the page the category is transcluded to

Fixing caching issues

Prior to attempt to fix caching issues, please note there are multiple caches deployed:

• Cache of your browser (i.e. client-side)
• Intermediate cache from cloudflare
• Cache used by the mediawiki software and addons

Client-side cache issues should require no action on the wiki. Consider clearing your browser's cache or using a different browser to verify it's not client-side.

Issues with the cloud flare will fix themselves eventually; if you preview a page you will get the current version. If you perform a null edit and you still see a version different from the version you just saved, don't worry about it - you're seeing a cached version which will be eventually updated to the saved version. Please note that if you have a gamepedia PRO subscription you'll see the live version of pages instead, bypassing the cloud flare cache.

Mediawiki and addon related caching issues can be generally resolved by null edit the affected pages. Please note you may need to null edit other pages if you're transcluding content from other pages or are fetching semantic values (from Semantic MediaWiki). If the edits are still not being applied, consider doing a dummy edit.

Extensions

Scribunto (Modules/Lua)

mw.text.split is very slow

Solution:

• If possible use string.split instead

Cargo

Cargo is a type of database used to store interesting values in various items, mods, versions etc. as rows in cargo tables.

Missing rows

Cargo sometimes misses pages when it repopulates the tables. Null editing each page works most of the time.

Null editing didn't add a row

We're you using the source editor? Try null editing with Visual Editor instead.

Duplicate rows

When updating pages cargo sometimes does not remove the old rows. So the old row values would still be there and show up in queries. Recreating data clears that but data recreation misses rows instead. group by helps clean up duplicates but there is no guarantee that you will get latest version.

Cannot offset too large query results

Let's say you have limited your cargo query to 4 results, {Pyre, Dream Fragments, Astramentis, Winterheart}. But there was actually 6 matching items, {Pyre, Dream Fragments, Astramentis, Winterheart, Gloomfang, Blightwell}. With SMW you could offset=4 and get the rest of the two, but this is not possible with Cargo. Cargo limit is 5000, results above that won't be retrieved with those query conditions.

One template declares/attaches to multiple cargo tables

Cargo tables can become quite large with a lot fields. Since multiple tables can be joined together and queried for it is more elegant to move the fields to other tables instead. The caveat is that the templates need to be split as well otherwise cargo bugs out. 1 template per cargo table.

Errors during previews

Cargo doesn't handle incorrect cargo queries gracefully and sometimes throws major errors that forces you to go back a page. Copy the source before submitting/previewing so your work doesn't get lost.

HOLDS doesn't work as expected

Cargo bug. Instead of using HOLDS try, *__full instead. The lists then becomes a ordinary string and can be queried as such.

Example:

• Replace skill_gems.gem_tags HOLDS "Aura" with skill_gems.gem_tags__full LIKE "%Aura%"

Case sensitivity

Cargo is case insensitive. Use BINARY instead. Read more here.

Recreation jobs are queued?

It's possible to see if a cargo data recreation job is active. See this page

Number can't be used in #expr

• #cargo_query returns integers/floats with thousand separator. Not surprisingly this will break most calculators. Wrap CONCAT() around the number field to remove thousand separators.
• #cargo_query sometimes returns the numbers with hidden characters as well. Use no html to remove those.

Semantic Mediawiki

Query depth

There is a limit on how large and complex SMW queries can be; you can use format=debug to get an idea what is happening with the query.

Some ways to solve this problem:

• reduce the number of conditions in the query
• reduce the number of subqueries (i.e. <q></q>
• summarize common conditions into a concept
• use a lua module for further iteration purposes

Redirect pages may cause issues with properties

Can occur due to:

• moving pages (with properties) and leaving a redirect
• editing redirect pages
• deleting pages that contain redirects

Solution (steps):

1. validate the properties on the real page are set as they should
   1. if missing or incorrect properties are present, null-edit the page
   2. if this is still the case, do a minor edit on the page such as adding a space

Text search not working properly

Causes and solutions

1. Text after 40th character is not searched
   • Try limiting your search to the first portion of the text
   • Use other means of searching (i.e. other properties)
   • When working on template make sure the characters intended for search are not too long
   • SMW queries can support Full-text searches but this site does not have all the requirements for it.
2. Text may include HTML/wikitext
   • In case of wiki links screwing search up consider searching for words only, e.x. ~Life*Leech

Properties or values were changed in a template but they don't show up in the properties

Such changes generally take a while (up to several hours) to go though, esp. on templates that are used in many places.

Solutions:

• Just wait it out (preferred)
• perform null-edits (edit with no changes) on all pages using the template