WordPress Q&As Logo
WordPress Q&As Part of the Q&A Network
Real Questions. Clear Answers.
Ask any question about WordPress here... and get an instant response.
Q&A Logo Q&A Logo

How can I create a custom Gutenberg block for my theme?

Asked on Dec 10, 2025

Answer

Creating a custom Gutenberg block involves using JavaScript and PHP to define the block's functionality and appearance. You'll need to enqueue the necessary scripts and register the block using WordPress functions.
<!-- BEGIN COPY / PASTE -->
    // Enqueue block scripts
    function my_custom_block_enqueue() {
      wp_enqueue_script(
        'my-custom-block',
        get_template_directory_uri() . '/js/my-custom-block.js',
        array('wp-blocks', 'wp-editor', 'wp-element', 'wp-components')
      );
    }
    add_action('enqueue_block_editor_assets', 'my_custom_block_enqueue');

    // Register block
    wp.blocks.registerBlockType('mytheme/my-custom-block', {
      title: 'My Custom Block',
      icon: 'smiley',
      category: 'common',
      edit: function(props) {
        return wp.element.createElement('p', {}, 'Hello from the editor!');
      },
      save: function(props) {
        return wp.element.createElement('p', {}, 'Hello from the saved content!');
      }
    });
    <!-- END COPY / PASTE -->
Additional Comment:
  • Ensure you have Node.js and npm installed to manage JavaScript dependencies.
  • Use the WordPress block editor package libraries like "wp-blocks" and "wp-element" for block development.
  • Place the JavaScript file in your theme's directory, typically under a "js" folder.
  • Consider using a build tool like Webpack or Babel for more complex block development.
✅ Answered with WordPress best practices.

← Back to All Questions

Q&A Network
The Q&A Network
WordPress
Ask Questions / Get Answers about WordPress!
AI
Ask Questions / Get Answers about AI!
Cybersecurity
Ask Questions / Get Answers about Cybersecurity!
Web Languages
Ask Questions / Get Answers about Web Languages!
Chatbots
Ask Questions / Get Answers about Chatbots!
IoT
Ask Questions / Get Answers about IoT!
AI Audio
Ask Questions / Get Answers about AI Audio!
Tailwind
Ask Questions / Get Answers about Tailwind!
Security
Ask Questions / Get Answers about Website Security!
AI Ethics
Ask Questions / Get Answers about AI Ethics!
Film Production
Ask Questions / Get Answers about Film Production!
UI/UX Design
Ask Questions / Get Answers about UI/UX Design!
AI Coding
Ask Questions / Get Answers about AI Coding!
AI Education
Ask Questions / Get Answers about AI Education!
Analytics
Ask Questions / Get Answers about Analytics!
Cloud Computing
Ask Questions / Get Answers about Cloud Computing!
AI Design
Ask Questions / Get Answers about AI Design!
SEO
Ask Questions / Get Answers about SEO!
AI Images
Ask Questions / Get Answers about AI Images!
Monetization
Ask Questions / Get Answers about Ad & Monetization!
HTML
Ask Questions / Get Answers about HTML!
Web Development
Ask Questions / Get Answers about Web Development!
Data Science
Ask Questions / Get Answers about Data Science!
Robotics
Ask Questions / Get Answers about Robotics!
JavaScript
Ask Questions / Get Answers about JavaScript!
VR & AR
Ask Questions / Get Answers about VR & AR!
Photography
Ask Questions / Get Answers about Photography!
Graphic Design
Ask Questions / Get Answers about Graphic Design!
Web Hosting
Ask Questions / Get Answers about Hosting!
Networking
Ask Questions / Get Answers about Networking!
AI Business
Ask Questions / Get Answers about AI Business!
DevOps
Ask Questions / Get Answers about DevOps!
AI Marketing
Ask Questions / Get Answers about AI Marketing!
AI Video
Ask Questions / Get Answers about AI Video!
AI Writing
Ask Questions / Get Answers about AI Writing!
Video Editing
Ask Questions / Get Answers about Video Editing!
CSS
Ask Questions / Get Answers about CSS!
Performance
Ask Questions / Get Answers about Web Vitals!
Creative Writing
Ask Questions / Get Answers about Creative Writing!
MobileDev
Ask Questions / Get Answers about Mobile Developement!
Bootstrap
Ask Questions / Get Answers about Bootstrap!
Quantum
Ask Questions / Get Answers about Quantum Computing!