> For the complete documentation index, see [llms.txt](https://stepsize.gitbook.io/stepsize-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stepsize.gitbook.io/stepsize-documentation/issues/how-to-create-an-issue.md).

# How to create an issue

Use Stepsize to create better, **more actionable** issues right here in your code editor.

Traditional issues lack context and visibility. Stepsize issues have powerful context built in from the start, and are visible throughout your software development cycle. All without leaving your codebase.

## **How to create an issue in your editor** 🪄

1. **Select** the snippet of code you want to create an issue from
2. **Use the shortcut `[^/I]`** to create your issue, or right click and select `Create a technical issue`
3. **Add context** to your issue, such as a title, description, and impact
4. Hit `Create issue` to finish creating your issue

   <figure><img src="https://res.cloudinary.com/drvhrxrne/image/upload/v1670854755/samples/product_guides/Create_new_issue_s52z1b.gif" alt=""><figcaption></figcaption></figure>

Congratulations! You've created a Stepsize issue. You can now see the Stepsize inline annotation indicating that there is an issue attached to this snippet of code.

![Creating your issue](https://res.cloudinary.com/drvhrxrne/image/upload/v1669989064/samples/product_guides/Screenshot_2022-12-02_at_13.50.26_gfk7mm.png)

{% hint style="success" %}
None of your code goes into the Stepsize cloud. The Stepsize integrations have been designed with privacy in mind. [See our Information Security Guide](https://storage.googleapis.com/stepsize-assets/Stepsize%20Information%20Security.pdf) for more detail.
{% endhint %}

<br>

## **Creating an issue from a pull request** 🌱

You can create issues from pull requests.

Start your comment with `[stepsize]` to create an issue from a `diff`.

The issue will be automatically linked to the code it relates to, both in your code editor and in the web app.

{% hint style="info" %}
This is a great way to track improvements that come up during review that you don't have time to take care of before merging.
{% endhint %}

## **What next?**

Stepsize issue are inherently linked to code. You can link multiple snippets, files or folders.

Let's learn how to add more code and context to your issues.