mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-02-07 19:06:05 +03:00
Import an exported book or shelf #2694
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @bdorr1105 on GitHub (Mar 5, 2022).
Describe the feature you'd like
I would love to be able to export a complete book or even a shelf and have the ability to import that where it maintains all the same formatting.
Describe the benefits this would bring to existing BookStack users
This would be game changing, as it stands, when I export a book in html format, it does not retain the formatting> I can do markdown and fix the issue that way, but if I have a book that is 10 chapters with about 10 pages in each chapter, that then becomes a bit much to manually create that and then have to copy and paste my way through that. If you could just hit import book, that would be amazing
Can the goal of this request already be achieved via other means?
Yes, as explained above, a long drawn out process
Have you searched for an existing open/closed issue?
How long have you been using BookStack?
0 to 6 months
Additional context
No response
@ssddanbrown commented on GitHub (Mar 8, 2022):
Thanks for the request @bdorr1105. Much related to many existing issues (#2405, #1138, #723, #42). I may close this in a future reorganisation/collapsing of these issues to create some focus in this area.
To help my understand your use-case, can you describe how exactly you're looking to use this feature? are you wishing to import into the same instance? Or are you wanting to import into a separate instance?
Just to be clear, not looking to discuss potentials or possibilities, just wanting to know your exact current needs.
@bdorr1105 commented on GitHub (Mar 12, 2022):
I am wishing to export from a completely different bookstack, let's say a friends and be able to import directly into my own, like a direct clone if you will. What would be best is if it were to update the hyperlinks so when you clicked on a photo the http or https link updates. I have exported as an HTML and copied and pasted each page 1 by 1 and it was painful. I also had to go back through and manually format to achieve the same look.
@tvogt commented on GitHub (May 4, 2022):
Second this. I was also looking today for a way to migrate an entire book from one instance to a different instance and couldn't find one.
@KieranFJ commented on GitHub (May 4, 2022):
Thirded, im likely going to have two instances in the future and it would be great if i could create a book on one, then when finished, import it to the other.
@mervincm commented on GitHub (May 18, 2022):
I would use this to migrate/move books/shelves from one instance of Bookshelf to another.
@towerplease commented on GitHub (Feb 23, 2023):
This feature would be great! I also could need this.
@BrightFutur commented on GitHub (Feb 26, 2023):
Hi everyone. I translate the books in German and English for a collective and this feature would save us big time when synchronising our versions. We maintain books for a web application we all use. We have the shelves for the languages and the books for the "How-to", "General Info", and "Knowledge Base".
Count me in as first user
@lazynooblet commented on GitHub (Mar 22, 2024):
I just wanted to add my voice to this. There are multiple issues both open and closed (mostly closed) regarding importing and exporting to/from various formats. I understand the challenges of having to deal with external file types and the compatibility chaos it would create.
My personal use-case is that I create documentation for projects on an instance that is exclusive to the customer. In some cases as part of a project I would stand-up their own bookstack instance. I have about 80 pages for various configurations I use as standard and I'm currently copy/pasting the content between two browser tabs, and then copy/pasting each image. It is time consuming.
I'd benefit immensely on an export and import function, even if to a proprietety format. Like exporting to a zipped JSON file that embeds non-text as base64 content.
As I'm a commercial entity (even if only a sole trader), I'm willing to donate for this feature to be bumped up the todo list :)
@toskium commented on GitHub (Mar 23, 2024):
I second the comment from @lazynooblet. As I am a commercial user of Bookstack as well I would benefit immensly from this feature.
If it helps speeding up the development of this feature I would chip in as well.
@Xaneph commented on GitHub (Apr 28, 2024):
I would be great to be able to import at the shelf level. so export/import shelf options.
@ssddanbrown commented on GitHub (Jan 22, 2026):
I'm going to go ahead and close this off since we added the importable zip export format in v24.11: https://www.bookstackapp.com/blog/bookstack-release-v24-12/#new-importable-export-format
If there's still extra demand for shelf support, that can be raised and tracked separately.