Magento link to skin image from app folder

Magento link to skin image from app folder

September 20, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento link to skin image from app folder

Linking Magento Skin Images from App Folder

In Magento development, there are often cases where you need to link images located in the skin folder from within your app folder templates. This can be particularly useful when customizing footer social icons or other theme elements. Let’s explore how to correctly reference these image files.

Understanding Magento File Structures

To begin, it’s important to understand the Magento file structure:

  • app/design/frontend/{package}/{theme}/template/page/html/: Contains your PHTML templates for page components like headers and footers.
  • skin/frontend/{package}/{theme}/images/: Stores theme-specific images.

The key lies in understanding that Magento resolves paths relative to their respective folders. The skin folder is located one level above the app’s design directory, which means you need to use a relative path to link correctly from your PHTML files.

Linking Skin Images Correctly

Let’s consider an example where we want to include a social icon image named socialIcon.png, located at:

skin/frontend/projectName/default/images/webicons/socialIcon.png

Inside your footer template file (footer.phtml), the correct way to link this image is as follows:

<a href="#"><img src="images/webicons/socialIcon.png" /></a>

Notice how we use images/webicons/socialIcon.png directly. This works because when you’re in a PHTML template, Magento automatically resolves relative paths starting with skin/.

Why It Works

The key to this technique lies in the way Magento processes your theme files:

  1. When you include a template file (e.g., footer.phtml), it’s loaded from the template folder within your theme.
  2. Magento then resolves any relative paths relative to your current location (skin/) rather than the actual file system path.

This design allows for a clean separation of concerns, keeping your templates and styles distinct yet easily accessible.

Best Practices

When linking skin images in this manner:

  • Always use descriptive names for your image files.
  • Organize related images within sub-folders to keep things neat (e.g., images/webicons/, images/banners/, etc.).
  • Remember that all paths are relative to the skin folder level, not the PHTML file’s location.

Conclusion

Linking Magento skin images from your app folder templates is a straightforward process once you understand how relative paths are resolved. By using the direct image names within their respective folders, you can keep your code clean and maintainable.

This approach aligns with best practices for theme development in Magento, promoting a clear separation of presentation (theme) and application logic (app).

Themes Import/Export

Our network