/upload/bulk

The Bulk Import endpoint provides a mechanism for creating navigations and optionally, precedence rules, without configuring them individually via Command Center. Please note that Precedence Rules can only be defined via the Bulk Import endpoint as of this time.

The Bulk Import service will remove all previously imported navigations before performing a bulk import, these navigations are always hidden in the command center. Only items created by the merchandiser will not be affected during a bulk import. It’s important to note that fields are case sensitive.

Handling Navigations from Command Center

When you import the navigations via bulk upload, only the first 250 navigations will be considered during the search. This 250 includes the navigations from the Command Center. For those 250, the dynamic navigations defined in Command Center will always take priority over the bulk upload. Out of the 250 considered navigations, only the top 50 most relevant navigations will be returned. If the navigation you want to return lies within the bottom of the bulk import list and is not in the 250 considered navigations, you should use the query time includedNavigations parameter to force the inclusion into the top 50.