> For the complete documentation index, see [llms.txt](https://releaseowl.gitbook.io/releaseowl-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://releaseowl.gitbook.io/releaseowl-docs/releaseowl-user-guide/sap-analytics-cloud/working-with-userstories.md).

# Working with UserStories

User Stories allow you to group and manage artifacts that are deployed together through a Release Pipeline.

#### Creating a User Story

* Navigate to **Change Management** and click on **User Stories**.
* Click **Create New User Story**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FY3QdZ05RFUuxCfn765pz%2Fimage.png?alt=media&amp;token=fc017e95-bbc2-442d-aa6d-54572905ecf9" alt=""><figcaption></figcaption></figure>

* Fill in the required fields, such as:
  * **Summary**: A clear and concise name for the user story.
  * **Description**: Detailed explanation of the requirement or feature.
  * **Release Version**, **Sprint**, **Assigned To**, and any other custom fields as applicable.
* After entering the details, click the **Save** button to create the User Story.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FdfJjEJkTffTvcV5QuBR7%2Fimage.png?alt=media&amp;token=e7abb696-3c2e-4586-a3ee-db6a078129e1" alt=""><figcaption></figcaption></figure>

* Once the User Story is created, it will appear in the list/grid view.
* Click on the **Edit** next to the User Story entry.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FWiBbCx8q5u94zy7Oic0p%2Fimage.png?alt=media&amp;token=a8cb564b-5da6-4f5a-813e-b4dcf6b3eca5" alt=""><figcaption></figcaption></figure>

* Click on the **+Add** button to add **SAC Packages**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2F98Zps1eS5uwyNtK2iLQ9%2Fimage.png?alt=media&amp;token=9008099c-c37c-47c9-aa52-f6a082d6c5b6" alt=""><figcaption></figcaption></figure>

* Click the **three-dot (More Actions)** menu.
* Select **Import Settings**.
* A pop-up message will appear, where you can enable the **Force Deploy** option. Click **Save** to apply the changes.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FddCKpQPFM9l9Rj0srK5G%2Fimage.png?alt=media&amp;token=d5b41cf9-45dc-4344-95df-97114725b2ae" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:  Force Deploy** — lets you redeploy the artifacts/agreements again even if it was already deployed.

* When *Force Deploy* is enabled, version validation checks do not block the deployment.
* If the target environment version is higher than the source environment version, a warning message is displayed.
  {% endhint %}

**Promote User Story:**

* Click on **Promote** to promote the user story.

<img src="https://releaseowl.gitbook.io/releaseowl-docs/~gitbook/image?url=https%3A%2F%2F1890383800-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDWyxe6hm5vqosFaByVgs%252Fuploads%252Fpk49PKP99ZYYZKZDfLnp%252Fimage.png%3Falt%3Dmedia%26token%3D35733827-b0c0-4eeb-9b4e-eba54709ec91&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=746e2dde&#x26;sv=2" alt="" height="820" width="1912">

1. **Check Deployment Status:**

* Click on the **Pipeline Activity** to view the deployment status.

<img src="https://releaseowl.gitbook.io/releaseowl-docs/~gitbook/image?url=https%3A%2F%2F1890383800-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDWyxe6hm5vqosFaByVgs%252Fuploads%252F03wEMvGM8yKUMTaV5RSr%252Fimage.png%3Falt%3Dmedia%26token%3D86e3b22b-e43a-4730-8081-cbb812732de3&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=243cea1&#x26;sv=2" alt="" height="657" width="1366">

* Click the **"Deploy Log"** button to open a pop-up window displaying deployment details.

<img src="https://releaseowl.gitbook.io/releaseowl-docs/~gitbook/image?url=https%3A%2F%2F1890383800-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FDWyxe6hm5vqosFaByVgs%252Fuploads%252FvmTiXj88LvsmhQvNFPVX%252Fimage.png%3Falt%3Dmedia%26token%3D583d4517-7016-4bf8-8fff-e85ba04eaf1c&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=59641bf&#x26;sv=2" alt="" height="640" width="1200">
