Title: WP_Customize_Background_Position_Control
Published: December 6, 2016
Last modified: August 20, 2026

---

# class WP_Customize_Background_Position_Control {}

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#see-also)
 * [Methods](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#methods)
 * [Source](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#changelog)

Customize Background Position Control class.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#description)󠁿

### 󠀁[See also](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#see-also)󠁿

 * [WP_Customize_Control](https://developer.wordpress.org/reference/classes/wp_customize_control/)

## 󠀁[Methods](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#methods)󠁿

| Name | Description | 
| [WP_Customize_Background_Position_Control::content_template](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/content_template/) | Render a JS template for the content of the position control. | 
| [WP_Customize_Background_Position_Control::render_content](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/render_content/) | Don’t render the control content from PHP, as it’s rendered via JS on load. |

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#source)󠁿

    ```php
    class WP_Customize_Background_Position_Control extends WP_Customize_Control {

    	/**
    	 * Type.
    	 *
    	 * @since 4.7.0
    	 * @var string
    	 */
    	public $type = 'background_position';

    	/**
    	 * Don't render the control content from PHP, as it's rendered via JS on load.
    	 *
    	 * @since 4.7.0
    	 */
    	public function render_content() {}

    	/**
    	 * Render a JS template for the content of the position control.
    	 *
    	 * @since 4.7.0
    	 */
    	public function content_template() {
    		$options = array(
    			array(
    				'left top'   => array(
    					'label' => __( 'Top Left' ),
    					'icon'  => 'dashicons dashicons-arrow-left-alt',
    				),
    				'center top' => array(
    					'label' => __( 'Top' ),
    					'icon'  => 'dashicons dashicons-arrow-up-alt',
    				),
    				'right top'  => array(
    					'label' => __( 'Top Right' ),
    					'icon'  => 'dashicons dashicons-arrow-right-alt',
    				),
    			),
    			array(
    				'left center'   => array(
    					'label' => __( 'Left' ),
    					'icon'  => 'dashicons dashicons-arrow-left-alt',
    				),
    				'center center' => array(
    					'label' => __( 'Center' ),
    					'icon'  => 'background-position-center-icon',
    				),
    				'right center'  => array(
    					'label' => __( 'Right' ),
    					'icon'  => 'dashicons dashicons-arrow-right-alt',
    				),
    			),
    			array(
    				'left bottom'   => array(
    					'label' => __( 'Bottom Left' ),
    					'icon'  => 'dashicons dashicons-arrow-left-alt',
    				),
    				'center bottom' => array(
    					'label' => __( 'Bottom' ),
    					'icon'  => 'dashicons dashicons-arrow-down-alt',
    				),
    				'right bottom'  => array(
    					'label' => __( 'Bottom Right' ),
    					'icon'  => 'dashicons dashicons-arrow-right-alt',
    				),
    			),
    		);
    		?>
    		<# if ( data.label ) { #>
    			<span class="customize-control-title">{{{ data.label }}}</span>
    		<# } #>
    		<# if ( data.description ) { #>
    			<span class="description customize-control-description">{{{ data.description }}}</span>
    		<# } #>
    		<div class="customize-control-content">
    			<fieldset>
    				<legend class="screen-reader-text"><span>
    					<?php
    					/* translators: Hidden accessibility text. */
    					_e( 'Image Position' );
    					?>
    				</span></legend>
    				<div class="background-position-control">
    				<?php foreach ( $options as $group ) : ?>
    					<div class="button-group">
    					<?php foreach ( $group as $value => $input ) : ?>
    						<label>
    							<input class="ui-helper-hidden-accessible" name="background-position" type="radio" value="<?php echo esc_attr( $value ); ?>">
    							<span class="button display-options position"><span class="<?php echo esc_attr( $input['icon'] ); ?>" aria-hidden="true"></span></span>
    							<span class="screen-reader-text"><?php echo $input['label']; ?></span>
    						</label>
    					<?php endforeach; ?>
    					</div>
    				<?php endforeach; ?>
    				</div>
    			</fieldset>
    		</div>
    		<?php
    	}
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/customize/class-wp-customize-background-position-control.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/customize/class-wp-customize-background-position-control.php#L17)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/customize/class-wp-customize-background-position-control.php#L17-L116)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_Customize_Control](https://developer.wordpress.org/reference/classes/wp_customize_control/)`wp-includes/class-wp-customize-control.php` |

Customize Control class.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_customize_background_position_control/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.7.0](https://developer.wordpress.org/reference/since/4.7.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_customize_background_position_control%2F)
before being able to contribute a note or feedback.