Tutorials and guides

The tutorials and guides listed on this page will help you develop for Confluence Data Center.

Developing for Cloud? Check out the tutorials and guides for Confluence Cloud

Beginner tutorials

• Confluence blueprints
• Write a simple Confluence space blueprint
• Adding Confluence keyboard shortcuts
• Create a Confluence 'Hello World' macro
• Write a simple Confluence blueprint plugin
• Writing a Confluence theme
• Extending autoconvert

Intermediate tutorials

• Extending the highlight actions panel
• Adding new Confluence to Hipchat notifications
• Adding items to the info banner
• Extending the Confluence insert link dialog
• Extending the image properties dialog
• Write an intermediate blueprint plugin
• Writing a macro using JSON
• Posting notifications in Confluence
• Adding a custom action to Confluence
• Unit testing plugins

Advanced tutorials

• Using the v2 Search API
• Create a search decorator
• Add a field to CQL
• Create a search extractor
• Create an attachment text extractor
• Write an advanced blueprint plugin
• Defining a pluggable service in a Confluence plugin
• Creating an admin Configuration form
• Creating a Wikipedia macro

SDK tutorials

Looking for other products and for the cross-product frameworks? Start with the Atlassian SDK tutorials page.

Guides

See all developer guides

Legacy tutorials

These tutorials apply to Confluence versions that have reached end of life. 

• Adding an option to the editor insert menu
• Preventing XSS issues with macros in Confluence 4.0
• Writing Soy templates in your plugin
• Upgrading and migrating an existing Confluence macro to 4.0
• Providing an image as a macro placeholder in the editor
• Extending the macro property panel
• Sending emails in a plugin
• Writing macros for pre-4.0 Versions of Confluence
• Adding menu items to Confluence