Help:Infobox migration

UCP

The infobox migration tool and Special:Insights/nonportableinfoboxes are not available under UCP. A step-by-step process guide is available for additional help.

Legacy

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

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.

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

• Browse and search other help pages at Help:Contents
• Check Fandom Community Central for sources of further help and support
• Check Contacting Fandom for how to report any errors or unclear steps in this article