---
title: "Custom Fields - Product Common Guides"
description: "This guide explains how to output the value of a Joomla custom field and access other properties like its label, ID, or raw value using Smart Tags. A"
url: "https://www.tassos.gr/docs/common/features/smart-tags/custom-fields"
date: "2026-04-07T10:50:29+00:00"
language: "en-GB"
---

[ Home ](https://www.tassos.gr/index.php?option=com_content&view=category&layout=blog&id=24&Itemid=1088) / [ Product Common Guides ](https://www.tassos.gr/index.php?option=com_content&view=category&id=89) / [ Features ](https://www.tassos.gr/index.php?option=com_content&view=category&id=96) / [ Smart Tags ](https://www.tassos.gr/index.php?option=com_content&view=category&id=107)

#  Custom Fields

This guide explains how to output the value of a Joomla custom field and access other properties like its label, ID, or raw value using Smart Tags.

## [Article Custom Fields](#article-custom-fields)

To display the value of a custom field in an article, use:

 ```
{article.field.NAME}
```

Replace NAME with the name (not the label) of your custom field.

Example: If you have a custom field named favoriteColor:

 ```
{article.field.favoriteColor}
```

For more details, see the [Article Smart Tag](https://www.tassos.gr/docs/common/features/smart-tags/article#custom-fields) guide.

## [User Custom Fields](#user-custom-fields)

To display the value of a custom field from the current logged-in user, use:

 ```
{user.field.NAME}
```

Example:

 ```
{user.field.favoriteColor}
```

For more details, see the [User Smart Tag](https://www.tassos.gr/docs/common/features/smart-tags/user#custom-fields) guide.

## [Common Syntax and Field Properties](#common-syntax-and-field-properties)

You can access additional properties of a custom field by appending the appropriate keyword after the field name.

### [Return Raw Value](#return-raw-value)

A custom field has both a value and a raw value, which are different in most cases. To return the field's raw value, use:

 ```
{article.field.favoriteColor.rawvalue}
```

### [Return Field Label](#return-field-label)

To return the field's label, use:

 ```
{article.field.favoriteColor.label}
```

### [Return Field ID](#return-field-id)

To return the field's ID, use:

 ```
{article.field.favoriteColor.id}
```

### [Subform Fields](#subform-fields)

If you’re using a Subform field, you can access its content in various ways.

Let’s assume you have a Subform field named customers, with two nested fields: name and age.

**Output All Subform Rows**

 ```
{user.field.customers}
```

This returns all subform rows as a bullet list.

**Output a Specific Row**

 ```
{user.field.customers.rawvalue.0}
```

This returns all values from the first row (index 0).

**Output a Specific Field from a Specific Row**

 ```
{user.field.customers.rawvalue.0.age}
```

This returns the value of the age field in the first row.

### [Prevent Shortcodes Parsing](#prevent-shortcodes-parsing)

By default, Smart Tags prepare the output of custom fields, which means that shortcodes and content plugins inside a field’s value are executed. This can lead to issues such as:

- **Plugins being unintentionally executed**: For example, if the Email Cloak Plugin runs on a custom field value that contains an email address, it will replace it with JavaScript-based cloaking, which may not be desirable. Similarly, any shortcode in the field will be parsed and rendered.
- **Special characters displayed incorrectly**: Text fields containing umlauts or other accented characters may appear broken because the field layout echoes the value using `htmlentities($value)`.

If you want to prevent this behavior and return the field value exactly as entered, you have two options:

1\. Disable Smart Tags from preparing custom fields with the modifier:

 ```
{user.field.xxx --prepareCustomFields=false}
```

2\. Output the [raw field value](#return-raw-value) instead of the prepared one:

 ```
{user.field.xxx.rawvalue}
```

 Last updated on Sep 12th 2025 13:09

## Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "name": "Home",
            "item": "https://www.tassos.gr"
        },
        {
            "@type": "ListItem",
            "position": 2,
            "name": "Home",
            "item": "https://www.tassos.gr/docs"
        },
        {
            "@type": "ListItem",
            "position": 3,
            "name": "Product Common Guides",
            "item": "https://www.tassos.gr/docs/common"
        },
        {
            "@type": "ListItem",
            "position": 4,
            "name": "Features",
            "item": "https://www.tassos.gr/docs/common/features"
        },
        {
            "@type": "ListItem",
            "position": 5,
            "name": "Smart Tags",
            "item": "https://www.tassos.gr/docs/common/features/smart-tags"
        },
        {
            "@type": "ListItem",
            "position": 6,
            "name": "Custom Fields",
            "item": "https://www.tassos.gr/docs/common/features/smart-tags/custom-fields"
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@type": "Article",
    "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://www.tassos.gr/docs/common/features/smart-tags/custom-fields"
    },
    "headline": "Custom Fields",
    "image": {
        "@type": "ImageObject",
        "url": "https://www.tassos.gr/"
    },
    "publisher": {
        "@type": "Organization",
        "name": "Tassos",
        "logo": {
            "@type": "ImageObject",
            "url": "https://www.tassos.gr/https://www.tassos.gr/media/brand/logo-text.png"
        }
    },
    "author": {
        "@type": "Person",
        "name": "Tassos Marinos",
        "url": "https://www.tassos.gr/docs/common/features/smart-tags/custom-fields"
    },
    "datePublished": "2025-06-19T14:28:14+03:00",
    "dateCreated": "2025-06-19T14:28:14+03:00",
    "dateModified": "2025-09-12T13:49:45+03:00"
}
```