You're viewing Avo 3 docs — go to Avo 4

Skip to content

Money ​

The Money field is used to display a monetary value.

ruby
field :price, as: :money, currencies: %w[EUR USD RON PEN]

Money Field Example ​

You can explore the implementation of the money field in avodemo and it's corresponding code on GitHub here

Example on new ​

Avo
Avo

Example on show with currencies USD ​

Avo

Example on show with currencies RON ​

Avo

Example on index ​

Avo

Installation ​

This field is a standalone gem. You have to add it to your Gemfile alongside the money-rails gem.

Add this field to the Gemfile

ruby
# Gemfile

gem "avo-money_field"
gem "money-rails", "~> 1.12"

Important: Monetization Requirement

In order to fully utilize the money field's features, you must monetize the associated attribute at the model level using the monetize method from the money-rails gem. (Usage example)

For example:

ruby
monetize :price_cents

Without this step, the money field may not behave as expected, and the field might not render.

Options ​

currencies

The currencies option controls which currencies will be visible on the dropdown.

ruby
field :price, as: :money, currencies: %w[EUR USD RON PEN]

Default ​

By default it's going to be an empty array.

[]

Possible values ​

Add an array of currencies by the ISO code.

%w[EUR USD RON PEN]