URL rewrites

Add, edit, delete 301/302 redirect rules for storefront URLs; bulk import and export via Excel.

The URL rewrites screen is where you manage rules that send visitors from one address to another in your storefront. When a product or category URL changes, a campaign page is removed, or the site structure is updated, redirects are defined to prevent old URLs from leading to empty pages and to preserve SEO value. Each rule consists of a source url, a target url, a redirect type (301 or 302), and a match type. You can add rules individually, bulk upload via Excel, and export the current list to Excel.

Accessing the screen

In the left menu, Headless CMS › URL rewrites.
In the Items window opened by the products icon in the top bar (All products), the URL rewrites shortcut under the Headless CMS row.

If you don’t see it in the menu, your account lacks permission for this screen. If you can see the list but not the Add redirect, Import from Excel buttons or the edit/delete icons in rows, your account has read-only access.

The screen URL preserves applied filters; you can share the filtered list link.

Screen sections

Page title URL rewrites, subtitle Source-to-target redirect rules for the storefront. Top right: Export to Excel and (if you have write permission) Import from Excel and Add redirect buttons.
Filter card: always visible filters, Clear, Detailed filters, and Filter buttons.
List card: Per page selection, "Filter result: … records" count, refresh icon (Retry), Columns menu, table, and pagination.

Filtering and searching

Field	Purpose	Tip
Setup	Selects which store setup the redirects belong to.	Visible only if you have multiple setups in your workspace. Defaults to Default setup if empty.
Source url	Filters by source url.	Always visible.
Target url	Filters by target url.	Always visible.
Match	Filters by match type: Exact match, Starts with, Contains.	Inside Detailed filters. Defaults to All if empty.
Routing	Filters by redirect type: 301 permanent, 302 temporary.	Inside Detailed filters. Defaults to All if empty.

Filters are not applied as you type; press Filter or Enter in a field. The Filter button highlights if there are unapplied changes. Clear empties all filters (including Setup) and reloads the list immediately.

From the Detailed filters menu (Pick the filters you want to use), you select additional filters to display; your choice is remembered in your browser and the count of active extra filters appears next to the button. Removing a filter’s check clears its value; press Filter to apply changes. Opening a link with a filled filter shows it even if unchecked.

If you have multiple setups, add/edit/delete/import/export operations apply to the applied Setup filter. Make sure to select the correct setup and press Filter before proceeding.

List

Column	Meaning
Source url	The visitor’s incoming address, shown in monospace font. Cannot be hidden.
Target url	The address to which the visitor is redirected, in monospace font.
Routing	Badge: blue 301 permanent or orange 302 temporary. If undefined, raw value is shown.
Match	Match type name with gray code: Exact match `EQ`, Starts with `SW`, Contains `CT`. Codes stored lowercase (e.g. `eq`) still show the name. If undefined, raw value is shown.

If you have write permission, pencil (Edit) and red trash bin (Delete) icons appear at the row end. Clicking a row does not open a page.

From the Columns menu, you can hide columns except Source url; your choice is remembered in your browser. Columns cannot be sorted by header clicks. Page size can be 25, 50, or 100; default is 25. Page and size changes apply immediately; changing page size returns you to the first page. If no records match the filter, No records found and Try changing the filters. appear.

Redirect and match types

Value	Meaning
301 permanent	Permanent redirect. Select if the address moved permanently and the old URL will not be reused.
302 temporary	Temporary redirect. Select if the old URL will be reused later (e.g., a seasonal campaign page).
Exact match (`EQ`)	For addresses exactly matching the source url.
Starts with (`SW`)	For addresses starting with the source url.
Contains (`CT`)	For addresses containing the source url.

Operations

Adding a redirect

Click the Add redirect button at top right. The New redirect window opens.
Enter the old address in Source url (e.g., /old-url).
Enter the new address in Target url (e.g., /new-url).
Select the redirect type; default is 301 permanent.
Select the match type; default is Exact match.
Click Save.

If successful, a Saved notification appears, the window closes, and the list refreshes.

Field	Required	Description / rule
Source url	Yes	Must start with "/"; a source url not starting with "/" matches no storefront address. If invalid, the warning Source address must start with "/". appears below the field.
Target url	Yes	Must start with "/" and be different from source. This rule is always shown below the field; if violated, the text turns red.
Routing	Yes	301 permanent or 302 temporary.
Match	Yes	Exact match, Starts with, or Contains.

Save is disabled if both addresses are not filled or rules are violated. Leading and trailing spaces are trimmed on save.

If the same source url already exists, saving is blocked with a red This source url already exists notification and the window remains open. In this case, find and edit the existing record. If saving fails for another reason, a Something went wrong notification appears.

Editing a redirect

Click the pencil icon (Edit) in the row. The Edit redirect window opens with current values.
Make changes. Field rules are the same as for adding.
Click Save or Cancel to abort.

Changing the source url to one already used by another record triggers the This source url already exists warning.

Old records: Some old records may have invalid redirect or match types stored. Opening such a record shows the value as "… (old value)" in the dropdown, with a warning below (e.g., "…" is not a valid redirect type; select 301 or 302.) and a note at the bottom: This record was saved with an invalid value in the old system. Select a valid value to save. Save remains disabled until a valid value is selected. Records with lowercase match codes (e.g., eq) appear normal in the list but show as old values in edit; reselect the same type and save.

Deleting a redirect

Click the red trash bin icon (Delete) in the row.
The Delete window opens showing the rule as "source → target redirect will be deleted. This action cannot be undone."
Confirm by clicking red Delete or cancel with Cancel. The window cannot be closed during deletion.

If successful, a Deleted notification appears and the list refreshes. Deletion is irreversible; to restore, add the rule again.

Exporting to Excel

Used to back up, bulk edit, or share with others. This button is visible with read permission.

Apply desired filters (press Filter).
Click Export to Excel. The button shows Preparing… while generating.

The file downloads as url-yonlendirmeleri-<date>.xlsx and a Excel file downloaded (N records) notification appears. The file contains only records matching applied filters. If the record count exceeds export limit, a warning appears in orange: Limit exceeded; file contains first records only. Narrow filter and export again. In this case, narrow the list and export in parts.

The exported file format matches the import format; you can edit and re-import via Import from Excel.

Importing from Excel

Used to add or update many redirects at once. Import is two-step: preview first, no changes written without confirmation.

File format: First sheet used, first row is header.

Column	Content
A	Source url
B	Target url
C	Redirect: `301` or `302`; default `301` if empty
D	Match: `EQ`, `SW`, or `CT`; default `EQ` if empty

If the source url exists, the record is updated; otherwise, added. Max 5,000 rows.

Click Import from Excel. The Import redirects window opens.
Drop or select a file in Choose a file or drop it here. Only .xlsx files accepted; others show Only .xlsx files are accepted. warning.
Review preview: badges show counts of To add, To update, Unchanged, and Skipped. If skipped rows exist, a table with Rows and Reason columns appears below.
If acceptable, click Import (N writes) where N is total to add and update. Button shows Saving… during write.

If file cannot be read or preview fails, reason appears below file area and import button is disabled.

When done, an Import completed notification shows counts, the window closes, and the list refreshes. If no changes to write, The file contains no changes to write. appears and import button is disabled. The window cannot be closed during import. To try another file, drop it in the area; preview refreshes.

Skipped row reasons:

Reason	Action
Source and target paths are required.	Fill columns A and B.
Source and target paths must start with "/".	Add "/" at start of addresses.
Source and target paths cannot be the same.	Correct target or delete row.
A path can be at most 2000 characters.	Shorten the address.
Redirect type must be 301 or 302.	Enter `301` or `302` in column C or leave empty.
Match type must be EQ, SW or CT.	Enter `EQ`, `SW`, or `CT` in column D or leave empty.
The same source url appears later in the file; last row is used.	Informational: last occurrence is used. Delete duplicates if undesired.

Common issues

Save button remains disabled. One address is empty, does not start with "/", or target equals source. If the record has old values, you must select valid Routing or Match. Check warnings below fields.

"This source url already exists" warning appears. You cannot define a second rule for the same source url. Find the existing record using the Source url filter and edit it.

I don’t see add, import, edit, or delete buttons. Your account has read-only access on this screen. You can view the list and export to Excel; write permission is required for changes.

The list is empty. No records match the applied filters or no redirects are defined for this setup. Press Clear; if you have multiple setups, select the correct one in the Setup filter.

Excel file does not contain all records. Export respects applied filters. If the "Limit exceeded" warning appears, the file contains only the first records; narrow the filter and export in parts.

Some rows were skipped during import. Check the Reason column in the preview; fix rows per the table above and reload the file. Skipped rows are not written; others are.