Free gold price widgetsWidget

Gold price widget for South Africa

Show gold spot values in rand for your website visitors

27 Oct 2026 · 2 min read

Add the live gold price in South African rand with one free iframe, without sign-up or an API key. Today's 24K spot value is unavailable per gram, alongside unavailable per gram at 22K. The widget updates itself.

24K gold per gram in ZAR
22K gold per gram in ZAR

Gold price previews for South Africa

Embed code for 24K
<iframe src="https://goldprice.dev/embed/xau?currency=ZAR&unit=gram&karat=24&theme=auto&locale=en" title="Gold price" width="360" height="190" loading="lazy" style="border:0;width:100%;max-width:360px" referrerpolicy="strict-origin-when-cross-origin"></iframe>
Embed code for 22K
<iframe src="https://goldprice.dev/embed/xau?currency=ZAR&unit=gram&karat=22&theme=auto&locale=en" title="Gold price" width="360" height="190" loading="lazy" style="border:0;width:100%;max-width:360px" referrerpolicy="strict-origin-when-cross-origin"></iframe>

Add the widget to your website

Copy the iframe code below either preview. Paste it into a custom HTML block on your page, then save your changes.

Open your page on a phone and check that the card fits. It stays within 360 pixels and fits narrow screens. The price refreshes by itself.

Widget settings

Each setting is a query parameter in the iframe address. Use the widget builder to choose your settings and generate the code.

SettingOptionsUsed on this page
currencyUSD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, ZARZAR
unitoz, gramgram
karat24, 22, 21, 20, 18, 16, 14, 1024, 22
themeauto, light, darkauto
localeen, ar, es, id, ja, ko, vi, zhen

A gold widget for South Africa

South Africa's /gold page includes 24K, 22K, 18K and 9K per gram. The Krugerrand is a 22K coin, while 9K is very common in local jewellery. The widget supports 22K for gram values, but 9K is available only in the /gold table.

South African finance sites can use the ZAR widget as a spot reference beside coin information, while shops can place it beside jewellery details. It shows grams and troy ounces. For a Krugerrand, distinguish its fine gold content from its total alloy weight.

The gold content behind the price

The gold spot price is the basis for this value, which reflects gold content only. Dealer premium, making charges and tax are excluded. A shop includes these costs in its selling price.

Alongside the price, the card displays the update time and gold's twenty four hour percentage change. It updates by itself and links to goldprice.dev. The price on the card and the figures written in the page text are both fifteen minutes late, as of unavailable.

Questions

How do I add a gold price widget in rand to my website?

Select ZAR in /widgets/gold-price and choose the unit, karat and appearance. Paste the iframe into an HTML section of your website. The widget is free, refreshes automatically and works without an API key.

Are ZAR widget values South African shop selling prices?

ZAR widget values describe gold content at spot and exclude making charges, premium and tax. South African shop selling prices add those costs. Treat them as a reference.

Can I use the ZAR widget to estimate a Krugerrand's gold value?

A Krugerrand contains one troy ounce of fine gold despite its 22K alloy. Use the ZAR troy ounce spot value as a reference for that gold content, before premium and tax.

Keep reading

Start with a free API key

5,000 requests a month on the free plan. No credit card.

Get a free key