📘 This article explains how to configure Replace URL optimizations in PageWorkers. PageWorkers is part of Botify's Activation Suite, available as an option with all Botify plans.
Overview
The configuration step in the PageWorkers wizard interface differs based on the type of optimization you are creating. This article explains how to configure Replace URL optimizations, which allow you to replace all occurrences of specified URLs within your scope and, optionally, have PageWorkers respond with a redirect to requests for the source URLs.
Replace URL Use Cases
The following are the primary use cases for the Replace URL type of optimization:
Remove 301 and 302s from your website and replace them with a new URL.
Replace links when your content location changes. For example, if you want to replace an outdated article with an updated article, this optimization can replace all of the links on your site pointing to the outdated article with links to the new article. You can choose to let bots access the original content (the "Don't redirect" option) or direct them to the new content (one of the "Redirect" options).
Configuring Replace URL Optimizations
To configure Replace URL optimizations:
Follow the instructions to create a PageWorkers optimization.
On the Configure step, select how you want to identify the URLs to be replaced:
Crawled URLs: Find URLs from your most recent Botify crawl.
CSV File: Upload URLs in bulk.
Specific URLs: Identify individual URLs on the next wizard step.
Select the action to occur when the source URLs are requested. You define the source and destination URLs in the wizard's next step.
Redirect 301 to destination URL: PageWorkers will replace the source URL with the replacement URL on all pages within your scope and add a 301 redirect for requests to the source URL.
Redirect 302 to destination URL: PageWorkers will replace the source URL with the replacement URL on all pages within your scope and add a 302 redirect for requests to the source URL.
Don't redirect: PageWorkers will replace the source URL with the replacement URL on all pages within your scope but will not add a redirect for requests to the source URL.
Click the Next button after defining all elements for this optimization. If you chose the "Specific URLs" option in Step 2, you will advance to the Apply step. The other options advance you to the Deploy step.
Identifying URLs by CSV
To identify the URLs to be replaced in bulk:
Select the CSV File option.
Click the CSV template link to download the template for the selected optimization type.
Add the URLs and values to the template, one source and destination URL pair per row, and then save the file in CSV format.
Click the Upload CSV File button, select your created file, and then click Open.
Applying Replace URL Optimizations
When you choose to identify URLs to replace manually, the Apply step is displayed after the configuration step.
To apply Replace URL optimizations:
In the Source URL field, type the full URL to be replaced by the destination URL (new URL). This URL must be within the scope defined in Step 1 of creating the optimization.
In the Destination URL field, type the full URL of the new URL that will replace the source URL. This URL does not have to be within the scope you defined in Step 1 of creating the optimization.
Click the Add a URL link to identify additional sources and destination URLs.
Click Next.
Read next: