# Discourse Graphviz

**URL:** https://meta.discourse.org/t/discourse-graphviz/97554
**Category:** Plugin
**Tags:** official, graphviz, included-in-core
**Created:** [September 19, 2018, 12:08pm UTC](https://meta.discourse.org/t/discourse-graphviz/97554 "2018-09-19T12:08:19Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [September 19, 2018, 12:08pm UTC](https://meta.discourse.org/t/discourse-graphviz/97554/1 "2018-09-19T12:08:19Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Discourse Graphviz** provides the ability to add graphs to posts using the DOT language. |
| 📖 | **Install Guide** | **This plugin is bundled with Discourse core**. There is no need to install the plugin separately. |

> [@](#):
>
> :discourse2: As this is an #official plugin maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate plugin tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&body=%3E%20Before%20asking,%20did%20you%20search%20first%3F%20Press%20%F0%9F%94%8D%20at%20the%20upper%20right%20to%20search.&tags=graphviz "Ask for support on configuring and using Discourse Graphviz") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=graphviz "A bug report means something is broken, preventing normal/typical use of the plugin") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=graphviz "Discussion about the user interface of Discourse Graphviz, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=graphviz "Discussion about how existing Discourse Graphviz features can be improved or enhanced, and how proposed new features could work")

### Features

This plugin uses the [Viz.js](https://github.com/mdaines/viz.js) library to render graphs.  
To embed a graph use `[graphviz] [/graphviz]` bbcode. Optionally you can define layout engine attributes: `[graphviz engine=neato]`. If engine is not defined, it defaults to the dot engine.  
See the [Graphviz](https://www.graphviz.org/documentation/) site for documentation and more examples.

### Example

```plaintext
[graphviz engine=circo]
graph {
    a -- b;
    b -- c;
    c -- d;
    d -- e;
    e -- g;
    a -- g;
    a -- c;
    a -- d;
    a -- e;
    b -- d;
    b -- e;
    b -- g;
    c -- e;
    c -- g;
    d -- g;
}
[/graphviz]

```

### Screenshot

SVG from the preview will get converted to png when post is cooked:

 ![18](https://global.discourse-cdn.com/meta/original/3X/d/6/d61fd66ede53db391f70af5c70ead3d2d294e2da.jpeg)

### Note

⚠ This plugin is disabled by default, after installing be sure to enable it via site settings.

### CHANGELOG

### TODO

> Last edited by @tobiaseigen 2025-07-16T21:36:06Z
> 
> Last checked by @tobiaseigen 2025-07-16T21:13:24Z
> 
> > **Check document**
> >
> > Perform check on document:

---

<div class="post-metadata">

### Author: ![tobiaseigen](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/tobiaseigen/32/539204_2.png) [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [July 16, 2025, 9:13pm UTC](https://meta.discourse.org/t/discourse-graphviz/97554/40 "2025-07-16T21:13:14Z")

</div>

🥳 This plugin is now bundled with Discourse core as part of [Bundling more popular plugins with Discourse core](https://meta.discourse.org/t/bundling-more-popular-plugins-with-discourse-core/373574). If you are self-hosting and use the plugin, you need to remove it from your `app.yml` before your next upgrade.

---

<div class="post-metadata">

### Author: ![cmdntd](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/cmdntd/32/192008_2.png) [@cmdntd](https://meta.discourse.org/u/cmdntd)
#### Post date: [July 29, 2025, 7:33pm UTC](https://meta.discourse.org/t/discourse-graphviz/97554/43 "2025-07-29T19:33:56Z")

</div>

This plugin has error in the `latest version` of discourse

I must disable this to `rebuild app` (discourse)

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [July 29, 2025, 7:54pm UTC](https://meta.discourse.org/t/discourse-graphviz/97554/44 "2025-07-29T19:54:42Z")

</div>

It’s was recently added to Discourse core

> [@Bundling more popular plugins with Discourse core](https://meta.discourse.org/t/bundling-more-popular-plugins-with-discourse-core/373574):
>
> Over the next few weeks, we’ll be moving a number of popular Discourse plugins into the core repository. That means that Discourse will come with a larger number of plugins by default, and it’ll be easier for us to keep them all tested & up-to-date. All these plugins will remain disabled by default, so this won’t have any visible impact on existing communities. If you use a managed hosting service like [discourse.org](http://discourse.org), you don’t need to do anything. Self-hosted communities If you self-host Disco…
