Can be used to serve html pages from another branch?

I use "" as described in to present static html pages to our users. these contain API reference documentation. I link to those pages from markdown documentation pages.

This works OK for the master branch. However, I also have other branches, representing previous versions of the API. Is it possible to refer to documents in other branches? I was hoping something like "{branchname}/ref/webframe.html" would work, but it doesn't. It just gives me a file not found error.

1 answer

0 votes
Daniel Eads Atlassian Team Aug 13, 2018

This question is pretty old but just confirming that we don't currently support publishing from a non-Master branch to The docs should be updated shortly to clarify this.

The documentation says it uses the main (master) branch of the repo for the pages.

If you change the main branch setting in Repository Details to a different branch, does the publishing use master, or the branch selected as the main for the repo? 

The wording of the documentation is ambiguous and open to interpretation.

If it is ONLY master, then the "main branch" wording needs to be removed

If it is whatever the "main branch" for the repo is, then the "master" wording needs to be removed.

Daniel Eads Atlassian Team Oct 30, 2018

Hey Jade,

You're correct - if you change the Main branch from the repository settings, whatever is selected as the main branch will be what's published. By default this is master, which is probably why it's worded the way it is now.

We'll have a technical writer take a look to try and clarify this in the documentation.


Hi Daniel,

Thanks for clarifying.

Not sure if that helps the original poster, but for others, I changed my main branch to Develop, and the site used that branch in the .io site, so it works as you say above.

I'm using the main branch (set to Develop) as a staging site, and have just set up a deployment Pipeline to deploy to the FTP site whenever Master is committed to - exactly the setup I needed!

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 06, 2018 in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

1,893 views 7 10
Read article

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you