Create a CSV file

Rely on the file template .csv which respects the format of the configuration in Stores > Configuration > Blackbird Extensions > Redirection > CSV Configuration.

The first line represents the name of the columns. The columns “source” and “destination” are mandatory but their name could be modified in the configuration.

Each line represents one redirect. The list of available column is :

source

(mandatory)

destination

(mandatory)

store_ids

http_code

active

test_mode

no_route_only

my/url/source

my/url/destination

301

https://mydomain.com/my/url

http://www.an.other.url/external/url

1/2

302

The name of the columns is corresponding to the default values of the field names of columns that are defined in the configuration.

The columns are delimited by the “delimiter” (,), the values are encapsulated by the “enclosure” ( “ ) and the store_ids are delimited by the “store_ids delimiter” ( / ) which gives the following example :

exemple.csv :

“source”,”destination”,”store_ids”,”http_code”,”active”,”test_mode,”no_route_only”

“my/url/source”,”my/url/destination”,”0",”301”,”1”,”1”,”1”

“https://mydomain.com/my/url”,”http://www.an.other.url/external/url”,”1/2",”302”,”0”,”1”,”0”

source	The source url that will be linked to the destination of the redirect.
destination	The destination url that will be linked to the source of the redirect.
store_ids	The store view id(s) on which the redirect will be applied. If id is 0, it means that the redirect will be applied on all store views. The values of stores are delimited by the “store delimiter” in the configuration. Default : /.
http_code	The type of the redirect (301 = permanent / 302 temporary)
active	Define if the redirection is active. (1 = active, 2 = inactive).
test_mode	Défine if the test mode is active for the redirection. (1 = active, 2 = inactive).
no_route_only	Define if “no_route_only” is active. If it is active, the redirect will be done only if the source url is not corresponding to any pages of the store and would lead to a 404 error. If it is inactive, the redirect will be always done. (1 = active, 2 = inactive).

In the case where one of the optional fields is not filed out, the imported redirects will take the default value defined in the configuration.