See Also: Community Github Repo - Migrating Assets Between Layouts
One thing we've noticed that has come up over the years is that sometimes you just need to move assets to other layouts--which can be tricky as there isn't a way to do it within the UI.
In needing to do this, we've come up with a fairly easy solution.
Here's how it works:
Launch the tool
Run HuduAssetLayoutTransfer.exe.
The tool opens a GUI window and a terminal window. The terminal is mainly there for logging and troubleshooting.
2. Enter your Hudu connection details
Provide your Hudu URL and API key.
3. Choose the source and destination layouts
Pick the layout you are moving from and the layout you are moving to.
You will then get a confirmation step to review or change the selection.
4. Choose merge behavior for matches
If an incoming source asset appears to match an existing destination asset, you can choose how the tool should behave.
You can also optionally rename the source layout after the transfer is complete.
5. Decide whether to archive the original source assets
This is usually recommended once you are confident the transfer plan is correct.
6. Review field mappings
If the source and destination layouts already line up closely, the tool may offer a direct transfer path.
Otherwise, you will work through the field mapping wizard one destination field at a time.
It might not be perfect yet, but we've moved a few hundred thousand assets between layouts with it already for customers and test accounts. (i think we're probably over a million by now)
Feel free to check this link to make sure you always have the latest and greatest version of the tool: https://github.com/Hudu-Technologies-Inc/Community-Scripts/tree/main/Migrations/Migrating-Assets-Between-Layouts
It's fairly easy to use and we will continue to improve upon it, so any ideas or recommendations are welcome.
For more-specific details and instructions, you can check the dedicated readme, here.
*updated Apr, 2026
If you need help with migrations, you can email our team at [email protected].