FANDOM


The infobox migration tool makes converting "classic" infoboxes to portable infoboxes easier! A step-by-step process guide is available for additional help.

How to convert an infobox

Find out what should be converted

PortableInsights

Insights list

Go to Special:Insights/nonportableinfoboxes on your community. A list of infoboxes that should be converted on your wiki will appear. Find a page that uses the template you want to convert and open it in a new tab (so you can check your work after you're done), and then click the "Convert!" button.

Migrate

Template page migration box

Some users will also see a box on the right rail of template pages with the heading "Migrate this infobox", allowing quick access to the migration tool.

Review the new infobox template draft

It's a good idea to look at the original template's code and familiarize yourself with the help page for the infobox syntax, both of which are linked in the edit page you just landed on. Not all elements may carry over correctly (or at all) into the draft version — particularly for more complex infoboxes — so make sure to check it over and add to or modify it as needed. Specifically: groups, modification of the values given, and layout will not be migrated. The resulting draft will contain the parameters used in the original template in the order in which they appear. You will then need to reshape the <data> (and other) fields into the format you want the infobox to be; you may find that many functions (like hiding groups, coloring elements inline, or changing image widths) are natively inside the infobox syntax and that some fields are no longer necessary. Be sure also to copy over the <includeonly> and <noinclude> blocks outside the infobox from the original, so that your documentation and categories are preserved.

Once you're happy with it, click "Publish"; this will save the template in the Draft subpage. When you are ready to overwrite the original template, clicking "Approve This Draft" in the module on the right rail will rewrite the original with the Draft you made and will delete the Draft template. The editing history of the original template is preserved, in case it needs to be undone or reverted.

Check your work

Go to the tab with the page you found earlier that used the template and compare what it looked like before to what it looks like now. You may need to reload the page with ?action=purge appended to the URL to see the new infobox.

Migration examples and mentoring

On Fandom's Portability Hub, you can find case studies detailing how other communities migrated their infoboxes. If you get stuck converting your own infobox templates, and could use some guidance, you can also request help for your community!

Further help and feedback

Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+