Title: amCharts: Charts and Maps
Author: martynasma
Published: <strong>February 28, 2014</strong>
Last modified: August 18, 2026

---

Search plugins

![](https://ps.w.org/amcharts-charts-and-maps/assets/banner-772x250.png?rev=866681)

![](https://s.w.org/plugins/geopattern-icon/amcharts-charts-and-maps_6f74b0.svg)

# amCharts: Charts and Maps

 By [martynasma](https://profiles.wordpress.org/martynasma/)

[Download](https://downloads.wordpress.org/plugin/amcharts-charts-and-maps.1.4.7.zip)

 * [Details](https://li.wordpress.org/plugins/amcharts-charts-and-maps/#description)
 * [Reviews](https://li.wordpress.org/plugins/amcharts-charts-and-maps/#reviews)
 *  [Installation](https://li.wordpress.org/plugins/amcharts-charts-and-maps/#installation)
 * [Development](https://li.wordpress.org/plugins/amcharts-charts-and-maps/#developers)

 [Support](https://wordpress.org/support/plugin/amcharts-charts-and-maps/)

## Description

#### Important disclaimer

This plugin loads JavaScript libraries from external amCharts CDN which is a free**
service** provided by amCharts.

amCharts provides their libraries completely free without any caps to functionality
on a sole condition, that small contribution is automatically displayed on all chart
produced by amCharts library. The contribution comes from amCharts libraries/service
and is not added by this plugin.

Related links:
 * [Free usage terms / license of the amCharts library](https://github.com/amcharts/amcharts4/blob/master/dist/script/LICENSE)*
[amCharts privacy policy](https://www.amcharts.com/privacy-policy/)

#### What is it?

Ever tried getting JavaScript content into your WordPress posts or pages? Yeah, 
that’s impossible. WP strips down all
 the JavaScript.

This makes adding JavaScript Charts and Maps a hassle.

Developed and maintained by amCharts staff, this plugin solves the problem by allowing
you to create chart code snippets, that then subsequently can be inserted into the

posts or pages as a shortcode. (helpful button in TinyMCE is also there)

You can also use a built-in PHP function to invoke the chart anywhere in your template:

    ```
    <?php amcharts_insert( $chart_id ); ?>
    ```

The plugin has also many helpful functions:

 * Easy switching between CDN-hosted or local chart/map libraries storage
 * Setting defaults per chart type
 * Automatically locating installed libraries and available resources

## Screenshots

[⌊Plugin configuration. Either use amCharts-hosted free libraries or your own. Set
default code per chart/map type.⌉⌊Plugin configuration. Either use amCharts-hosted
free libraries or your own. Set default code per chart/map type.⌉[

Plugin configuration. Either use amCharts-hosted free libraries or your own. Set
default code per chart/map type.

[⌊Easily create new charts or maps using presets right from the Admin menu.⌉⌊Easily
create new charts or maps using presets right from the Admin menu.⌉[

Easily create new charts or maps using presets right from the Admin menu.

[⌊Modify resources, HTML or JavaScript portion of the chart. Or apply defaults right
from the edit screen.⌉⌊Modify resources, HTML or JavaScript portion of the chart.
Or apply defaults right from the edit screen.⌉[

Modify resources, HTML or JavaScript portion of the chart. Or apply defaults right
from the edit screen.

[⌊Insert chart easily into body of the post or page using button from the rich editor
tool belt. The charts are inserted as Wordpress shortcodes.⌉⌊Insert chart easily
into body of the post or page using button from the rich editor tool belt. The charts
are inserted as Wordpress shortcodes.⌉[

Insert chart easily into body of the post or page using button from the rich editor
tool belt. The charts are inserted as Wordpress shortcodes.

[⌊Select from the available charts or maps. No coding required.⌉⌊Select from the
available charts or maps. No coding required.⌉[

Select from the available charts or maps. No coding required.

[⌊Embed a chart created in Live Editor directly into your posts or pages.⌉⌊Embed
a chart created in Live Editor directly into your posts or pages.⌉[

Embed a chart created in Live Editor directly into your posts or pages.

[⌊The chart shortcodes are replaced with the actual charts when page renders.⌉⌊The
chart shortcodes are replaced with the actual charts when page renders.⌉[

The chart shortcodes are replaced with the actual charts when page renders.

## Blocks

This plugin provides 1 block.

 *   amCharts: Chart or Map

## Installation

Use WordPress Plugin page to search and install the amCharts plugin.

If you choose to install in manually, make sure all the files from the downloaded
archive are placed into your `/wp-content/plugins/amcharts/` directory.

## FAQ

### Does this plugin work with the free/commercial versions of amCharts libraries?

Yes. You can either set the plugin to use publically available libraries loaded 
from www.amcharts.com or from your local server.

### Which version of amCharts library does the plugin use?

Plugin will use amCharts 5 when installed anew. You are able to switch between versions
in plugin’s settings.

### Will I be able to visually edit settings and data?

No. This plugin allows editing a code directly in WordPress admin as well as inserting
the charts into posts or pages using shortcodes.

It’s not a fully fledged chart/map editor. It’s a plugin designed to get your chart/
map code into WordPress easily.

### Do I need to include any JavaScript libraries in my theme code?

Nope. The plugin will take care of that for you. The required JavaScript libraries
will be included in the footer of the page automatically.

Plugin will include only those libraries that are actually required to render the
chart. If no charts are there on the page, no additional libraries will be included.

Let’s keep the footprint small 😉

### Can I insert a chart directly from my PHP code rather than shortcode?

Yes. Use the following PHP code:

    ```
    <?php amcharts_insert( $chart_id ); ?>
    ```

Or, you can retrieve the chart object using following function:

    ```
    <?php amcharts_get( $chart_id ); ?>
    ```

This will return an object with the following properties:

 * title – a chart title
 * post – a reference to original WP post object
 * resources – a list of resource urls
 * html – HTML code
 * javascript – JavaScript code

### Can I pass custom parameters to chart code via shortcode?

Yes, starting from version 1.0.7.

Any parameter prefixed with “data-” will be passed into chart code via global AmCharts.
wpChartData object.

I.e.:

    ```
    [amcharts id="pie-1" data-file="data1.csv" data-sort="asc"]
    ```

The above shortcode will insert the following code **before** actual chart code:

    ```
    AmCharts.wpChartData = {
      "file": "data1.csv",
      "sort": "asc"
    }
    ```

You can then reference those passed variables in your chart code. I.e.:

    ```
    alert( AmCharts.wpChartData.file );
    ```

### Are there any filters available?

Yes:

 * amcharts_shortcode_data ( $data – parsed data passed in via data-* parameters
   of the shortcode, $atts )
 * amcharts_shortcode_resources ( $resources – text data from resources box, $atts)
 * amcharts_shortcode_libs ( $libs – array of resouces, $atts )
 * amcharts_shortcode_javascript ( $javascript – JavaScript portion of the chart,
   $atts )
 * amcharts_shortcode_html ( $html – HTML portion of the chart, $atts )

### Is this plugin WPML-compatible?

Yup. It fully supports WPML. You can create language-specific versions of the charts
and maps. The plugin will automatically select proper language when displaying it.

## Reviews

![](https://secure.gravatar.com/avatar/3e47b55081a5b5ffa3bd465fc15888d8286f11a74449cb19e92b72673c69cc0b?
s=60&d=retro&r=g)

### 󠀁[Beats any chart plugin](https://wordpress.org/support/topic/beats-any-chart-plugin/)󠁿

 [marcludwig](https://profiles.wordpress.org/marcludwig/) April 4, 2022 3 replies

Yes, you need to work a little harder to get things going than with other plugins,
but the output is so much better! I can't imagine a diagram that can't be done with
Amworks. Keep up the great work 🙂

![](https://secure.gravatar.com/avatar/da6589b66112c05b77a122bc969db75cc588444332d7918b0af9237bf0279858?
s=60&d=retro&r=g)

### 󠀁[Forgot to review](https://wordpress.org/support/topic/forgot-to-review/)󠁿

 [autocircle](https://profiles.wordpress.org/autocircle/) February 9, 2022 1 reply

I have used this plugin almost 7 years ago and that time I was stacked for somewhere
and I asked for help, plugin author @martynasma helped me. I was very glad to him
but I forgot to review. This 5 star for you. Thanks man.

![](https://secure.gravatar.com/avatar/c249e875b51de1b37d0b8492971a2a6cac54cd5565dc57b15de3f0a87e3dd8d9?
s=60&d=retro&r=g)

### 󠀁[One of the most advanced charting tools available…](https://wordpress.org/support/topic/one-of-the-most-advanced-charting-tools-available/)󠁿

 [imincognito](https://profiles.wordpress.org/imincognito/) December 8, 2021

Have used Amcharts for my static sites. Briliiantly designed. Same concepts applied
here for WordPress. However, since the charts are defined using JS and Amcharts 
object lib, there is a definite learning curve.

![](https://secure.gravatar.com/avatar/1cb5104cbaff568fbf72f2dec28086eb9221c2b34980a732f5f98c794efc39f8?
s=60&d=retro&r=g)

### 󠀁[Awesome](https://wordpress.org/support/topic/awesome-9163/)󠁿

 [rv99](https://profiles.wordpress.org/rv99/) November 25, 2021 1 reply

Perfect Chart Plugin

![](https://secure.gravatar.com/avatar/ba66ef1929bd428fe91b2f9f31bb7f4640d4fa28aba04346ef5b2f9810bd9785?
s=60&d=retro&r=g)

### 󠀁[Awesome, Best Plugin](https://wordpress.org/support/topic/awesome-best-plugin/)󠁿

 [steelrods](https://profiles.wordpress.org/steelrods/) January 7, 2018 1 reply

Very powerful plugin, complete charts ever, clear documentation, nice UI, easy customisation.
Keep up the good work..

![](https://secure.gravatar.com/avatar/369b60d5707123e1c4c5e9e7bb0766a72cb3f3612ad0e5371e5ccd1f7b904cb2?
s=60&d=retro&r=g)

### 󠀁[Great looking, easy to work with!](https://wordpress.org/support/topic/great-looking-easy-to-work-with/)󠁿

 [calvinrbell](https://profiles.wordpress.org/calvinrbell/) August 23, 2017 1 reply

I used the free version of this at first, was able to create the chart and most 
importantly, use the dataloader to load some REST API web services I had created.
They look and feel good, and the users really dig the charts!

 [ Read all 29 reviews ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/)

## Contributors & Developers

“amCharts: Charts and Maps” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ martynasma ](https://profiles.wordpress.org/martynasma/)

[Translate “amCharts: Charts and Maps” into your language.](https://translate.wordpress.org/projects/wp-plugins/amcharts-charts-and-maps)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/amcharts-charts-and-maps/),
check out the [SVN repository](https://plugins.svn.wordpress.org/amcharts-charts-and-maps/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/amcharts-charts-and-maps/)
by [RSS](https://plugins.trac.wordpress.org/log/amcharts-charts-and-maps/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.4.7

 * Tested up to WP 7.1.0.
 * Charts and maps can now also be inserted using a native block (“amCharts: Chart
   or Map”) in the block editor, in addition to the legacy block and the classic
   editor button.

#### 1.4.6

 * Tested up to WP 7.0.0.

#### 1.4.5

 * Fixed a cross-site scripting vulnerability with chart previews. (CVE-2024-8622)
 * Tested up to WP 6.6.2.

#### 1.4.4

 * Fixed a PHP warning.
 * Tested up to WP 6.6.1.

#### 1.4.3

 * New setting: “User capabilities”. Allows setting which capabilities must a user
   have in order to be able to edit charts.
 * Ciontributor role users are now not allowed to create charts by default. Changeable
   in Settings.
 * Tested up to WP 6.5.2.

#### 1.4.2

 * Tested up to WP 6.5.

#### 1.4.1

 * Minor XSS vulnerability fixed.

#### 1.4

 * Tested up tp WP 6.1.
 * Added amCharts 5 support.

#### 1.3

 * Chart popup will now open faster since it uses built-in “thickbox” and in-line
   code rather than `<iframe>`.
 * Some PHP warnings has been fixed in debug mode.
 * Plugin now uses CodeMirror library bundled with WP if available.

#### 1.2.3

 * CodeMirror dependency is no longer included in all Admin pages, just the ones
   that are related to amCharts.

#### 1.2.2

 * Fixed error of passing in data via “data-” shortcode parameters when V4 is enabled.

#### 1.2.1

 * Prevent Chart code to be executed multiple times in case some plugin was causing
   shortcodes to be processed twice.

#### 1.2

 * Added amCharts 4 support with switcher between two amCharts versions

#### 1.1.6

 * Upgraded CodeMirror to a latest version
 * Verified WP 4.9.2 compatibility

#### 1.1.5

 * Fixed Gauge Chart example

#### 1.1.4

 * Made some changes so that plugin can be translated more easily
 * Added Lithuanian translation

#### 1.1.3

 * Fixed warnings in WP debug mode

#### 1.1.2

 * Local reseource list refresh was omitting theme files

#### 1.1.1

 * Fixed minor PHP7 incompatibility

#### 1.1

 * Added WPML support

#### 1.0.19

 * Filters now are applied to various parts of the chart inserted via shortcode

#### 1.0.18

 * Fixed unnecessary loading of resource list from amcharts.com on every request
 * Introduced option to use relative resource URLs (available in Settings)
 * Remote resources now use “//” protocol prefix so that it inherits either http
   or https depending on what the website uses

#### 1.0.17

 * Decode values of “data-*”” attributes passed in from shorcode

#### 1.0.16

 * Fixed an error passing data that had “=” in it

#### 1.0.15

 * Fixed an error passing data to using “data-*” parameters on newer WPs

#### 1.0.14

 * Added oEmbed support for https-enabled Live Editor URLs

#### 1.0.13

 * Change “%CHART%” meta code to “$CHART$” so that code is valid JavaScript. (old
   syntax still works)
 * Tweaks for better support of settings page markup according to WP 4.4 specs
 * Cleaned up default chart templates (will affect only new installs)

#### 1.0.12

 * Added support for WP installs with non-standard directories

#### 1.0.11

 * Fixed a critical error after upgrade

#### 1.0.10

 * Resources tab can now include .css files

#### 1.0.9

 * Added GANTT chart type support

#### 1.0.8

 * Resource list now contains amCharts plugins

#### 1.0.7

 * Added an option to wrap all chart/map code into exception try/catch block
 * Added ability to pass in custom parameters via shortcode

#### 1.0.6

 * Fixed a warning that was being displayed if WordPress debug mode was enabled

#### 1.0.5

 * Fixed a bug that was causing resource list to break on some PHP setups

#### 1.0.4

 * Added an option to use self-hosted (commercial) amCharts libraries with embedded
   Live Editor charts

#### 1.0.3

 * Chart insert window now shows recent chart first with ability to live-search 
   all available charts
 * Chart shortcodes will now be inserted using user-friendly slug instead of id
 * Added ability to insert and embed charts created with Live Editor

#### 1.0.2

 * Added a way to preview the chart while editing it
 * Added ability to enter a user-friendly slug/ID for the chart to be used in shortcodes
 * Fixed potential conflicts of the same libraries included from different locations
   on the same page

#### 1.0.1

 * Shortcode column was showing for all post types

#### 1.0

 * Initial release

## Meta

 *  Version **1.4.7**
 *  Last updated **2 months ago**
 *  Active installations **1,000+**
 *  WordPress version ** 3.5 or higher **
 *  Tested up to **7.1.0**
 *  Language
 * [English (US)](https://wordpress.org/plugins/amcharts-charts-and-maps/)
 * Tags
 * [amcharts](https://li.wordpress.org/plugins/tags/amcharts/)[ammap](https://li.wordpress.org/plugins/tags/ammap/)
   [charts](https://li.wordpress.org/plugins/tags/charts/)[javascript charts](https://li.wordpress.org/plugins/tags/javascript-charts/)
   [maps](https://li.wordpress.org/plugins/tags/maps/)
 *  [Advanced View](https://li.wordpress.org/plugins/amcharts-charts-and-maps/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  29 5-star reviews     ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/amcharts-charts-and-maps/reviews/)

## Contributors

 *   [ martynasma ](https://profiles.wordpress.org/martynasma/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/amcharts-charts-and-maps/)