meta-tags

# MetaTags: Rails helpers for SEO metadata, sharing, canonical URLs, and robots

[![Tests](https://github.com/kpumuk/meta-tags/actions/workflows/tests.yml/badge.svg)](https://github.com/kpumuk/meta-tags/actions/workflows/tests.yml)
[![Gem Version](https://badge.fury.io/rb/meta-tags.svg)](https://badge.fury.io/rb/meta-tags)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/kpumuk/meta-tags/badge)](https://scorecard.dev/viewer/?uri=github.com/kpumuk/meta-tags)
[![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
[![Gem Downloads](https://img.shields.io/gem/dt/meta-tags.svg)](https://badge.fury.io/rb/meta-tags)
[![Changelog](https://img.shields.io/badge/Changelog-latest-blue.svg)](https://github.com/kpumuk/meta-tags/blob/main/CHANGELOG.md)

MetaTags helps Ruby on Rails applications render HTML head metadata such as titles, descriptions, canonical links, robots directives, Open Graph tags, X card tags, and hreflang links.

It supports the metadata layer of search engine optimization (SEO), especially for titles, descriptions, canonicalization, robots directives, and social sharing previews.

## Ruby on Rails

The MetaTags main branch fully supports Ruby on Rails 6.1+ and is tested against all major Ruby on Rails releases.

> [!NOTE]
> MetaTags requires Ruby 3.2+ and Ruby on Rails 6.1+.

> [!IMPORTANT]
> MetaTags manages HTML head metadata. It does not generate structured data / JSON-LD, `robots.txt`, sitemaps, internal links, or page content.

## Installation

Add the "meta-tags" gem to your `Gemfile`.

```ruby
gem "meta-tags"
```

And run `bundle install` command.

## Configuration

MetaTags ships with practical defaults for truncation and rendering. You can change them to match your application. Legacy fields such as `keywords` are still supported for compatibility, but they are not modern search requirements.

To override the defaults, create an initializer `config/initializers/meta_tags.rb` using the following command:

```bash
rails generate meta_tags:install
```

When a truncation limit is reached, arrays passed to `title` or `keywords` can
either partially truncate the last item or stop at item boundaries. Set
`config.truncate_array_items_at_boundaries = true` to preserve whole items for
multi-item arrays. Single-item arrays are still truncated normally.

Symbols in nested custom tag arrays are literal values in MetaTags 2.x.
MetaTags 3.0 will use them to look up normalized top-level tags. You can turn
on this behavior now. Until then, each nested array that contains a direct
Symbol value emits a deprecation warning:

```ruby
MetaTags.configure do |config|
  config.resolve_symbolic_references_in_arrays = true
end
```

When this option is on, use Strings for literal array values. MetaTags does not
render a tag when a Symbol has no match.

By default, meta tags are rendered with the key `name`. However, some meta tags are required to use `property` inste