get_category_link( int|object $category )

Retrieves category link URL.

Description Description

See also See also

Top ↑

Parameters Parameters


(int|object) (Required) Category ID or object.

Top ↑

Return Return

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

Top ↑

Source Source

File: wp-includes/category-template.php

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;

Top ↑

Changelog Changelog

Version Description
1.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by rdmi

    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.)

  2. Skip to note 2 content
    Contributed by Codex

    Category Link

        // 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>

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