For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
GuidesIntegrationsAPI ReferencesRelease notes
GuidesIntegrationsAPI ReferencesRelease notes
  • Introduction
    • Overview
    • Quick Start
    • Projects
    • Billing
  • Uploading
    • Overview
      • Overview
      • Installation
        • Overview
        • Plugin structure
        • Extension points
        • Icons & Translations
        • Runtime API
        • Activity UI
        • Complete example
        • Built-in plugins
      • HTML forms
      • Built-in image editor
      • Security settings
      • Breaking changes
    • Uploading files with API
    • File analysis on upload
  • Optimization
    • Overview
  • Transformations
  • Delivery
    • Overview
    • On-the-fly operations
    • CDN settings
    • Proxy
  • Security
    • Overview
    • Validation and moderation
    • Signed uploads
    • Signed URLs
    • Unsafe content moderation
    • Malware protection
    • HIPAA workflows
  • Storage
    • Uploadcare storage
    • Cloudflare R2
    • Google Cloud Storage
    • Azure Blob Storage
  • File management
    • Overview
    • Managing files
    • File groups
    • Webhooks
    • Arbitrary file metadata
  • CLI
    • Overview
    • Configuration
  • Migration
    • Migration to Uploadcare
    • Migration from Filestack
Dashboard
LogoLogo
On this page
  • registerIcon
  • registerL10n
UploadingFile UploaderPlugin API

Icons & Translations

Was this page helpful?
Previous

Runtime API

Next
Built with

Use these methods inside setup to register icons and translations that your plugin’s UI depends on.

registerIcon

Registers an inline SVG icon by name. Use the name in registerSource or registerFileAction.

1pluginApi.registry.registerIcon({
2 name: 'my-icon',
3 svg: '<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><circle cx="12" cy="12" r="10" fill="currentColor"/></svg>',
4});

registerL10n

Adds translation strings used by the plugin’s labels and UI.

1pluginApi.registry.registerL10n({
2 en: {
3 'my-source.label': 'My Source',
4 'my-source.empty': 'No files found',
5 },
6 de: {
7 'my-source.label': 'Meine Quelle',
8 'my-source.empty': 'Keine Dateien gefunden',
9 },
10});

Keys registered here can be accessed via uploaderApi.l10n('my-source.label') for translated text. The current locale name is available via pluginApi.config.get('localeName'). Keys are also used automatically when the label in registerSource matches a key. See Localization for the full list of built-in keys and locale definition format.