Magento: Generic URL Rewrite Importer

Ever needed to import a large set of generic URL rewrites into Magento? The Generic URL Rewrite Importer for Magento helps you do just that! Xorcode just moved a sizable e-commerce site from WordPress/WooCommerce to Magento. We faced the daunting task of creating over 20,000 URL rewrites since the URL slug structure of Magento ended up being slightly different from what WordPress created.

Manually entering 20,000+ URL rewrites didn’t sound like fun, so we looked at other options. We could buy an extension, or we could write our own for this specific task. We choose to roll our own. Since we wrote it, we’ll share it with you, for free. If you use it and like it, you can always Flattr this article, or send us a donation with PayPal.


Install the extension in your Magento site by logging into your admin panel and going to Magento Connect Manager, which is under the System menu. Once there, use the Direct package file upload option and upload the package file supplied with this article.

Download URL Rewrite Importer

Creating an import profile

Once you have installed the package you need to create a new Advanced Dataflow Profile, you can find this under System > Import/Export > Dataflow - Advanced Profiles. Create your profile, name it anything you want, we suggest “Xorcode Dataflow Urlrewrite Importer.”

Enter the following XML in the Actions XML field:

<action type="dataflow/convert_adapter_io" method="load">
    <var name="type">file</var>
    <var name="path">var/import</var>
    <var name="filename"><![CDATA[url_rewrites.csv]]></var>
    <var name="format"><![CDATA[csv]]></var>
<action type="dataflow/convert_parser_csv" method="parse">
    <var name="delimiter"><![CDATA[,]]></var>
    <var name="enclose"><![CDATA["]]></var>
    <var name="fieldnames">true</var>
    <var name="store"><![CDATA[default]]></var>
    <var name="options"><![CDATA[RP]]></var>
    <var name="number_of_records">50</var>
    <var name="decimal_separator"><![CDATA[.]]></var>
    <var name="adapter">dataflow/convert_adapter_urlrewrite</var>
    <var name="method">parse</var>

You may wish to change the value of store and options to something other than the defaults provided. For instance, if your store’s name is Example, enter example in the CDATA for the store var.

Upload a file called url_rewrites.csv to your web server and place it in the var/import folder of your Magento folder. You may have to create the var/import folder.

Now you are ready to run the profile. Click the Run Profile tab on the Dataflow profile, then click Run Profile in Popup and wait for magic.

If you have any suggestions, ideas, or bug reports, please file issues in our repository.

, , ,