1. Navigate to Custom Fields > ACF Open Icons in WordPress admin
2. Enter your license key in the License section
3. Click Activate License
4. Once activated, all plugin features will be available

1. Go to Custom Fields > ACF Open Icons
2. In the Icon Set section, select your preferred icon library:
   • Lucide - Modern, consistent icon set
   • Tabler Icons - Comprehensive icon collection
   • Heroicons - Beautiful hand-crafted SVG icons
3. Optionally pin a specific version for stability
4. Click Save Changes

Configure color tokens that can be applied to icons:

1. In the Palette section, set colors for tokens A, B, and C
2. These tokens can be applied when selecting icons
3. Changing palette colors automatically updates all icons using those tokens

1. Go to Custom Fields > Field Groups
2. Create a new field group or edit an existing one
3. Add a new field and select Open Icons as the field type
4. Configure field settings (label, name, required, etc.)
5. Save the field group

Use the acf_open_icon() helper function to display icons:

<?php
$icon_field = get_field('icon_field');

// Basic usage (default size: 24px)
acf_open_icon($icon_field);

<?php
$icon_field = get_field('icon_field');

// With custom size
acf_open_icon($icon_field, [
    'size' => 32, // default: 24
]);

<?php
$icon_field = get_field('icon_field');

// Return instead of echo
$svg_markup = acf_open_icon($icon_field, [
    'size' => 64,
    'echo' => false,
]);
echo $svg_markup;

<?php
$icon_field = get_field('icon_field');

// With color override (bypasses token-based color)
acf_open_icon($icon_field, [
    'size' => 48,
    'color' => '#a7f3d0',  // Force a specific color
]);

<?php
$icon_field = get_field('icon_field');

// With CSS classes
acf_open_icon($icon_field, [
    'class' => 'icon-class-name',
    'size' => 32,
]);

In addition to the built-in icon libraries, ACF Open Icons allows you to upload and use your own custom SVG icons. This is perfect for brand icons, custom illustrations, or any SVG graphics you need.

1. Navigate to Custom Fields > ACF Open Icons in your WordPress admin
2. Scroll to the Custom Icons section
3. Click the upload area or drag and drop your SVG file(s)
4. Your icons will be sanitized and stored securely

Custom icons are stored in your WordPress uploads directory:

/wp-content/uploads/acf-open-icons/custom/

Icons are sanitized before storage to remove potentially harmful content while preserving visual fidelity.

Once uploaded, custom icons appear in the icon picker under the "Custom" provider. They work exactly like built-in icons:

• Select "Custom" from the provider dropdown in the icon picker
• Search and browse your uploaded icons
• Apply color tokens just like any other icon
• Use the same acf_open_icon() helper function in your templates

You can manage your custom icons from the settings page:

• View all uploaded icons with their file sizes and upload dates
• Delete icons you no longer need
• Icons that are deleted but still referenced in fields will be marked as orphaned

Note: Deleting a custom icon does not automatically remove it from fields where it's been selected. Use the migration tool to update affected fields.