# Custom Component Icons - PDF?

**URL:** <https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001>\
**Category:** Elements API\
**Created:** [October 18, 2024, 11:19am UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001 "2024-10-18T11:19:04Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![logrunner](https://avatars.discourse-cdn.com/v4/letter/l/59ef9b/32.png) [@logrunner](https://forums.realmacsoftware.com/u/logrunner)\
**Post date:** [October 18, 2024, 11:19am UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/1 "2024-10-18T11:19:04Z")

</div>

Reference this documentation: [Icons](https://docs.realmacsoftware.com/elements-docs/elements-language/bundle-structure/icons)

It says “ At a bare minimum you’ll want to include PDF’s images for light mode icons so they can be used for all views where your Component appears within the RapidWeaver Elements UI.”.

Do you mean **PDF** images or should that be **PNG**?

I don’t have Sketch (it seems expensive, to me anyway). Will a simple .icns file creator do the same job reading say a source image of 1024x1024 size to generate the .icns file?

---

<div class="post-metadata">

**Author:** ![dan](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/dan/32/28516_2.png) [@dan](https://forums.realmacsoftware.com/u/dan)\
**Post date:** [October 18, 2024, 3:11pm UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/2 "2024-10-18T15:11:18Z")

</div>

Nope, we do mean PDF (they are a scalable format, unlike png), make sure the graphic you use is also on a transparent background.

This is how they appear in our Button component in Elements (see screenshot below), and here’s a [zip file containing the button pdf icons](https://www.realmacsoftware.com/downloads/elements/buttonicons.zip) for your reference.

 ![CleanShot 2024-10-18 at 4 .07.53@2x](https://europe1.discourse-cdn.com/flex005/uploads/realmacsoftware1/original/3X/4/1/4147f99673cf96a6180675f9dc73504d6d883def.jpeg)

---

<div class="post-metadata">

**Author:** ![logrunner](https://avatars.discourse-cdn.com/v4/letter/l/59ef9b/32.png) [@logrunner](https://forums.realmacsoftware.com/u/logrunner)\
**Post date:** [October 18, 2024, 3:30pm UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/3 "2024-10-18T15:30:55Z")

</div>

So we don’t need a .icns file?

---

<div class="post-metadata">

**Author:** ![dan](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/dan/32/28516_2.png) [@dan](https://forums.realmacsoftware.com/u/dan)\
**Post date:** [October 18, 2024, 4:25pm UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/4 "2024-10-18T16:25:49Z")

</div>

Nope, you no longer need those. Just the icons I supplied above. (I’ll get the icon docs updated too).

---

<div class="post-metadata">

**Author:** ![dan](https://dub1.discourse-cdn.com/flex005/user_avatar/forums.realmacsoftware.com/dan/32/28516_2.png) [@dan](https://forums.realmacsoftware.com/u/dan)\
**Post date:** [October 18, 2024, 4:39pm UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/5 "2024-10-18T16:39:21Z")

</div>

@logrunner The [icon docs page](https://docs.realmacsoftware.com/elements-docs/elements-language/bundle-structure/icons) has been updated. Let me know if you need further clarification on anything.

---

<div class="post-metadata">

**Author:** ![Flash](https://avatars.discourse-cdn.com/v4/letter/f/f475e1/32.png) [@Flash](https://forums.realmacsoftware.com/u/Flash)\
**Post date:** [October 18, 2024, 4:42pm UTC](https://forums.realmacsoftware.com/t/custom-component-icons-pdf/45001/6 "2024-10-18T16:42:43Z")

</div>

It’s interesting. For those of us that loved NeXT, display postscript was one of the best things it had. Much of that came forward to MacOSX when NeXT was rebranded to Apple. But some things were lost due to compatibility issues and shear processing power requirements. PDF icons is one of those technologies that just make the MAC work. Glad it’s in Elements. 🙂
