> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/administrative-settings-3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/administrative-settings-3/admin-panel-options/git-migration/migrating-a-story.md).

# Migrating a Story

The user can export and import a story file by using this feature.

## Story Migration (Exporting a Story)

{% hint style="success" %}
*Check out the given video to understand how to export a Story file.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F5vOzaROtm0QTQoxG7TA5%2FExporting%20Stroy_Story%20Migration.mp4?alt=media&token=6b2e2eb4-6b23-429d-9bb0-1b5ea6c94b10>" %}
***Exporting a Story File***
{% endembed %}

* Login to the Platform with a user account.
* Navigate to the ***Admin*** option.
* Open the GIT Migration option.
* Click the ***Story Migration*** option from the GIT Migration.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F8k2mCb3m5dhWqxlt5id4%2Fimage.png?alt=media&amp;token=49391236-ff3d-4281-8ed3-8cf7d6e9763f" alt=""><figcaption></figcaption></figure>

* The user gets redirected to the ***Export Document*** page.
* Click the ***Export*** option.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FqAFVfLksUNaJLdpuGgbA%2Fimage.png?alt=media&amp;token=61568b80-c409-4b96-90ca-be2279cac139" alt=""><figcaption></figcaption></figure>

* The user gets redirected to the ***Migration - Story Document Export*** page.
* Select an option to choose the Story file from the available documents options (My Documents, Public Documents, Favorites).
* The user can ***search*** for the specific file from the list.
* Select a ***Story*** file.
* Click the ***Push to VCS*** icon for the selected Story file.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F4plU7ELLW3FfC9yzUQVC%2Fimage.png?alt=media&amp;token=19b06886-6a6c-4d93-8949-b562ec0227be" alt=""><figcaption></figcaption></figure>

* The ***Story Migration- Export*** dialog box appears.
* Provide a &#x43;***ommit Message***.
* Click the ***Export*** option.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2Fhsr9UmEsNlWTutJ0sSiV%2Fimage.png?alt=media&amp;token=04524b9d-0009-4713-bf64-335eb4f37670" alt=""><figcaption><p><em><strong>Story Migration - Export dialog box</strong></em></p></figcaption></figure>

* A notification message appears to ensure the users about the success of the export action.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FY56prxNsl0mWkGKxZTA6%2Fimage.png?alt=media&amp;token=c7c90b88-12a0-41e4-a2ae-edbf71755611" alt=""><figcaption><p><em><strong>Notification message after the Story file gets Exported</strong></em></p></figcaption></figure>

## Importing Story

{% hint style="success" %}
*Check out the given video to understand how to import an exported Story file.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F46pdofUVhwhocy0gpv5W%2FStory%20Import.mp4?alt=media&token=b598bc4c-d714-421a-9ded-405261c5edb9>" %}
***Importing an Exported Story***
{% endembed %}

* Use another user's credentials.
* Click the ***Sign In*** option.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FvNElGxIMrVfIlh3KGOZa%2Fimage.png?alt=media&amp;token=c3eb1f7e-be12-42ce-9638-11b8c0acd95e" alt=""><figcaption><p><em><strong>Signing In to Platform with another user credentails</strong></em></p></figcaption></figure>

* Navigate to the ***Admin*** module.
* Open the ***GIT Migration*** option.
* Select the ***Import File*** option from the GIT Migration context menu.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FgCIN8OSmCYrpmHGQW0lk%2Fimage.png?alt=media&amp;token=bc9f8f2a-2afe-4eb1-b0d5-16746adcc4b3" alt=""><figcaption><p><em><strong>Accessing Import File option for Story Migration</strong></em></p></figcaption></figure>

* The ***Import Document*** page opens.
* click the ***Import*** option.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FiNkugOiu9kDHQ11Dblay%2Fimage.png?alt=media&amp;token=8c3a7e32-3c55-4581-a83a-c44d440f97de" alt=""><figcaption><p><em><strong>Import Document Page</strong></em></p></figcaption></figure>

* The ***Migration - Document Import*** page appears.
* Select a module using the given drop-down menu.
* Use the ***Search*** bar to search for a specific story file.
* A customised list of the exported stories appears based on the search.&#x20;

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FIsQiViGk4rZWSZqwT7zJ%2Fimage.png?alt=media&amp;token=9cc721f6-1ffb-4b84-a46b-c8f924104993" alt=""><figcaption><p><em><strong>Accessing the list of Exported Story files</strong></em> </p></figcaption></figure>

* Select a Story file from the displayed list.
* Available versions of the selected Story appears.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FNrF4LffFeWz8DNCoG4PL%2Fimage.png?alt=media&amp;token=4c2f16a5-9be6-4770-b2a2-be0fb6c83b2d" alt=""><figcaption><p><em><strong>Selecting a specific Story file</strong></em></p></figcaption></figure>

* Select a Version by using the given checkbox.
* Click the **Migrate** option.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F5WE8k7eu8zyecJUzYUMD%2Fimage.png?alt=media&amp;token=cd52810e-2149-4b8b-90c6-0f682386b8d7" alt=""><figcaption><p><em><strong>Selecting an exported version for Migration</strong></em></p></figcaption></figure>

* A notification message appears to ensure completion of the migration process.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2F3zCUBHhcLv7nJysxL2Dh%2Fimage.png?alt=media&amp;token=ffe84460-3d28-435c-9db5-d034857724cb" alt=""><figcaption><p><em><strong>The Notification message after the Migration process gets completed.</strong></em></p></figcaption></figure>

* Navigate to the Homepage of the Platform.
* The **My Documents** open by default.
* The migrated story gets added to the ***My Documents*** space.

<figure><img src="https://2073023115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkEZj56mLypG1iscFjXhx%2Fuploads%2FJQGvJkbjUxWZiKoWI00N%2Fimage.png?alt=media&amp;token=86e4145b-3eef-4263-a83b-16cdaa6f31cf" alt=""><figcaption><p><em><strong>Migrated Story Document</strong></em></p></figcaption></figure>