add_theme_support( string $feature, mixed $args ): void|false

User Contributed Notes

1. Skip to note 15 content

   Binsaifullah 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 8You must log in to vote on the helpfulness of this note

   /**
    * Essential theme supports
    * */
   function theme_setup(){
       /** automatic feed link*/
       add_theme_support( 'automatic-feed-links' );
   
       /** tag-title **/
       add_theme_support( 'title-tag' );
   
       /** post formats */
       $post_formats = array('aside','image','gallery','video','audio','link','quote','status');
       add_theme_support( 'post-formats', $post_formats);
   
       /** post thumbnail **/
       add_theme_support( 'post-thumbnails' );
   
       /** HTML5 support **/
       add_theme_support( 'html5', array( 'comment-list', 'comment-form', 'search-form', 'gallery', 'caption' ) );
   
       /** refresh widgest **/
       add_theme_support( 'customize-selective-refresh-widgets' );
   
       /** custom background **/
       $bg_defaults = array(
           'default-image'          => '',
           'default-preset'         => 'default',
           'default-size'           => 'cover',
           'default-repeat'         => 'no-repeat',
           'default-attachment'     => 'scroll',
       );
       add_theme_support( 'custom-background', $bg_defaults );
   
       /** custom header **/
       $header_defaults = array(
           'default-image'          => '',
           'width'                  => 300,
           'height'                 => 60,
           'flex-height'            => true,
           'flex-width'             => true,
           'default-text-color'     => '',
           'header-text'            => true,
           'uploads'                => true,
       );
       add_theme_support( 'custom-header', $header_defaults );
   
       /** custom log **/
       add_theme_support( 'custom-logo', array(
           'height'      => 60,
           'width'       => 400,
           'flex-height' => true,
           'flex-width'  => true,
           'header-text' => array( 'site-title', 'site-description' ),
       ) );
   
   
   
   }
   add_action('after_setup_theme','theme_setup');
2. Skip to note 16 content

   Joy 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note

   Feedback:
   There needs to be a section for starter content.
   This page has good explanation https://make.wordpress.org/core/2016/11/30/starter-content-for-themes-in-4-7/
   and this function shows all the default values: https://developer.wordpress.org/reference/functions/get_theme_starter_content/
3. Skip to note 17 content

   Birgit Pauli-Haack 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

   Enabling theme support for align full and align wide option for the block editor, use
   add_theme_support( 'align-wide' );
4. Skip to note 18 content

   Márcio Duarte 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   The following features are enabled by default in block themes from version 5.9 onwards:

   • post-thumbnails
   • responsive-embeds
   • editor-styles
   • html5
   • automatic-feed-links

   See #35593 | (source)
5. Skip to note 19 content

   Matt Radford 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

   From WP 5.3, add_theme_support('html5', ['script', 'style']); removes type="text/javascript" and type=”text/css” from enqueued scripts and styles.

   See https://make.wordpress.org/core/2019/10/15/miscellaneous-developer-focused-changes-in-5-3/ – HTML5 Supports Argument for Script and Style Tags
6. Skip to note 20 content

   Cameron Jones 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   To determine if the theme support exists (and retrieve it’s arguments), use get_theme_support( $feature )

   https://developer.wordpress.org/reference/functions/get_theme_support/
7. Skip to note 21 content

   puggan 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   The Changelog missing the row:
   “The html5 feature now also accepts ‘script and ‘style’.”

   Don’t know what version it was added in, but its there in 5.3.1 atleast.

   Exemple of use:
   https://github.com/WordPress/WordPress/blob/48692b65241fcbadcd686c3f66696e16883a0e83/wp-includes/theme.php#L708
   https://github.com/WordPress/WordPress/blob/48692b65241fcbadcd686c3f66696e16883a0e83/wp-includes/theme.php#L3233

   Commit:
   https://github.com/WordPress/WordPress/commit/252628652e7706cabb3913f4aa57218fa5012e4b
8. Skip to note 22 content

   Will Skora 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Note that you have to individually call each of these; including multiple ones as an array
add_theme_support( array( 'editor-styles', 'align-wide' ) )


   Instead, you must call them individually:

   add_theme_support( 'editor-styles' );
   add_theme_support( 'align-wide' );
9. Skip to note 23 content

   Marcio Zebedeu 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Declare support for navigation widgets markup.

   add_theme_support( 'html5', array( 'navigation-widgets' ) );

   “Theme developers are highly encouraged to utilize this improvement in their themes. This new theme support feature is an easy way to improve semantics and accessibility in all of the sites using your theme.”
10. Skip to note 24 content

    benoitadam 3 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    “default-color” for custom background doesn’t work

    Solution is to define your own stylesheet class and add the CSS class to the body tag.

    • The default-color argument doesn’t actually set the background color: the theme has to implement the default color using CSS.

      crstauf 3 years ago
11. Skip to note 25 content

    Farrukh Hassan 3 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Declare support for Block Styles.

    add_theme_support( 'wp-block-styles' );

    These will enable the support for default Gutenberg block styles in the theme.

    • View Docs

      Jacopo Marrone (@tresorama) 2 years ago
12. Skip to note 26 content

    birgandi 3 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    deactivate new block editor Widget and active old editor Widget

    remove_theme_support( 'widgets-block-editor' );
13. Skip to note 27 content

    Lovro Hrust 2 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    If you enable 'responsive-embeds', these are responsive classes you can use (.wp-embed-aspect-21-9) etc. on embedded block (like e.g. youtube):

    .wp-embed-responsive .wp-embed-aspect-21-9 .wp-block-embed__wrapper::before {
      padding-top: 42.85%;
    }
    .wp-embed-responsive .wp-embed-aspect-18-9 .wp-block-embed__wrapper::before {
      padding-top: 50%;
    }
    .wp-embed-responsive .wp-embed-aspect-16-9 .wp-block-embed__wrapper::before {
      padding-top: 56.25%;
    }
    .wp-embed-responsive .wp-embed-aspect-4-3 .wp-block-embed__wrapper::before {
      padding-top: 75%;
    }
    .wp-embed-responsive .wp-embed-aspect-1-1 .wp-block-embed__wrapper::before {
      padding-top: 100%;
    }
    .wp-embed-responsive .wp-embed-aspect-9-16 .wp-block-embed__wrapper::before {
      padding-top: 177.77%;
    }
    .wp-embed-responsive .wp-embed-aspect-1-2 .wp-block-embed__wrapper::before {
      padding-top: 200%;
    }
14. Skip to note 28 content

    justinmahar 6 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

    Starter Content #

    Defines and registers starter content to showcase themes on new sites.

    add_theme_support( 'starter-content', array(
        // Place widgets in the desired locations (such as sidebar or footer).
        // Example widgets: archives, calendar, categories, meta, recent-comments, recent-posts, 
        //                  search, text_business_info, text_about
        'widgets'     => array( 'sidebar-1' => array( 'search', 'categories', 'meta'), ),
        // Specify pages to create, and optionally add custom thumbnails to them.
        // Note: For thumbnails, use attachment symbolic references in {{double-curly-braces}}.
        // Post options: post_type, post_title, post_excerpt, post_name (slug), post_content, 
        //               menu_order, comment_status, thumbnail (featured image ID), and template
        'posts'       => array( 'home', 'about', 'blog' => array( 'thumbnail' => '{{image-cafe}}' ), ),
        // Create custom image attachments used as post thumbnails for pages.
        // Note: You can reference these attachment IDs in the posts section above. Example: {{image-cafe}}
        'attachments' => array( 'image-cafe' => array( 'post_title' => 'Cafe', 'file' => 'assets/images/cafe.jpg' ), ),
        // Assign options defaults, such as front page settings.
        // The 'show_on_front' value can be 'page' to show a specified page, or 'posts' to show your latest posts.
        // Note: Use page ID symbolic references from the posts section above wrapped in {{double-curly-braces}}.
        'options'     => array( 'show_on_front'  => 'page', 'page_on_front' => '{{home}}', 'page_for_posts' => '{{blog}}', ),
    	// Set the theme mods.
        'theme_mods'  => array( 'panel_1' => '{{about}}' ),
    	// Set up nav menus.
        'nav_menus'   => array( 'top' => array( 'name' => 'Top Menu', 'items' => array( 'link_home', 'page_about', 'page_blog' )), ),
    ) );

    For full examples of each option, you can reference the Twenty Seventeen theme’s functions.php:

    https://github.com/xwp/wordpress-develop/blob/master/src/wp-content/themes/twentyseventeen/functions.php#L117