Querying Nodes by Category Term in Drupal 8: A Guide with Code Examples

In Drupal 8, querying nodes based on a specific category term and fetching all related nodes or metadata is a common and essential task. This process can be efficiently handled using Drupal’s Entity API and Database API. Let’s explore how to do this with practical code examples.

Get drupal nodes by category

Understanding the Basics

In Drupal, categories are typically managed using taxonomy terms. Nodes can be associated with one or several of these terms. To query nodes based on a category term, you first identify the term and then query the nodes linked to it.

Example Scenario

Suppose we have a taxonomy term called “Technology”, and we aim to retrieve all published nodes tagged with this term, including their related nodes and metadata.

Step 1: Fetch the Term ID

To start querying nodes by a term, you need the term’s ID. Here’s how to get it if you know the term’s name:

$term_name = 'Technology';
$term = \Drupal\taxonomy\Entity\Term::loadMultiple([], ['name' => $term_name]);
$term_id = key($term);

Step 2: Query Nodes by Term ID

With the term ID in hand, you can proceed to query nodes associated with it. This is done using the Entity API:

$query = \Drupal::entityQuery('node')
  ->condition('status', 1) // Only published nodes
  ->condition('field_tags', $term_id); // Replace 'field_tags' with your actual field name

$nids = $query->execute();
$nodes = \Drupal\node\Entity\Node::loadMultiple($nids);

Step 3: Fetching Related Nodes and Metadata

Once you have the nodes, you may want to access their related nodes or metadata. For example, if each node has an Entity Reference field pointing to other nodes:

foreach ($nodes as $node) {
  if ($node->hasField('field_related_nodes')) { // Replace with your actual field name
    $related_nodes = $node->get('field_related_nodes')->referencedEntities();
    foreach ($related_nodes as $related_node) {
      // Process each related node
  // Access other metadata as needed

Points to Remember

  • Ensure you replace ‘field_tags’ and ‘field_related_nodes’ with the actual field names in your Drupal setup.
  • It’s crucial to have the necessary permissions and access checks in place.
  • For handling large datasets, consider implementing caching strategies.


Querying nodes by a category term and extracting related nodes or metadata is a straightforward task in Drupal 8, made possible by its flexible APIs. This functionality greatly enhances the ability to create dynamic and content-rich websites. Remember to adapt the code to fit your specific site architecture and data structure requirements.

Leave a Reply

Your email address will not be published. Required fields are marked *