Overview

WPBits Block Studio Pro unlocks powerful features for building complex Gutenberg blocks. This guide introduces all Pro features and helps you decide which to use.

Pro Features at a Glance

Feature	Description
Custom Render PHP	Use your own PHP render logic
Repeater Control Type	Nested repeatable attribute groups
Post Selector	Select posts/pages with thumbnail preview
InnerBlocks	Configure nested block areas
Groups Tab	Organize attributes into collapsible sections
Template Editor	Full inline code editor for Twig and PHP templates
Styles Editor	Write custom CSS for frontend and editor styles
JavaScript Editor	Add custom frontend JavaScript to blocks
Custom Categories	Create custom block categories
Custom Output Directory	Set custom output paths
Custom Icon Upload	Upload custom SVG, PNG icons
Export as Plugin	Export as standalone plugin
Auto-Sync Toggle	Per-block enable/disable auto-sync

Upgrading to Pro

1. Purchase a license at wpbits.net/block-studio-gutenberg-block-generator/pricing/
2. Download the Pro version from your account
3. Install and activate like the free version
4. Enter your license key to unlock features

Pro Feature Details

Custom Render PHP

Use custom render.php when you need:

• Complex PHP logic
• WordPress function integration
• Custom database queries
• External API calls
• Performance-critical rendering

Repeater Control Type

Create nested, repeatable groups of attributes. Perfect for:

• Testimonials with multiple quotes
• Team member lists
• FAQ sections
• Gallery grids

Example structure:

{
  "type": "repeater",
  "name": "testimonials",
  "label": "Testimonials",
  "fields": [
    { "name": "quote", "type": "textarea" },
    { "name": "author", "type": "text" },
    { "name": "avatar", "type": "image" }
  ],
  "max": 10,
  "min": 1
}

Post Selector

Select posts, pages, or custom post types with thumbnail preview:

• Search and select posts
• Display featured image thumbnails
• Link to any post type
• Custom query support

InnerBlocks Support

Configure areas where users can add nested blocks:

• Set allowed block types
• Define custom templates
• Control nesting depth
• Template locking

Groups Tab

Organize attributes into collapsible sections:

• Group related attributes together
• Collapsible sections for cleaner UI
• Cross-group drag and drop
• Custom group names and icons

Custom Categories

Organize your blocks into custom categories:

• Create category names
• Set custom icons
• Group blocks logically

Custom Output Directory

Set custom paths for exported blocks:

• Absolute paths: /var/www/html/wp-content/plugins/my-plugin/
• Relative paths: blocks/ or ../../blocks/
• Per-block overrides

Custom Icon Upload

Upload your own block icons:

• SVG support (recommended)
• PNG, JPG, GIF support
• Icon library integration

Export as Plugin

Export blocks as standalone WordPress plugins:

• Multi-block export support
• Custom plugin name and description
• Standalone plugin structure

For full details, see Export as Plugin.

Template Editor

Full inline code editor for block templates:

• Writable Twig and PHP template editing
• Syntax highlighting and auto-completion
• Drag-and-drop attribute insertion
• Live preview support

Styles Editor

Write custom CSS for your blocks directly in the admin:

• Separate editors for frontend (style.css) and editor (editor.css) styles
• Syntax highlighting
• Real-time CSS editing

JavaScript Editor

Add custom frontend JavaScript to your blocks:

• Write JS that runs on the frontend
• Syntax highlighting
• Direct integration with block output

Auto-Sync Toggle

Control auto-sync on a per-block basis:

• Enable for blocks managed entirely through the UI
• Disable for blocks you edit manually on the filesystem
• Free version has auto-sync always-on with no toggle

License Management

Activating Your License

1. Go to WPBits Block Studio → License
2. Enter your license key
3. Click Activate

Deactivating Your License

Move Pro license to another site:

1. Go to WPBits Block Studio → License
2. Click Deactivate
3. Install Pro on new site
4. Activate with same key

License Expiration

• Licenses are valid for 1 year
• Updates continue after expiration
• Renew for new features and security fixes
• Expired licenses still work