WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_category_link()

get_category_link( int|object $category ): string

In this article

Back to top

Retrieves category link URL.

Description

See also

Parameters

$categoryint|objectrequired
Category ID or object.

Return

string Link on success, empty string if category does not exist.

More Information

This function returns the correct url for a given Category ID. In a Plugin or Theme, it can be used as early as the setup_theme Action. Any earlier usage, including plugins_loaded, generates a Fatal Error.

Source

function get_category_link( $category ) {	if ( ! is_object( $category ) ) {	$category = (int) $category;	}	$category = get_term_link( $category );	if ( is_wp_error( $category ) ) {	return '';	}	return $category; }

View all references View on Trac View on GitHub

UsesDescription
get_term_link()wp-includes/taxonomy.php

Generates a permalink for a taxonomy term archive.

is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Used byDescription
get_tag_link()wp-includes/category-template.php

Retrieves the link to the tag.

get_the_category_list()wp-includes/category-template.php

Retrieves category list for a post in either HTML list or custom format.

wp_xmlrpc_server::mw_getCategories()wp-includes/class-wp-xmlrpc-server.php

Retrieves the list of categories on a given blog.

Changelog

VersionDescription
1.0.0Introduced.

User Contributed Notes

  1. Skip to note 4 content
    Codex
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Category Link

    <?php // Get the ID of a given category $category_id = get_cat_ID( 'Category Name' ); // Get the URL of this category $category_link = get_category_link( $category_id ); ?> <!-- Print a link to this category --> <a href="<?php echo esc_url( $category_link ); ?>" title="Category Name">Category Name</a>
  2. Skip to note 5 content
    rdmi
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Worth remembering that a category_id is a term_id and not a term_taxonomy_id

    (And, yes, you can figure that out from reading the code. But these sometimes will be the same, fooling some people into thinking that the term_taxonomy_id was right. But sooner or later you will probably get examples where they are different, and then things do not work right.)

  3. Skip to note 6 content
    sammuelhg
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Example of a categories list with the Bootstrap 5 card and badge count.

    <div class="card border border-0 m-2" style="width: 250px;"> <div class="card-header bg-primary text-white"> <h5>Categorias</h5> </div> <?php foreach ( $categories as $category ) { echo '<a class="text-decoration-none list-group-item list-group-item-action text-dark" href="' . esc_attr( esc_url( get_category_link( $category->term_id ) ) ) . '">; echo '<div class="d-flex justify-content-between align-items-start">'; echo esc_html( $category->name ); echo '<span class="badge bg-primary rounded-pill">' . esc_html( $category->count ) . '</span>'; echo '</div>'; echo '</a>'; } ?> </div>

You must log in before being able to contribute a note or feedback.