Skip to the main content

Free Site icons are part of the core of Webal Blocks, so they are in the Free package and in Pro.

A new Joomla site shows the Joomla logo in the browser tab. With Site icons you give your site its own small pictures instead. You choose one or two pictures in the Webal Blocks Options, and when you save, Webal Blocks makes every file that browsers and phones ask for and adds them to every page.

Three words come up on this page:

  • A favicon (or tab icon) is the tiny picture next to the page title in a browser tab, in bookmarks and in the browser's history.
  • A home-screen icon is the picture a phone shows when a visitor adds your site to the phone's home screen, like an app.
  • A web manifest is a small file that tells phones the name and the icons to use for your site on the home screen.

Pictures to prepare

You need at least one of these two pictures. Both together give the best result.

  • A home-screen picture: a square PNG picture, at least 512 by 512 pixels and at most 4,096 by 4,096 pixels. Upload it to your images folder with Joomla's Media Manager first. Keep the important part near the middle, because some phones cut the corners off to make a circle or a rounded square. A picture with see-through parts is fine.
  • A tab icon (optional): a simple SVG drawing. SVG is a picture format made of shapes, so it stays sharp at every size. You upload it straight into the Options, with the Upload SVG button, and Webal Blocks checks it and keeps a safe copy.

A tiny tab icon is only 16 pixels wide, so a plain mark (a letter or a simple shape) works much better than a detailed logo with small writing.

Add your site icons

  1. Open Components, Webal Blocks and press Options, and then choose the Site icons tab.
  2. Set Use your own site icons to Yes. The other boxes now appear.
  3. Under Tab icon (SVG), use the box Upload an SVG logo to pick your SVG file, and press Upload SVG. Skip this step if you have no SVG. Do not use the Select button of this box for a PNG or JPG picture: the tab icon must be an SVG.
  4. In Home-screen picture (PNG), press Select, choose your square PNG picture in the Media Manager and press Select again.
  5. Choose a Background colour for phone icons that suits your picture. Phones fill see-through parts with a colour of their own (iPhones use black), so this colour is put behind your picture.
  6. Type a short App name for phones if your site name is long. Leave it empty to use the Site Name from Joomla's Global Configuration.
  7. Choose a Browser colour if you want one, or leave it empty.
  8. Press Save & Close.

A green message says that your site icons were made. If something is in the way, a yellow message says what it is and what to do (see When the icons are not made).

For your web host. Making the phone icons needs the PHP extension GD (PHP's picture tools) and a folder images/wbl-icons that the server can write to. The System - Webal Site plugin must be switched on, because it adds the icons to your pages.

The Site icons tab

Options on the Site icons tab
OptionWhat it doesStarting choice
Use your own site iconsYes shows your own icons on every page. No changes nothing, so your template's icons stay.No
Tab icon (SVG)An SVG drawing for browser tabs. Only an SVG uploaded with the Upload SVG button can be used here. Uploading needs the Configure ACL & Options permission for Webal Blocks, which Super Users have.Empty
Home-screen picture (PNG)The square PNG that the phone icons, the tab icon file and the web manifest are made from. Without it, only the SVG tab icon is used.Empty
Background colour for phone iconsThe colour behind your picture on phone home screens.White
App name for phonesThe name under the icon on a phone's home screen. Keep it to about 12 letters, because phones cut longer names short.Empty, which uses the Site Name
Browser colourSome phone browsers colour their address bar with this colour. Empty lets the browser choose.Empty

Webal Blocks checks the home-screen picture when you save. A picture that is not square, is smaller than 512 by 512 pixels or is not a PNG is refused with a message that gives its size, and nothing is saved until you choose another picture.

What happens when you save

With a home-screen picture, Webal Blocks makes these files in the folder images/wbl-icons:

  • favicon.ico, the tab icon file, with your picture at three small sizes (16, 32 and 48 pixels).
  • apple-touch-icon.png, the iPhone and iPad home-screen icon (180 pixels), with your picture on the background colour.
  • icon-192.png and icon-512.png, the Android home-screen icons.
  • icon-maskable-512.png, an Android icon with room around your picture, so that the phone can cut it to its own shape.
  • site.webmanifest, the web manifest with the app name, the icons and the colours.

Every page of your site then shows your icons, and the template's own icons are taken out, so there is only ever one set. Webal Blocks adds a short code to each address, so when you change a picture and save again, browsers fetch the new files.

Check that it worked

  1. Open your site in a new browser tab. The tab shows your icon.
  2. If you still see the old icon, reload the page. Browsers keep icons for a long time, so it can take a day before every browser shows the new one. A private window shows it at once.
  3. On a phone, open your site and choose Add to Home Screen in the browser's share or menu button. The icon and the app name appear on the home screen. Tapping the icon opens your site in the phone's normal browser.

When the icons are not made

Until the problem is solved, your template's own icons stay, and the message after saving says what to do:

  • The picture tools (GD) are not switched on. Ask your web host to switch on the PHP extension GD, then save the Options again.
  • The folder cannot be written to. Ask your web host to let the site write to images/wbl-icons.
  • The tab icon cannot be used. The SVG file is missing or was not uploaded with the Upload SVG button. Upload it again, then save.
  • A file that Webal Blocks did not make is in the way. The message names the file. Move or rename it with the Media Manager, then save again. Webal Blocks never replaces or deletes a file that it did not make, and that includes one of its own files that you changed.
  • The picture is too large for the server's memory. Save a smaller copy, for example 1,024 by 1,024 pixels, and choose that one.

Switch it off, or change the name

  • Set Use your own site icons to No and save to go back to your template's icons. The files stay in images/wbl-icons, so switching on again with the same pictures brings them straight back.
  • If you remove the home-screen picture and save while the switch is on, Webal Blocks deletes the phone files that it made and keeps only the SVG tab icon.
  • The app name is written into the web manifest when you save. If you change the Site Name in Global Configuration later, open the Options and save them again.
  • Removing Webal Blocks stops the icons at once. The files in images/wbl-icons stay in your images folder, and you can delete them with the Media Manager.

Tip. If your site uses Joomla's cache, the Webal Blocks site plugin clears it when you save the Options (unless you switched that off in the plugin), so every page shows the new icons.

Accessibility. Icons are pictures for recognition only: they carry no words that a screen reader announces, and your page title stays the name that people hear. Choose a picture with strong contrast against both light and dark browser tabs, because the tab colour is chosen by the visitor's browser.

Other languages. The site has one set of icons and one app name for every language. Leave App name for phones empty to use your Site Name.

Other ways to reach us

Ask the community