Intro
llustrations play a vital role in enhancing the visual appeal and user experience of a digital product. In our design system, it is crucial to ensure that these illustrations are consistent, scalable, and adhere to the stylistic guidelines to be UXC-027 Illustration compliant. This article focuses on the essential practices for exporting illustrations as SVGs and converting hex color codes to theming parameters, ensuring your illustrations are themeable, and remain cohesive within our design system.
When to Use
Use the SVG Export and Hex Code Conversions if:
- your product builds with one of the following technologies: SAPUI5 Web Components, Fundamental Styles, FundamentalNGX, or SAPUI5.
- you want to create UXC-027 compliant illustrations.
Do not use SVG Export and Hex Code Conversions if:
- the product using the illustrations has a product-specific theming system. Then you need to align within your product team how to deal with the product-specific theme parameters.
Pre-Condition
In our design system, we encourage the use of theming parameters for illustrations, which ensures consistency and harmony by restricting color choices to a specific palette. Please exclusively use these colors for illustrations, available in our Illustration Styleguide.
You can also download the colors as Adobe Illustrator color swatches. By doing so, you have each color in the swatch and can get started right away with the illustrations.
Are you working with swatches in Adobe Illustrator for the first time? Check out how to load swatches in Adobe Illustrator.
SVG Export
Illustrations must be exported as SVG to ensure scalability and quality. Please follow these steps to export SVGs properly:
1 – Check Strokes and Illustration Sizes
Ensure that all strokes are outlined in the illustrations (how-to-video linked below). Additionally, check if the illustrations are framed correctly at the following sizes:
- Large Size (L): 320px x 240px
- Medium Size (M): 160px x 160px
- Small Size (S): 128px x 128px
- Extra Small Size (XS): 45px x 45px
2 – Exporting from Design Tools
Designers typically use Figma or Adobe Illustrator. In Figma, export settings for SVG are limited, whereas Adobe Illustrator provides detailed export controls. It’s recommended to export from Adobe Illustrator. Please quickly watch this video explaining how to outline strokes, and export SVGs from Adobe Illustrator properly. Tip: download the video to watch it in higher quality.
Important Settings: In the “Export As” dialog in Adobe Illustrator, ensure “Styling” is set to “Presentation Attributes” to avoid inline styling in the SVG code. Please be aware that inline stylings lead to security issues.
3 – Follow the Illustration Naming Convention
Export each illustration size as SVG and name them as follows, replacing UseCase with the actual illustration name:
- L-Size: sapIllus-UseCase-Large.svg
- M-Size: sapIllus-UseCase-Medium.svg
- S-Size: sapIllus-UseCase-Small.svg
- XS-Size: sapIllus-UseCase-ExtraSmall.svg
Example: sapIllus-GrowingPlants-Large.svg
Hex Codes Replacement to Theming Parameters in a Code Editor
1 – Open the SVG in a code editor
Recommended: Adobe Dreamweaver, Visual Studio Code)
2 – Insert id=”sapIllus-UseCase-TheSize" into the first line, replacing TheSize and UseCase with the appropriate values matching your SVG file name.
Example: id="sapIllus-IceCream-Large"
https://main--builder-prospect--sapudex.hlx.page/wp-content/uploads/sites/69/2025/05/Screenshot-2025-05-23-at-12.50.53.png
Illustration code snippet from Adobe Dreamweaver showcasing the id
3 – Ensure hex codes are replaced
It’s easy. In theory, you simply replace
fill="#hexcode"
With:
fill="var(--sapContent_Illustrative_ColorNUMBER)"
in the code.
You can find a list of all allowed hex codes and their corresponding theming parameters in the color reference list below. Replace all hex codes in your SVG with the corresponding theming parameters. You can get this done quickly by using the find & replace feature of the code editor tool.
Color Replacement Reference
4 – Double check if you have inline styling in your SVG’s code. Simply search for “style” in the code.
If something pops up, replace it with the corresponding fill attribute from the color reference list above. No inline styling allowed in the SVG!
5 – That’s it! Save the files.
How to Add a Color Coded SVG to our CX Illustration Figma Library
Download (for better quality) and watch this how-to video to see the following steps in action:
1 – Drop SVGs in Figma file
Simply drag and drop the illustration SVGs from your desktop in the CX Illustration Figma library. It’s normal that the SVGs are either rendered black or white, no worries.
Screenshot your illustration (with all visible colors), drag and drop it to the CX Illustration library for your reference.
2 – Rewrite the Theming Parameters with Figma Variables
Ensure the file has access to the Figma library “SAP Web UI Kit” which also includes our design system variables. Select a vector of your SVG and go to the “Fill” group in the right Figma panel. Click on the icon “Apply styles and variables”, go to the tab “Libraries” and search for “illus”. Then you see all illustrative colors variables. In sum, these are 31 variables. Select the one you want the vector’s color code be replaced with. Repeat these steps for all vectors of all your illustrations.
3 – Copy and Paste each Illustration to our CX Illustration Template
Copy and paste the CX Illustration Template and fill it out for your illustration set. An illustration set always contains four illustration sizes: Large, Medium, Small, and ExtraSmall.
Select all vectors of an illustration, copy them and paste them in the Large, Medium, Small, or ExtraSmall placeholder in your CX Illustration Template. You can delete the placeholder background vector afterwards. Repeat this step for all four illustrations.
4 – Inform your Design System Expert about New SAP-wide Illustration
Drop your Design System Expert a note and link to your stored SVGs (outside Figma) if you’ve added a SAP-wide illustration set. She’ll take the next steps to include it in our SAP design system and make it available for all SAP technologies. Thank you! ☺️
Related Links
Elements and Controls
–
Implementation
- Illustrated Message (SAPUI5 Component)
- Illustrated Message (SAPUI5 Web Component)
- Illustrated Message (FundamentalNGX Component)
Visual Design
- SAP Illustration Product Style Guide v1.2 (PDF version)
- SAP Illustration Product Style Guide (wiki page)
- SAP product illustration collection overview (provided by Core Design)