# Changing icon for a bitbucket application

**URL:** <https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763>\
**Category:** Bitbucket Cloud\
**Created:** [February 17, 2020, 6:31pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763 "2020-02-17T18:31:58Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [February 17, 2020, 6:31pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/1 "2020-02-17T18:31:58Z")

</div>

Hello,

I would like to know how to change

- the icon of my app
- the icon for the repoPage declared in my descriptor

The only thing I have is the default icon from the descriptor given in the help. And there is no instruction as to how to change it.

Any help/hints?

Thanks.

---

<div class="post-metadata">

**Author:** ![aagrawal2](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/aagrawal2/32/40775_2.png) [@aagrawal2](https://community.developer.atlassian.com/u/aagrawal2)\
**Post date:** [February 18, 2020, 12:42am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/2 "2020-02-18T00:42:01Z")

</div>

- The icon will be sourced from the Atlassian Marketplace; the icon that you uploaded there for your app listing. That is why this will not work for development apps; because there is no Atlassian Marketplace listing for your app yet.
- You can take advantage of `icon` property in repoPage for that. It would look something like this:

```auto
{
  "icon": {
    "width": 16,
    "height": 16,
    "url": "/my-icon.png"
  }
}

```

Cheers

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [February 18, 2020, 4:49am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/3 "2020-02-18T04:49:59Z")

</div>

Fantastic, thank you so much!

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [February 19, 2020, 5:53am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/4 "2020-02-19T05:53:30Z")

</div>

Actually, that does not seem to work.  
There is the following description of my page. When removing the icon definition, it works out of the box. I tried to find any definition of the JSON schema but did not find anything available online.

Any clue?

Thanks.

```
 "repoPages": [
   {
       "url": "/repoPage?repoUuid={repository.uuid}",
       "name": {
         "value": "MyPage"
        },
        "icon": {
           "width": 16,
           "height": 16,
           "url": "https://myhostname/bitbucket/app/logo-16.png"
        },
        "location": "org.bitbucket.repository.navigation",
        "key": "my-repo-page",
        "params": {
           "auiIcon": "aui-iconfont-discover"
         }
    }
 ],
```

---

<div class="post-metadata">

**Author:** ![connie](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/connie/32/39287_2.png) [@connie](https://community.developer.atlassian.com/u/connie)\
**Post date:** [February 19, 2020, 7:25pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/5 "2020-02-19T19:25:49Z")

</div>

> [@aagrawal2](#):
>
> The icon will be sourced from the Atlassian Marketplace; the icon that you uploaded there for your app listing. That is why this will not work for development apps; because there is no Atlassian Marketplace listing for your app yet.

Though this is the right idea, your app needs to be listed in the Bitbucket Marketplace, rather than the Atlassian Marketplace, to customize the icon for your app (the two marketplaces are separate entities but we’re working on consolidating them).

Custom icons for modules are currently broken, but there is work being done to fix it. I’ve raised a public issue [here](https://jira.atlassian.com/browse/BCLOUD-19924) to track the bug.

Also, these pages are helpful to reference when building a Bitbucket Connect app:

- [App descriptor](https://developer.atlassian.com/cloud/bitbucket/app-descriptor/)
- [About Bitbucket modules](https://developer.atlassian.com/cloud/bitbucket/about-bitbucket-modules/)

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [February 21, 2020, 5:02am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/6 "2020-02-21T05:02:38Z")

</div>

Thanks for providing more details, hope the issue can be fixed soon!

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [February 29, 2020, 9:58pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/7 "2020-02-29T21:58:42Z")

</div>

Hi,

Any update here? Is there a way to get this bug resolve? This is a branding issue for apps.

Thanks.

---

<div class="post-metadata">

**Author:** ![sconaty](https://sea1.discourse-cdn.com/atlassiandeveloper/user_avatar/community.developer.atlassian.com/sconaty/32/35552_2.png) [@sconaty](https://community.developer.atlassian.com/u/sconaty)\
**Post date:** [March 6, 2020, 8:56pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/8 "2020-03-06T20:56:30Z")

</div>

@anon29691650 the app icons are once again woking. Thank you for your patience.

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [March 6, 2020, 10:30pm UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/9 "2020-03-06T22:30:05Z")

</div>

That is fantastic, thank you so much, I will try this week end for sure!

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [March 7, 2020, 6:43am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/10 "2020-03-07T06:43:32Z")

</div>

I confirm this is working well! Thanks again for fixing it!

---

<div class="post-metadata">

**Author:** ![anon29691650](https://avatars.discourse-cdn.com/v4/letter/a/76d3ee/32.png) [@anon29691650](https://community.developer.atlassian.com/u/anon29691650)\
**Post date:** [March 12, 2020, 5:20am UTC](https://community.developer.atlassian.com/t/changing-icon-for-a-bitbucket-application/35763/11 "2020-03-12T05:20:11Z")

</div>

Hello,

The functionality just broke again. There is how I use the icon. When I specify the icon, the app cannot be installed. When I remove it, the app can be installed again.

Any idea as to why it broke?

Thanks.

```
"repoPages": [
  {
    "url": "/repoPage?repoUuid={repository.uuid}&userUuid={user.uuid}&userName={user.nickname}",
    "name": {
      "value": "<title>"
    },
    "location": "org.bitbucket.repository.navigation",
    "icon": {
      "url": "https://path/to/logo-24.png"
    },
    "key": "<mykey>"
  }
],
```