Notification

Please make sure that you visit Your AdSense Page, where you can find personalised information about your account to help you succeed with AdSense.

Ad units

How to customise your responsive Multiplex ad unit

Note: These options are deprecated. You can still use these options to customise your Multiplex ads, but we can't guarantee that they will continue to work in all circumstances.

If you have specific requirements for your responsive Multiplex ad units, you can customise the way they look by adding parameters to your ad code. These parameters allow you to change things like the layout of your Multiplex ad units and specify how you'd like to arrange the rows and columns of ads within them.

You can also use the parameters to set different settings for mobile vs. desktop. For example, if you give the layout parameter a single value, your Multiplex ad unit will have the same layout on mobile and desktop. Whereas if you give the layout parameter two values, then your Multiplex ad unit will have one layout on mobile (the first value) and a different layout on desktop (the second value).

Note that these options are only available for responsive Multiplex ad units and that all parameters are required for customisations to work. After you've modified your ad code, make sure that you test your Multiplex ad units on different devices and screens to make sure that they're working correctly.

Note: The examples described in this article are acceptable modifications of the AdSense ad code. You won't violate the AdSense programme policies by modifying your Multiplex ad code in these approved ways.
Expand all  Collapse all

Change the layout of your Multiplex ad unit

The layout parameter (data-matched-content-ui-type) lets you control the arrangement of the text and images in your Multiplex ad units. For example, you can choose to have the image and text side by side, the image above the text, etc.

The following layout options are available:

Image and text side by side

In this layout, the image and text appear alongside each other. To choose this layout, add the data-matched-content-ui-type="image_sidebyside" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="image_sidebyside"
     data-matched-content-rows-num="4"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of ads with images and text side by side layout.

Image and text side by side with card

In this layout, the image and text appear alongside each other within a card. To choose this layout, add the data-matched-content-ui-type="image_card_sidebyside" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="image_card_sidebyside"
     data-matched-content-rows-num="4"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of an ad with Image and text side-by-side with card layout.

Image stacked above text

In this layout, the image and text are arranged one on top of the other. To choose this layout, add the data-matched-content-ui-type="image_stacked" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="image_stacked"
     data-matched-content-rows-num="3"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of ads with images stacked above text layout.

Image stacked above text with card

In this layout, the image and text are arranged one on top of the other within a card. To choose this layout, add the data-matched-content-ui-type="image_card_stacked" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="image_card_stacked"
     data-matched-content-rows-num="3"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of ads with images stacked above text with card layout.

Text only

A text-only layout with no image. To choose this layout, add the data-matched-content-ui-type="text" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="text"
     data-matched-content-rows-num="4"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of a text-only ad layout.

Text with card

A text-only layout within a card. To choose this layout, add the data-matched-content-ui-type="text_card" parameter to your ad code.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-ui-type="text_card"
     data-matched-content-rows-num="4"
     data-matched-content-columns-num="1"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of text with card ad layout.

Specify the number of rows and columns in your Multiplex ad unit

The ads inside a Multiplex ad unit are arranged in a grid. You can specify how many rows and columns you want to show within that grid. For example, you could set your Multiplex ad unit to be a 2x2 square, a 4x1 column, etc.

You set the number of rows with the data-matched-content-rows-num parameter and the number of columns with the data-matched-content-columns-num parameter. You must set both parameters and data-matched-content-ui-type together.

Note:
  • There are some restrictions on the number of rows and columns you can set. The total number of ads in your Multiplex ad unit must be between one and 30. If you try to show less than one or more than 30 ads, then your Multiplex ad unit will appear blank.
  • Sometimes we might not be able to show the exact number of rows and/or columns you've specified. For example, if you've set a large number of columns but your Multiplex ad unit isn't wide enough to fit them all. In this case, we'll adjust the number of rows and/or columns so that your ads fit well in the available space and provide a good user experience.

Row and column examples

4 x 1 (mobile and desktop)

This example code shows you how to generate a Multiplex ad unit with four rows and a single column that shows a total of four ads.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-rows-num="4"
     data-matched-content-columns-num="1"
     data-matched-content-ui-type="image_stacked"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of image and text arranged one on top of the other in Ad Sense.

2 x 2 (mobile and desktop)

This example code shows you how to generate a Multiplex ad unit with two rows and two columns that shows a total of four ads.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-rows-num="2"
     data-matched-content-columns-num="2"
     data-matched-content-ui-type="image_stacked"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Multiplex ad unit in Ad Sense with two rows and two columns that shows a total of four ads.

3 x 3 (mobile and desktop)

This example code shows you how to generate a Multiplex ad unit with three rows and three columns that shows a total of nine ads.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-rows-num="3"
     data-matched-content-columns-num="3"
     data-matched-content-ui-type="image_stacked"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

A Multiplex ad unit in Ad Sense with three rows and three columns that shows a total of nine ads.

4 x 1 (mobile) and 2 x 2 (desktop) for responsive sites

This example code shows you how to generate a Multiplex ad unit with a 4x1 grid on mobile and 2x2 grid on desktop. You might want to use this set-up if you have a responsive site.

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234567890123456" crossorigin="anonymous"></script>
<!-- pbad -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-1234567890123456"
     data-ad-slot="1234567890"
     data-matched-content-rows-num="4,2"
     data-matched-content-columns-num="1,2"
     data-matched-content-ui-type="image_stacked,image_stacked"
     data-ad-format="autorelaxed"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>

Example of image and text arranged one on top of the other in Ad Sense.

Multiplex ad unit in Ad Sense with two rows and two columns that shows a total of four ads.

Troubleshooting

After you've customised your Multiplex ad unit, it's possible that it might not appear exactly as you expected. Here are some common issues with Multiplex ad units and how to fix them:

Your Multiplex ad unit is blank

There are two reasons why this might happen:

  • The total number of ads in your Multiplex ad unit is either less than one or more than 30. You should change the number of rows and/or columns in your Multiplex ad unit so that the total number of ads is within the limit.
  • Your Multiplex ad unit is too wide for the number of ads that you've set. In this case, you should try reducing the width of your Multiplex ad unit.
Your Multiplex ad unit has fewer ads than you expected
This can happen when there's not enough space to show the exact number of ads that you specified. For example, if you've set a large number of ads and your Multiplex ad unit is either too narrow or it's being viewed on a small screen. When this happens, we adjust the number of rows and/or columns to best fit the available space. You could consider changing the width of your Multiplex ad unit or setting different numbers of rows and columns for mobile vs. desktop.
Your ads are text-only
You might see this if your Multiplex ad unit is too narrow for the number of ads that you've set. In this case, you should try increasing the width of your Multiplex ad unit.

Using the console to find errors in your Multiplex ad units

You can use the console in your browser to check that you've correctly modified your Multiplex ad code. For example, the console can tell you if your ad code is missing a required parameter or if a parameter contains an invalid value.

If you're using Chrome, you can follow these steps to test your ad code in the DevTools Console:

  1. Visit the page with your Multiplex ad units.
  2. Press Ctrl+Shift+J (Windows / Linux) or Cmd+Opt+J (Mac).
  3. Check the Console panel for error messages.

Was this helpful?

How can we improve it?
true
Unlock growth potential

Don't miss out on valuable AdSense insights. Opt in to receive performance reports, personalised tips and webinar invites that can help boost your earnings

Opt in

Search
Clear search
Close search
Google apps
Main menu