Skip to main content

Icon

The Icon component displays standardized visual symbols from the POS catalog to represent actions, statuses, or categories consistently. Use icons to enhance navigation or provide visual context alongside text in POS interfaces.

Icons help merchants quickly understand interface elements and actions without relying solely on text labels. Icons are optimized for readability at standard sizes and automatically scale to maintain visual consistency across different screen densities and device types.

Use cases

  • Button clarity: Enhance button clarity with visual indicators for actions like save or delete.
  • Visual context: Provide visual context in lists and cards to identify item types or statuses.
  • Navigation elements: Create intuitive navigation elements that help merchants understand actions.
  • System states: Indicate system states like connectivity or processing status.

Show icons from the POS catalog to represent actions or statuses consistently. This example demonstrates rendering icons that enhance navigation, provide visual context alongside text, and maintain visual consistency across the interface with automatic scaling for different screen densities.

Show icons

Show icons

import React from 'react';

import {
Icon,
Screen,
ScrollView,
Navigator,
reactExtension,
} from '@shopify/ui-extensions-react/point-of-sale';

const SmartGridModal = () => {
return (
<Navigator>
<Screen name="Image" title="Image Example">
<ScrollView>
<Icon name="call" size="minor" />
<Icon name="card-reader" size="major" />
<Icon name="circle-cancel" size="spot" />
<Icon name="orders" size="caption" />
<Icon name="star" size="badge" />
</ScrollView>
</Screen>
</Navigator>
);
};

export default reactExtension('pos.home.modal.render', () => (
<SmartGridModal />
));

Configure the following properties on the Icon component.

required

A name used to render the icon. Choose from the available icon set including commerce-specific symbols like 'cart', 'payment', 'search', navigation arrows, and system indicators.

Default: 'major'

The size of the icon. Use 'minor' for small icons, 'major' for standard size (default), 'spot' for larger emphasis, 'caption' for tiny text accompaniment, or 'badge' for small indicators.

  • Use appropriate sizes for context: Match icon sizes to their surrounding content and importance. Use 's' for inline text or secondary actions, 'm' for standard interface elements, 'l' (default) for primary actions, and 'xl' for prominent features or headers.
  • Apply consistent tones for semantic meaning: Use tone consistently across your interface to establish clear visual patterns. Apply 'icon-critical' for destructive actions like delete, 'icon-warning' for cautions, 'icon-success' for confirmations, and 'icon-primary' for general interface elements.
  • Combine icons with text when appropriate: While icons enhance visual communication, consider pairing them with text labels, especially for complex or less common actions.

  • Icons are purely decorative and don't support click events or interactive behaviors.
  • The available icon set is predefined and limited to POS-specific symbols—custom icons or external icon libraries aren't supported.
  • Icon appearance and styling are controlled by the POS design system—custom colors, styles, or modifications beyond the provided properties are not available.
Was this page helpful?