Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

How to use PluginUpgradeTask or what should I use instead?

I'm trying to perform certain actions after plugin is installed. I'm familiar with ActiveObjectsUpgradeTask, but since this action has nothing to do with database I'm looking for a more elegant solution. I found an article regarding PluginUpgradeTask, but it's heavily outdated - when I try to use component element in atlassian-plugin.xml, I'm getting following error:

atlassian-plugin.xml contains a definition of component. This is not allowed when Atlassian-Plugin-Key is set.

Linked help document describes that I shouldn't be using component element and use @Component annotation instead. This of course doesn't work.


How do I make PluginUpgradeTask work OR what should I use instead to perform actions right after my plugin is installed?


2 answers

1 accepted

0 votes
Answer accepted

Turns out I didn't implement all methods from PluginUpgradeTask interface and when my IDE suggested I make my class abstract I accidentally clicked this option. I figured it out when I defined my upgrade task explicitly in spring context file and spring thrown an error. Removing abstract keyword from class declaration solved it.


So to sum up, all you really need to run upgrade task is to implement PluginUpgradeTask interface and annotate your class declaration with


 You don't need ExportPackage entry in pom.xml

@Herpen Derpen ,

Great you found what you needed!

Usually when people are looking for learning how to develop an app I recommend this open source : of MyGroovy app

This repository has a lot of useful tips, 

an example of upgrade task implementation:

How you can handle your plugin lifecycle (Start/Stop...):

Probably there are others source codes you can look and learn from, but this is a complete and well written example.

@Herpen Derpen ,

I would say you need to look in the Lifecycle

I recommend you to continue this question using the Development community. there they will be able to better assist you with your query

Thanks for the tip regarding dev community, I didn't even know it exists.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Apps & Integrations

Send an Email or Publish to Confluence - What should you do with your release notes?

Background When you hear the words ‘Release notes’, almost always you think of an unsolicited email from a software vendor. But I am here to tell you that from our data, sending release notes via E...

92 views 0 1
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you