Loving Tina? ⭐️ us on GitHubStar

We use cookies to improve your experience. By continuing, you agree to our use of cookies. Learn More

Docs

v.Latest
Introduction
Core Concepts
Querying Content
Editing
Customizing Tina
Going To Production
Media
Drafts
Guides
Further Reference
    Group Field

    This is an advanced-use feature, and likely not something you'll need to configure. What you probably want is the content types reference!

    The group field represents a group of values. This field is best used when there is a single group to be edited, typically with a single JSON object or nested frontmatter values. If there are multiple groups, checkout the group-list field.

    tinacms-date-field

    Options

    import { Field } from '@tinacms/core'
    interface GroupConfig {
    name: string
    component: 'group'
    label?: string
    fields: Field[]
    }
    OptionDescription
    componentThe name of the plugin component. Always 'group'
    nameThe path to some value in the data being edited.
    fieldsAn array of Field values that will render as a sub-menu.
    labelA human readable label for the field. Defaults to the name (Optional)
    descriptionDescription that expands on the purpose of the field or prompts a specific action (Optional)
    This interfaces only shows the keys unique to the group field. Visit the Field Config docs for a complete list of options.

    Definition

    If the source JSON for the example contact info looked like this:

    {
    "contact": {
    "email": "hello@tinacms.org",
    "twitter_handle": "tinacms",
    "github_handle": "tinacms"
    }
    }

    Our form options would look like this:

    const formOptions = {
    label: 'Info Page',
    fields: [
    {
    label: 'Contact Info',
    name: 'rawJson.contact',
    description: 'Contact info',
    component: 'group',
    fields: [
    {
    label: 'Email',
    name: 'email',
    description: 'Contact email',
    component: 'text',
    },
    {
    label: 'Twitter',
    name: 'twitter_handle',
    description: 'Twitter handle',
    component: 'text',
    },
    {
    label: 'GitHub',
    name: 'github_handle',
    description: 'GitHub username',
    component: 'text',
    },
    ],
    },
    //...
    ],
    }
    Table of Contents