Get current currency symbol in Magento2

Get current currency symbol in Magento2

August 27, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Get current currency symbol in Magento2

Getting Started: Displaying Cart Total with Currency Symbol in Magento2

As a developer working on Magento2 projects, you’ll often need to display pricing information on your storefront. This includes showing the cart total with its corresponding currency symbol. Let’s explore how to achieve this using the built-in helpers and variables provided by Magento.

Understanding Magento2 Currency Functionality

Magento2 supports multiple currencies out of the box. It uses a base currency for all calculations and converts prices based on exchange rates defined in the backend. The Magento\Directory\Model\Currency class handles currency-related operations, including conversion and formatting.

Retrieving the Current Currency Symbol

To display the current currency symbol, we’ll use the getCurrencySymbol() function available from a helper class:

// Include the required helper
$currencyHelper = $this->helper('Magento\Directory\Helper\Data');

// Get the current currency code
$currentCurrencyCode = $currencyHelper->getCurrentCurrencyCode();

// Get the currency symbol
$currencySymbol = $currencyHelper->getCurrencySymbol($currentCurrencyCode);

In this example, we’re using the helper() function to load the Magento\Directory\Helper\Data class. This helper provides methods for working with currencies and directories.

Formatting Prices in Currency

Now that you have the currency symbol, let’s format a price value:

// Assume $cartTotal is your cart total amount
$formattedCartTotal = $currencyHelper->currency($cartTotal, true, false);

The currency() method converts a price to a string representation. The third parameter is set to false to prevent using the currency symbol from the currency settings.

Displaying Cart Total in Currency Symbol

Finally, let’s combine these steps to display the cart total with its currency symbol:

// Assume $cartTotal is your cart total amount
$formattedCartTotal = $currencyHelper->currency($cartTotal, true, false);

// Get the currency symbol
$currencySymbol = $currencyHelper->getCurrencySymbol($currentCurrencyCode);

echo $formattedCartTotal . ' ' . $currencySymbol;

This will output something like 123.45 USD.

Best Practices and Further Reading

1. Use Layout Handles for Reusability

Consider using layout handles to add the currency symbol in a reusable way across your storefront. Magento2 allows you to define blocks that can be included in multiple pages.

2. Update Exchange Rates Regularly

Regularly update exchange rates in the Magento admin panel to ensure accurate pricing conversions.

3. Handle Multiple Currency Scenarios

For stores with multiple currencies or where currency switching is enabled, make sure your code handles these cases gracefully using the getCurrentCurrencyCode() function.

Conclusion

Displaying the cart total with its currency symbol in Magento2 is a straightforward process once you understand how to work with the built-in currency functionality. By leveraging the provided helper classes and methods, you can easily format prices and output them alongside their corresponding symbols on your storefront.

Remember that proper formatting is crucial for maintaining user trust and clarity in pricing information across different regions.

For more advanced pricing customizations and Magento2 development best practices, consider exploring our Magento2 Development Guide to enhance your skills further.

Magento 2 Checkout Admin Pricing

Our network