FAQ

Is the plugin free?

The official AMP plugin is free to use and always will be. Any extensions that our team develops are also free to download and use for your own WordPress projects.

How does the plugin work?

The plugin converts your existing content to AMP valid content where possible. It inserts boilerplate AMP code into your sites header and provides you with development tools to ensure AMP validity is maintained.

What are the benefits of this plugin?

This plugin allows you to use your existing WordPress theme, while benefiting from all the great features AMP brings to a website, for owners and visitors alike.

Does it work with my existing theme?

You’ll need to check with your theme provider. If your theme is not AMP compatible you can use the plugin in `Reader Mode` mode, so you can have AMP versions of your great content while maintaining your existing non AMP site.

Enabling the plugin active in `reader` (or `transitional`) mode does not impact your canonical (non AMP) site.

If your theme is compatible then you are ready to use the plugin transitional or even standard (AMP first) mode.

Does it work with my existing plugins?

If the plugins you are using are backend operated or do not output JavaScript in the front end of your site then it may work in AMP by default. If you’re using plugin which you find is not compatible in AMP you can perform the following:

  1. Check with your plugin provider
  2. Check for an AMP compatible alternative
  3. Use an AMP Component that performs the same functionality
  4. Make programmatic changes to ensure compatibility
Why there are different modes, and what do they do?

The different modes provide you with flexibility to choose how you prefer to implement AMP, with options to utilize your existing WordPress theme or to enable AMP only on particular post types or templates. You can see a summary of the different modes below:

– Standard: This mode ensures you are adopting an AMP first approach. Your website is AMP by default and there is no /?amp at the end of your URLs. Standard mode works best for websites using an AMP compatible theme, which while also using AMP compatible plugins and content.

– Transitional: This mode ensures you have AMP URLs running alongside your regular (non AMP) URLs. This mode should be selected if you are using an AMP compatible theme but are not ready for a 100% AMP website (via AMP standard).

– Reader Mode: This mode works best if you are using a theme which is not AMP compatible. Users can make use of AMP valid templates to serve individual pages and posts which run alongside your regular non AMP website. Non-singular templates like your blog index page, category page, and author page are not available in this mode. Your non-AMP URLs are not affected. If using reader mode be sure to checkout the “Classic Templates” page.

You can find out more about the different modes available on the “Serving Strategies” page. 

How can I view my AMP content?

To view the AMP version of any of your pages and posts use any of the methods below:

– Use the AMP validator Chrome extension: Install the AMP validator browser extension and easily identify any AMP URLs or non AMP URLs which have an AMP version available.

– Use the plugin’s toolbar menu item: If you have the toolbar active (Users > Your Profile > Toolbar) you can click on the “View AMP version” link.

– Appending to the URL: append any post or page url with a /?amp at the end, as long as there is an AMP version available. This can be seen by looking for an link[rel=amphtml] element in the source code of any non AMP URL.

With AMP my website is not working as normal , what do I do?

You may be using a theme or plugin which is not AMP compatible. Many plugins and themes are built using JavaScript, which is restricted in AMP.

If you find something isn’t working as it should, the first step is to check the plugin’s validation tool. You can then confirm if there is a validation error.

For plugins, themes or features which are not compatible you have options:

– Contact the developer: In many cases plugins can be easily modified for AMP compatibility using amp-bind or creating fallbacks.

– Look for an AMP compatible alternative: More and more plugins are becoming AMP compatible. Find some on our ecosystem page. Look for a compatible alternative which offers the same functionality.

– Use an AMP Component: AMP components can be used in place of plugins.

– Get your hands dirty: Resolving AMP validation errors can be achieved with some development work. The plugin website features various supporting documentation, such as guides on fixing JavaScript based hamburger menus and using the amp-bind component.

Where can I find FAQs for AMP libraries?

Here you can read lease read the AMP Project’s frequently asked questions.

I’m using AMP in transitional or reader more, so I have 2 versions for some of my content. Which version will visitors land on? 

It depends on where your traffic is coming from. From an organic mobile search visitors may be directed to your AMP URLs by search engines. Future versions of the plugin may add the ability to automatically redirect mobile visitors to the AMP version.

How do I customize the AMP output for my site?

If you’re using “Standard” mode AMP or “Transitional” mode AMP any changes you made using the standard customizer will apply to your AMP URLs. When using Legacy Templating, in your Customizer’s “AMP” panel, you can edit the “Header Text Color,” “Header Background & Link Color,” and “Color Scheme.”

What embeds and shortcodes are supported by the official AMP plugin?

For information about handling of shortcodes, check out the page Native WordPress Embed And Shortcode Support.

How do add Analytics on my site?

There is an Analytics tab within the plugin which can be used to implement analytics tracking code from various vendors. It also displays some sample Google Analytics tracking code. For guidance visit this dedicated section on the plugins website. 

If you’re using AMP in native mode you can also apply any tracking code to your theme customizer if your theme supports it.

If you are using Google Analytics another option is to install the Site Kit plugin, which can insert your Analytics tracking code in your AMP and non AMP alike.

Google Search Console is showing AMP-related errors, how do I fix them?

Check your website and see if you’re able to identify the errors highlighted, or whether the same errors appear using the plugins validation tool. If you’re unable to figure out the cause feel free to open a new support topic if you’re unable to find a previous topic addressing the same issue.

Why is the URL of my AMP post being redirected to the non-AMP URL?

This could happen if the AMP plugin has not been activated. It could also happen because there are AMP validation errors, which causes the redirect to prevent invalid AMP from being served. Check these two possibilities to determine the culprit.

Why does the AMP Validator indicates: “A value for the image field is required”?

This is likely to be caused by not having a featured image added to your post. If you don’t have a featured image to be added we recommend creating a generic image which can be used with each post lacking one.

As per AMP guidelines featured images should be at least 1200 pixels in width

Featured images are currently necessary for search engines to index your AMP pages, so if you have one to include in every post, that will not only resolve this issue, but it will also help with SEO!

AMP loading error: the background seems to load, but the rest of the page (including images) doesn’t load quickly or at all. What’s wrong?

This may be caused by another plugin interfering with the AMP rendering of your posts. If you’ve installed a few new plugins, try deactivating them one at a time to see if that makes a difference. Certain settings can interfere with the loading of the page, so once you narrow it down, try adjusting the settings and extensions as well on other plugins.

How to remove default schema markup added by the plugin?

You can use the below, added to your active themes functions.php (or preferably a custom plugin)

add_filter( 'amp_schemaorg_metadata', '__return_empty_array' );
This is plugin is great, how can I contribute?

You can contribute using the plugins GitHub repository. File an issue, assist other users or submit feature requests.

My question has not been answered before, what should I do?

Check out the AMP plugin’s help forums here. 🙂 You might find your question has already been answered, or you can post a new one.