{"id":13180,"date":"2025-06-12T17:09:10","date_gmt":"2025-06-12T17:09:10","guid":{"rendered":"https:\/\/www.kadencewp.com\/help-center\/?post_type=docs&#038;p=13180"},"modified":"2026-04-22T14:41:50","modified_gmt":"2026-04-22T14:41:50","password":"","slug":"bulk-update-links-and-text","status":"publish","type":"docs","link":"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/bulk-update-links-and-text\/","title":{"rendered":"How to Bulk Update Links and Text (Search &amp; Replace)"},"content":{"rendered":"\n<p>You may find it necessary to change or update text, images or links in your WordPress database. Searching for the targeted content and manually updating a document is quite easy in WP Admin but what if the content appears on multiple or even hundreds of posts or perhaps in custom fields?<\/p>\n\n\n\n<p><a href=\"https:\/\/wordpress.org\/plugins\/better-search-replace\/\" target=\"_blank\" rel=\"noopener\"><strong>Better Search Replace<\/strong><\/a> provides a user-friendly way to search and replace text or URLs for your WordPress site. This plugin is perfect for developers and site owners performing database-level changes, particularly during site migrations or large-scale content updates.  The following document will guide you through the installation and basic usage of this plugin.<\/p>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50, .wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50[data-kb-block=\"kb-adv-heading13180_b4c498-50\"]{padding-top:var(--global-kb-spacing-xs, 1rem);padding-right:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-xs, 1rem);padding-left:var(--global-kb-spacing-sm, 1.5rem);font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50[data-kb-block=\"kb-adv-heading13180_b4c498-50\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_b4c498-50[data-kb-block=\"kb-adv-heading13180_b4c498-50\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<div class=\"kt-adv-heading13180_b4c498-50 wp-block-kadence-advancedheading has-theme-palette-9-color has-text-color has-theme-palette-5-background-color has-background\" data-kb-block=\"kb-adv-heading13180_b4c498-50\"><strong>WARNING:<\/strong>  <em>Better Search Replace<\/em> is a very powerful tool.  As such, a full backup of your database is recommended before making any changes to your site.  Incorrect usage can cause broken links, or worse, your site to fail.  The plugin does NOT have an &#8220;undo&#8221; feature.  Please use caution when working with this tool and defer to a professional if you&#8217;re unsure how to use it.<\/div>\n\n\n<style>.kb-table-of-content-nav.kb-table-of-content-id13180_bfdf12-01 .kb-table-of-content-wrap{padding-top:var(--global-kb-spacing-sm, 1.5rem);padding-right:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-sm, 1.5rem);padding-left:var(--global-kb-spacing-sm, 1.5rem);}.kb-table-of-content-nav.kb-table-of-content-id13180_bfdf12-01 .kb-table-of-contents-title-wrap{padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.kb-table-of-content-nav.kb-table-of-content-id13180_bfdf12-01 .kb-table-of-contents-title{font-weight:regular;font-style:normal;}.kb-table-of-content-nav.kb-table-of-content-id13180_bfdf12-01 .kb-table-of-content-wrap .kb-table-of-content-list{font-weight:regular;font-style:normal;margin-top:var(--global-kb-spacing-sm, 1.5rem);margin-right:0px;margin-bottom:0px;margin-left:0px;}<\/style>\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c, .wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c[data-kb-block=\"kb-adv-heading13180_907cd6-4c\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c[data-kb-block=\"kb-adv-heading13180_907cd6-4c\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_907cd6-4c[data-kb-block=\"kb-adv-heading13180_907cd6-4c\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 id=\"use-cases\" class=\"kt-adv-heading13180_907cd6-4c wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_907cd6-4c\">Common Use Cases for Search and Replace<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You&#8217;ve changed your site&#8217;s domain name or migrated from a staging environment.<\/li>\n\n\n\n<li>A page URL has changed and all links need to be updated.<\/li>\n\n\n\n<li>An external URL that you frequently link to has changed.<\/li>\n\n\n\n<li>Update a commonly used image that was deleted or is outdated.<\/li>\n\n\n\n<li>Replace old &#8220;http&#8221; links with &#8220;https&#8221; to fix mixed content issues.<\/li>\n\n\n\n<li>Fix a common typo or spelling change (i.e. &#8220;e-commerce&#8221; \u2192 &#8220;eCommerce&#8221;).<\/li>\n\n\n\n<li>Your business name\/branding has changed.<\/li>\n\n\n\n<li>Replace an old shortcode (i.e. [old_shortcode] \u2192 [new_shortcode]).<\/li>\n<\/ul>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22, .wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22[data-kb-block=\"kb-adv-heading13180_32f47a-22\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22[data-kb-block=\"kb-adv-heading13180_32f47a-22\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_32f47a-22[data-kb-block=\"kb-adv-heading13180_32f47a-22\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 id=\"plugin-installation\" class=\"kt-adv-heading13180_32f47a-22 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_32f47a-22\">Plugin Installation<\/h2>\n\n\n<style>.kb-row-layout-id13180_5af364-ef > .kt-row-column-wrap{align-content:start;}:where(.kb-row-layout-id13180_5af364-ef > .kt-row-column-wrap) > .wp-block-kadence-column{justify-content:start;}.kb-row-layout-id13180_5af364-ef > .kt-row-column-wrap{column-gap:var(--global-kb-gap-md, 2rem);row-gap:var(--global-kb-gap-md, 2rem);padding-top:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-sm, 1.5rem);grid-template-columns:minmax(0, 1fr);}.kb-row-layout-id13180_5af364-ef > .kt-row-layout-overlay{opacity:0.30;}@media all and (max-width: 1024px){.kb-row-layout-id13180_5af364-ef > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}@media all and (max-width: 767px){.kb-row-layout-id13180_5af364-ef > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}<\/style><div class=\"kb-row-layout-wrap kb-row-layout-id13180_5af364-ef alignnone wp-block-kadence-rowlayout\"><div class=\"kt-row-column-wrap kt-has-2-columns kt-row-layout-row kt-tab-layout-inherit kt-mobile-layout-row kt-row-valign-top\">\n<style>.kadence-column13180_40733e-04 > .kt-inside-inner-col,.kadence-column13180_40733e-04 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column13180_40733e-04 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column13180_40733e-04 > .kt-inside-inner-col{flex-direction:column;}.kadence-column13180_40733e-04 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column13180_40733e-04 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column13180_40733e-04{position:relative;}@media all and (max-width: 1024px){.kadence-column13180_40733e-04 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column13180_40733e-04 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column13180_40733e-04\"><div class=\"kt-inside-inner-col\">\n<ol class=\"wp-block-list\">\n<li>In WP Admin, go to Plugins \u2192 <strong>Add Plugin<\/strong><\/li>\n\n\n\n<li>Search for &#8220;<strong>Better Search Replace<\/strong>&#8221; (be sure to select the plugin by <em>WP Engine<\/em>).<\/li>\n\n\n\n<li>Click <strong>Install Now<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Activate<\/strong>.<\/li>\n<\/ol>\n<\/div><\/div>\n\n\n<style>.kadence-column13180_b2caf8-14 > .kt-inside-inner-col,.kadence-column13180_b2caf8-14 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column13180_b2caf8-14 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column13180_b2caf8-14 > .kt-inside-inner-col{flex-direction:column;}.kadence-column13180_b2caf8-14 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column13180_b2caf8-14 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column13180_b2caf8-14{position:relative;}@media all and (max-width: 1024px){.kadence-column13180_b2caf8-14 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column13180_b2caf8-14 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column13180_b2caf8-14\"><div class=\"kt-inside-inner-col\"><style>.kb-image13180_29550c-da .kb-image-has-overlay:after{opacity:0.3;}<\/style>\n<figure class=\"wp-block-kadence-image kb-image13180_29550c-da size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"311\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-1024x311.png\" alt=\"Install Better Search Replace plugin\" class=\"kb-img wp-image-13182\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-1024x311.png 1024w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-300x91.png 300w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-768x233.png 768w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-1536x466.png 1536w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-2048x622.png 2048w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-9.30.21\u202fAM-360x109.png 360w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n<\/div><\/div>\n\n<\/div><\/div>\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d, .wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d[data-kb-block=\"kb-adv-heading13180_1e1c0e-2d\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d[data-kb-block=\"kb-adv-heading13180_1e1c0e-2d\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_1e1c0e-2d[data-kb-block=\"kb-adv-heading13180_1e1c0e-2d\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 id=\"using-better-search-replace\" class=\"kt-adv-heading13180_1e1c0e-2d wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_1e1c0e-2d\">Using Better Search Replace<\/h2>\n\n\n<style>.kb-row-layout-id13180_154c6f-f7 > .kt-row-column-wrap{align-content:start;}:where(.kb-row-layout-id13180_154c6f-f7 > .kt-row-column-wrap) > .wp-block-kadence-column{justify-content:start;}.kb-row-layout-id13180_154c6f-f7 > .kt-row-column-wrap{column-gap:var(--global-kb-gap-md, 2rem);row-gap:var(--global-kb-gap-md, 2rem);padding-top:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-sm, 1.5rem);grid-template-columns:minmax(0, calc(50% - ((var(--global-kb-gap-md, 2rem) * 1 )\/2)))minmax(0, calc(50% - ((var(--global-kb-gap-md, 2rem) * 1 )\/2)));}.kb-row-layout-id13180_154c6f-f7 > .kt-row-layout-overlay{opacity:0.30;}@media all and (max-width: 1024px){.kb-row-layout-id13180_154c6f-f7 > .kt-row-column-wrap{grid-template-columns:minmax(0, 2fr) minmax(0, 1fr);}}@media all and (max-width: 767px){.kb-row-layout-id13180_154c6f-f7 > .kt-row-column-wrap{grid-template-columns:minmax(0, 1fr);}}<\/style><div class=\"kb-row-layout-wrap kb-row-layout-id13180_154c6f-f7 alignnone wp-block-kadence-rowlayout\"><div class=\"kt-row-column-wrap kt-has-2-columns kt-row-layout-left-golden kt-tab-layout-inherit kt-mobile-layout-row kt-row-valign-top\">\n<style>.kadence-column13180_46e17b-f4 > .kt-inside-inner-col,.kadence-column13180_46e17b-f4 > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column13180_46e17b-f4 > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column13180_46e17b-f4 > .kt-inside-inner-col{flex-direction:column;}.kadence-column13180_46e17b-f4 > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column13180_46e17b-f4 > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column13180_46e17b-f4{position:relative;}@media all and (max-width: 1024px){.kadence-column13180_46e17b-f4 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column13180_46e17b-f4 > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column13180_46e17b-f4\"><div class=\"kt-inside-inner-col\">\n<ol class=\"wp-block-list\">\n<li>Go to Tools \u2192 <strong>Better Search Replace<\/strong>.<\/li>\n\n\n\n<li>Enter a <strong>Search for<\/strong> value.<\/li>\n\n\n\n<li>Enter a <strong>Replace with<\/strong> value.<\/li>\n\n\n\n<li><strong>Select tables<\/strong> to search (typically <em>_posts<\/em> and\/or <em>_postmeta<\/em>)<\/li>\n\n\n\n<li>Leave <strong>Run as dry run<\/strong> checked.<\/li>\n\n\n\n<li>Click <strong>Run Search\/Replace<\/strong> to see how many replacements will occur.<\/li>\n\n\n\n<li>Once you are comfortable, uncheck <strong>Run as dry run<\/strong>.<\/li>\n\n\n\n<li>Click <strong>Run Search\/Replace<\/strong> again to complete the update.<\/li>\n<\/ol>\n<\/div><\/div>\n\n\n<style>.kadence-column13180_61f99b-ac > .kt-inside-inner-col,.kadence-column13180_61f99b-ac > .kt-inside-inner-col:before{border-top-left-radius:0px;border-top-right-radius:0px;border-bottom-right-radius:0px;border-bottom-left-radius:0px;}.kadence-column13180_61f99b-ac > .kt-inside-inner-col{column-gap:var(--global-kb-gap-sm, 1rem);}.kadence-column13180_61f99b-ac > .kt-inside-inner-col{flex-direction:column;}.kadence-column13180_61f99b-ac > .kt-inside-inner-col > .aligncenter{width:100%;}.kadence-column13180_61f99b-ac > .kt-inside-inner-col:before{opacity:0.3;}.kadence-column13180_61f99b-ac{position:relative;}@media all and (max-width: 1024px){.kadence-column13180_61f99b-ac > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}@media all and (max-width: 767px){.kadence-column13180_61f99b-ac > .kt-inside-inner-col{flex-direction:column;justify-content:center;}}<\/style>\n<div class=\"wp-block-kadence-column kadence-column13180_61f99b-ac\"><div class=\"kt-inside-inner-col\"><style>.kb-image13180_4d638f-79 .kb-image-has-overlay:after{opacity:0.3;}<\/style>\n<figure class=\"wp-block-kadence-image kb-image13180_4d638f-79 size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"901\" height=\"1024\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-901x1024.png\" alt=\"Better Search Replace screenshot\" class=\"kb-img wp-image-13202\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-901x1024.png 901w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-264x300.png 264w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-768x873.png 768w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-1351x1536.png 1351w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-1801x2048.png 1801w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot-360x409.png 360w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Better-search-replace-screenshot.png 1985w\" sizes=\"auto, (max-width: 901px) 100vw, 901px\" \/><\/figure>\n<\/div><\/div>\n\n<\/div><\/div>\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37, .wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37[data-kb-block=\"kb-adv-heading13180_e5538c-37\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37[data-kb-block=\"kb-adv-heading13180_e5538c-37\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_e5538c-37[data-kb-block=\"kb-adv-heading13180_e5538c-37\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 id=\"search-replace-notes\" class=\"kt-adv-heading13180_e5538c-37 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_e5538c-37\">Search\/Replace Notes<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Selecting the <em>_posts<\/em> table will search the content of all pages, posts, and custom post types (including all revisions).<\/li>\n\n\n\n<li>Search will match partial URLs.  Use caution when replacing similar URLs such as <em>https:\/\/mysite.com\/category\/blogging\/<\/em> which will also partially match <em>https:\/\/mysite.com\/category\/blogging\/seo\/<\/em>.  One option would be to add quotes to the URL (i.e. <em>&#8220;https:\/\/mysite.com\/category\/blogging\/&#8221;<\/em>)<\/li>\n\n\n\n<li>Searching will find and replace content in serialized values.  This is common when array data is stored in the <em>_postmeta<\/em> or <em>_options<\/em> tables.<\/li>\n<\/ul>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58, .wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58[data-kb-block=\"kb-adv-heading13180_cf3952-58\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58[data-kb-block=\"kb-adv-heading13180_cf3952-58\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_cf3952-58[data-kb-block=\"kb-adv-heading13180_cf3952-58\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 id=\"troubleshooting\" class=\"kt-adv-heading13180_cf3952-58 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_cf3952-58\">Troubleshooting<\/h2>\n\n\n\n<p>Under certain conditions, you may run into the following error:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"\" class=\"\">An error occurred processing your request. Try decreasing the \"Max Page Size\", or contact support.<\/code><\/pre>\n\n\n\n<p>To fix this, go to the plugin settings (Tools \u2192 Better Search Replace and click <strong>Settings<\/strong> in the menu bar) and reduce &#8220;<strong>Max Page Size<\/strong>&#8221; to 1000.<\/p>\n\n\n<style>.kb-image13180_1420e6-cf .kb-image-has-overlay:after{opacity:0.3;}<\/style>\n<figure class=\"wp-block-kadence-image kb-image13180_1420e6-cf size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"553\" src=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-1024x553.png\" alt=\"Better Search Replace Settings page\" class=\"kb-img wp-image-13212\" srcset=\"https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-1024x553.png 1024w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-300x162.png 300w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-768x415.png 768w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-1536x830.png 1536w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM-360x195.png 360w, https:\/\/www.kadencewp.com\/help-center\/wp-content\/uploads\/sites\/14\/2025\/06\/Screenshot-2025-06-11-at-11.08.14\u202fAM.png 2010w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>For additional assistance with this plugin, please reach out to the <a href=\"https:\/\/wordpress.org\/support\/plugin\/better-search-replace\/\" target=\"_blank\" rel=\"noopener\">plugin developer<\/a>.<\/p>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e, .wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e[data-kb-block=\"kb-adv-heading13180_f8abef-3e\"]{padding-top:var(--global-kb-spacing-xs, 1rem);padding-right:var(--global-kb-spacing-sm, 1.5rem);padding-bottom:var(--global-kb-spacing-xs, 1rem);padding-left:var(--global-kb-spacing-sm, 1.5rem);text-align:center;font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e[data-kb-block=\"kb-adv-heading13180_f8abef-3e\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_f8abef-3e[data-kb-block=\"kb-adv-heading13180_f8abef-3e\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<div class=\"kt-adv-heading13180_f8abef-3e wp-block-kadence-advancedheading has-theme-palette-9-color has-text-color has-theme-palette-5-background-color has-background\" data-kb-block=\"kb-adv-heading13180_f8abef-3e\">Note: <strong>Better Search Replace<\/strong> and <strong>WP Migrate<\/strong> are products of Delicious Brains Inc. and\/or WPEngine, Inc.  They are not Kadence products. For support and questions regarding either of these plugins, please contact the plugin developer.<\/div>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b, .wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b[data-kb-block=\"kb-adv-heading13180_7d6875-8b\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b[data-kb-block=\"kb-adv-heading13180_7d6875-8b\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_7d6875-8b[data-kb-block=\"kb-adv-heading13180_7d6875-8b\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 id=\"pro-paid-features\" class=\"kt-adv-heading13180_7d6875-8b wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_7d6875-8b\">Pro\/Paid Features<\/h2>\n\n\n\n<p>Additional features such as previewing changes, regular expression search and more are available when you upgrade to <a href=\"https:\/\/deliciousbrains.com\/better-search-replace\/upgrade\/\" target=\"_blank\" rel=\"noopener\">WP Migrate<\/a>.<\/p>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef, .wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef[data-kb-block=\"kb-adv-heading13180_82ec37-ef\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef[data-kb-block=\"kb-adv-heading13180_82ec37-ef\"] mark.kt-highlight{font-style:normal;color:#f76a0c;-webkit-box-decoration-break:clone;box-decoration-break:clone;padding-top:0px;padding-right:0px;padding-bottom:0px;padding-left:0px;}.wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading13180_82ec37-ef[data-kb-block=\"kb-adv-heading13180_82ec37-ef\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading13180_82ec37-ef wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading13180_82ec37-ef\">Additional Plugin Options<\/h2>\n\n\n\n<p>Need to replace images\/media or looking for other plugin options?  Try one of these plugins:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/wordpress.org\/plugins\/search-replace-wpcode\/\" target=\"_blank\" rel=\"noopener\">Search &amp; Replace by WPCode<\/a> &#8211; In addition to text\/link search &amp; replace, this plugin also includes replacing media files.<\/li>\n\n\n\n<li><a href=\"https:\/\/wordpress.org\/plugins\/enable-media-replace\/\" target=\"_blank\" rel=\"noopener\">Enable Media Replace by ShortPixel<\/a> &#8211; In addition to replacing images and bulk updating your site, this plugin also allows you to replace an image using the same name (as well as ID and URL) so no need to update all of your posts.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>You may find it necessary to change or update text, images or links in your WordPress database. Searching for the targeted content and manually updating a document is quite easy in WP Admin but what if the content appears on multiple or even hundreds of posts or perhaps in custom fields? Better Search Replace provides&#8230;<\/p>\n","protected":false},"author":227588,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kadence_starter_templates_imported_post":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"doc_category":[394],"doc_tag":[],"knowledge_base":[6],"class_list":["post-13180","docs","type-docs","status-publish","hentry","doc_category-theme-general","knowledge_base-kadence-theme"],"year_month":"2026-04","word_count":650,"total_views":"2480","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Anthony Paparelli","author_link":"https:\/\/www.kadencewp.com\/help-center\/author\/anthony-paparelli\/"},"doc_category_info":[{"term_name":"General WordPress","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/theme-general\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"Kadence Theme","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/","term_slug":"kadence-theme"}],"knowledge_base_slug":["kadence-theme"],"taxonomy_info":{"doc_category":[{"value":394,"label":"General WordPress"}],"knowledge_base":[{"value":6,"label":"Kadence Theme"}]},"featured_image_src_large":false,"comment_info":0,"_links":{"self":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/13180","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/users\/227588"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/comments?post=13180"}],"version-history":[{"count":21,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/13180\/revisions"}],"predecessor-version":[{"id":13295,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/13180\/revisions\/13295"}],"wp:attachment":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/media?parent=13180"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_category?post=13180"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_tag?post=13180"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/knowledge_base?post=13180"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}