{"id":16047,"date":"2025-11-03T11:41:53","date_gmt":"2025-11-03T11:41:53","guid":{"rendered":"https:\/\/www.kadencewp.com\/help-center\/?post_type=docs&#038;p=16047"},"modified":"2026-04-22T16:06:07","modified_gmt":"2026-04-22T16:06:07","password":"","slug":"customize-pagination-using-kadence_pagination_args","status":"publish","type":"docs","link":"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/customize-pagination-using-kadence_pagination_args\/","title":{"rendered":"Customize Pagination in Kadence Theme Using kadence_pagination_args"},"content":{"rendered":"\n<p>The <strong>kadence_pagination_args<\/strong> filter allows developers to <strong>customize the pagination settings<\/strong> used in the Kadence Theme when displaying lists of posts (e.g., on blog archive pages, category archives, or search results).<\/p>\n\n\n\n<p>This filter modifies the arguments passed to the native WordPress function <a href=\"https:\/\/developer.wordpress.org\/reference\/functions\/the_posts_pagination\/\" target=\"_blank\" rel=\"noreferrer noopener nofollow\">the_posts_pagination()<\/a>, giving you full control over pagination appearance and behavior.<\/p>\n\n\n<style>.kb-table-of-content-nav.kb-table-of-content-id16047_7b755e-ff .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-id16047_7b755e-ff .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-id16047_7b755e-ff .kb-table-of-contents-title{font-weight:regular;font-style:normal;}.kb-table-of-content-nav.kb-table-of-content-id16047_7b755e-ff .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-heading16047_f3aa5f-c8, .wp-block-kadence-advancedheading.kt-adv-heading16047_f3aa5f-c8[data-kb-block=\"kb-adv-heading16047_f3aa5f-c8\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading16047_f3aa5f-c8 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading16047_f3aa5f-c8[data-kb-block=\"kb-adv-heading16047_f3aa5f-c8\"] 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-heading16047_f3aa5f-c8 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading16047_f3aa5f-c8[data-kb-block=\"kb-adv-heading16047_f3aa5f-c8\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h2 class=\"kt-adv-heading16047_f3aa5f-c8 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading16047_f3aa5f-c8\">Examples<\/h2>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading16047_d1bab4-57, .wp-block-kadence-advancedheading.kt-adv-heading16047_d1bab4-57[data-kb-block=\"kb-adv-heading16047_d1bab4-57\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading16047_d1bab4-57 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading16047_d1bab4-57[data-kb-block=\"kb-adv-heading16047_d1bab4-57\"] 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-heading16047_d1bab4-57 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading16047_d1bab4-57[data-kb-block=\"kb-adv-heading16047_d1bab4-57\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading16047_d1bab4-57 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading16047_d1bab4-57\">Add Next and Previous Text<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_pagination_args', function( $args ) {\n    $args['prev_text'] = '&lt;span class=\"screen-reader-text\"&gt;' . __( 'Previous Page', 'kadence' ) . '&lt;\/span&gt;Previous ' . Kadence\\kadence()-&gt;get_icon( 'arrow-left', _x( 'Previous', 'previous set of archive results', 'kadence' ) );\n    $args['next_text'] = '&lt;span class=\"screen-reader-text\"&gt;' . __( 'Next Page', 'kadence' ) . '&lt;\/span&gt;Next ' . Kadence\\kadence()-&gt;get_icon( 'arrow-right', _x( 'Next', 'next set of archive results', 'kadence' ) );\n    return $args;\n});<\/code><\/pre>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading16047_a45445-07, .wp-block-kadence-advancedheading.kt-adv-heading16047_a45445-07[data-kb-block=\"kb-adv-heading16047_a45445-07\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading16047_a45445-07 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading16047_a45445-07[data-kb-block=\"kb-adv-heading16047_a45445-07\"] 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-heading16047_a45445-07 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading16047_a45445-07[data-kb-block=\"kb-adv-heading16047_a45445-07\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading16047_a45445-07 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading16047_a45445-07\">Adjust Number of Page Links<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_pagination_args', function( $args ) {\n    $args['mid_size'] = 1; \/\/ Show fewer page numbers\n    return $args;\n});<\/code><\/pre>\n\n\n<style>.wp-block-kadence-advancedheading.kt-adv-heading16047_81a2af-49, .wp-block-kadence-advancedheading.kt-adv-heading16047_81a2af-49[data-kb-block=\"kb-adv-heading16047_81a2af-49\"]{font-style:normal;}.wp-block-kadence-advancedheading.kt-adv-heading16047_81a2af-49 mark.kt-highlight, .wp-block-kadence-advancedheading.kt-adv-heading16047_81a2af-49[data-kb-block=\"kb-adv-heading16047_81a2af-49\"] 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-heading16047_81a2af-49 img.kb-inline-image, .wp-block-kadence-advancedheading.kt-adv-heading16047_81a2af-49[data-kb-block=\"kb-adv-heading16047_81a2af-49\"] img.kb-inline-image{width:150px;vertical-align:baseline;}<\/style>\n<h3 class=\"kt-adv-heading16047_81a2af-49 wp-block-kadence-advancedheading\" data-kb-block=\"kb-adv-heading16047_81a2af-49\">Change Screen Reader Text<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code lang=\"php\" class=\"language-php\">add_filter( 'kadence_pagination_args', function( $args ) {\n    $args['screen_reader_text'] = __( 'Browse through blog pages', 'kadence' );\n    return $args;\n});<\/code><\/pre>\n\n\n\n<p>Add the PHP code snippets using a plugin. Refer to our guide here:\u00a0<strong><em><a href=\"https:\/\/www.kadencewp.com\/help-center\/docs\/kadence-theme\/how-to-add-a-custom-filter-or-function-with-code-snippets\/\">How to add a custom filter or function with Code Snippets<\/a><\/em><\/strong><br><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The kadence_pagination_args filter allows developers to customize the pagination settings used in the Kadence Theme when displaying lists of posts (e.g., on blog archive pages, category archives, or search results). This filter modifies the arguments passed to the native WordPress function the_posts_pagination(), giving you full control over pagination appearance and behavior. Examples Add Next and&#8230;<\/p>\n","protected":false},"author":116562,"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":[405],"doc_tag":[],"knowledge_base":[6],"class_list":["post-16047","docs","type-docs","status-publish","hentry","doc_category-theme-advanced","knowledge_base-kadence-theme"],"year_month":"2026-04","word_count":206,"total_views":"982","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"display_name":"Bonn","author_link":"https:\/\/www.kadencewp.com\/help-center\/author\/bonnjoelelimanco\/"},"doc_category_info":[{"term_name":"Advanced","term_url":"https:\/\/www.kadencewp.com\/help-center\/knowledge-base\/kadence-theme\/theme-advanced\/"}],"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":405,"label":"Advanced"}],"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\/16047","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\/116562"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/comments?post=16047"}],"version-history":[{"count":1,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/16047\/revisions"}],"predecessor-version":[{"id":16048,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/docs\/16047\/revisions\/16048"}],"wp:attachment":[{"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/media?parent=16047"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_category?post=16047"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/doc_tag?post=16047"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/www.kadencewp.com\/help-center\/wp-json\/wp\/v2\/knowledge_base?post=16047"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}