# Challenges

Challenges in Writing Analytics let you write together with other writers. During a challenge, you can see how the others are progressing, and they can see your progress too.

It's like working from a coffee shop with a group of friends but on the Internet. You may challenge fellow writers to hit a word or time goal during a day or invite them for a short, focused writing sprint.

This document describes how to join a challenge; how to create one and dives into the mechanics of the feature so that you can make the most of it.

### Joining a Challenge

To join a challenge, navigate to the *Challenges* section using the main menu at the top of the page.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FFCYQAvigRwU6rb4ptiZ3%2FScreenshot%202022-11-01%20at%2019.39.44.png?alt=media&#x26;token=7f17488d-418d-4cfd-bb00-f3c56bd126af" alt=""><figcaption></figcaption></figure>

Here you'll find all the public challenges that are in progress or that will be starting soon.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2F8O4Fizk0pABHRInyak5y%2FScreenshot%202022-11-01%20at%2019.45.09.png?alt=media&#x26;token=96415a6b-e04c-4dab-8ea1-c6639c16543d" alt=""><figcaption></figcaption></figure>

Clicking on the challenge title will take you to the its dashboard.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FXx2owS0nQuyfofjuHgAe%2FScreenshot%202022-11-01%20at%2022.46.55.png?alt=media&#x26;token=6f676fec-a124-433e-8f11-e7ae9da71b15" alt=""><figcaption></figcaption></figure>

The description box will also tell you what the goal is. The owner of the challenge decides what the goal will be. The options are:

* **Word goal** — write at least X number of words
* **Time goal** — write for at least Y number of minutes
* **Open goal** — each participant can set their own goal (or have no goal at all)

On the left is a list of all participants along with their current progress.

To join, click the **Join Challenge** button in the top-right corner. A form will pop up prompting you to create a new session.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FSlFNx5F6jst5q5R4QoRe%2FScreenshot%202022-11-01%20at%2019.51.36.png?alt=media&#x26;token=42b42218-61ac-4736-bdb3-7f5db885539a" alt=""><figcaption></figcaption></figure>

If you join before the challenge starts, you'll be taken to the waiting room:

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FRMKwOGqK877Ms7b5qnrD%2FScreenshot%202022-11-01%20at%2019.53.07.png?alt=media&#x26;token=493d4b2b-60ca-4356-bdac-aa2da0c395f0" alt=""><figcaption></figcaption></figure>

As soon as the challenge starts, you'll be able to get going.

#### Multiple Sessions Per Challenge

While you can only have one active session per challenge at any given time, if you finish working on one thing and want to keep going within the same challenge, you can add another session and keep writing.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FAxW7ywe13q65dmUNvctR%2FScreenshot%202022-11-01%20at%2020.17.23.png?alt=media&#x26;token=65b54dec-acbc-4298-88e7-e070ff88d43c" alt=""><figcaption></figcaption></figure>

Go back to the challenge and click the **Add Session** button. A new session will be added to the challenge. The words from all your sessions will count towards the challenge goal.

### Creating a Challenge

If you don't find a challenge or sprint that works for you, you can start your own and invite others to join you.

To create a new challenge, go to the *Challenges* section and click the **New Challenge** button. A form will prompt you to provide some information about your challenge.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FAc6eZCNRowht4EdVv4z5%2FScreenshot%202022-11-01%20at%2019.48.42.png?alt=media&#x26;token=5485afbd-3829-426f-ac12-9a6cecdc6de3" alt=""><figcaption></figcaption></figure>

You can select a goal and the start and end times. To attract as many participants as possible, leave a larger time window for people to join. Not everyone may be available at the same time.

To have all participants writing all at once — more like a writing sprint — set the time window to a time window appropriate for the goal (like an hour to write 500 words).

#### Private Challenges

By default, your challenge will be listed in the app to let other writers join. If you'd prefer to only write with your friends, you can set your challenge to private.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FDEVWrD11r5BWdIo0Nrq0%2FScreenshot%202022-11-01%20at%2019.49.17.png?alt=media&#x26;token=718627eb-a95c-4ec5-a695-e8d22168967f" alt=""><figcaption></figcaption></figure>

Private challenges are not listed in the app. To invite others, share the link to the challenge with them.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FeJARwc1B7YahOGLmX86j%2FScreenshot%202022-11-01%20at%2019.46.18.png?alt=media&#x26;token=5de2db96-8c64-4ac7-ab5f-0835b66f786f" alt=""><figcaption></figcaption></figure>

After you set up a new challenge, click the **Add Session** on the *Challenge* view.

A *New Session* form will come up as if you were joining someone else's challenge. Fill it in, and you're all set.

### Completing a Challenge

Once in the editor, you can write as if you were working on a regular session on your own. The session's goal will be set to the challenge's goal.

You don't have to watch the time to end the session before the challenge time is up. You can keep working for as long as you like. Writing Analytics will only include words written before the end of the challenge in the results.

To see how other writers are doing, click the *challenge widget* just under your session's title in the editor.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2Fgdy05IdLYnrSZALD7CyW%2FScreenshot%202022-11-01%20at%2022.52.36.png?alt=media&#x26;token=8fa3de7b-5b9a-46f8-b550-5d55f81fb3b5" alt=""><figcaption></figcaption></figure>

By default, the widget shows the time left, but you can change this in the top right corner to show the number of participants, the total number of words written by everyone or even your current position on the leaderboard.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FRGa0jP8AxWhxl7bgI8vy%2FScreenshot%202022-11-01%20at%2022.53.23.png?alt=media&#x26;token=0fe9816d-f3d8-466a-93d3-6e487050cf64" alt=""><figcaption></figcaption></figure>

### Challenge Results

As people finish writing and end their sessions, their results will appear on the challenge dashboard.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FDdg3vaBjou0mvkyjltNV%2FScreenshot%202022-11-01%20at%2023.00.19.png?alt=media&#x26;token=bbc8495f-0721-4935-ac3a-99b0fab056d4" alt=""><figcaption></figcaption></figure>

You can see the total number of words and time spent by all participants collectively as well as the average figures per person.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FsULMkwWcrZXGcbN27X3S%2FScreenshot%202022-11-01%20at%2023.07.18.png?alt=media&#x26;token=a0444a5b-526e-42c4-ae69-1f5d4e5f9d7d" alt=""><figcaption></figcaption></figure>

This section also includes a few highlights like who was the most focused, typed the fastest or was the most productive.

Please note that these aren't final and will be updated until the very end of the challenge.

### The Leaderboard

Have a bit of a competitive streak? The challenge leaderboard shows you how well you've done compared to the other participants. The order depends on the type of challenge.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2F1x7owB0YhNJgp8Ag13rw%2FScreenshot%202022-11-01%20at%2022.56.38.png?alt=media&#x26;token=7e12bedc-fecb-45e2-8507-a27d160c9e9d" alt=""><figcaption></figcaption></figure>

The order is different for different types of challenges:

* **word goal and open challenges** — ordered by word count
* **time goal** — ordered by time spent writing

After the challenge ends, you can click on each participant on the leaderboard to see their session analytics.

### Updating and Deleting Challenges

You can only update or delete the challenges that you started. However, there are certain restrictions in place after other participants have joined.

You can always change the title and description. You can also make it public or private at any time. Making a challenge private won't remove any existing participants.

Deleting a challenge or updating the goal, start and end times after other participants have joined is not permitted.

To update a challenge, click the three dots in the top-right corner of the challenge screen and select **Settings**.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FK8tKxM7ChOyGjp5m10SN%2FScreenshot%202022-11-01%20at%2022.46.07%20copy.png?alt=media&#x26;token=c2ea668d-3b6e-406b-b830-26dbac2a156d" alt=""><figcaption></figcaption></figure>

To delete a challenge, click **Delete**.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FOmzozW40W1prwzmmkCJQ%2FScreenshot%202022-11-01%20at%2019.59.16.png?alt=media&#x26;token=3eb1313f-ca4c-4f3a-89d6-e2b5d365306c" alt=""><figcaption></figcaption></figure>

### Leaving a Challenge

You cannot leave a challenge that you started at this time.

You can leave a challenge you joined by clicking the **Leave Challenge** button in the top-right corner.

<figure><img src="https://3527028550-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-eNurQWOZkxoWDF_uD%2Fuploads%2FVumgAFhG07jcG5so5qR8%2FScreenshot%202022-11-01%20at%2019.58.11.png?alt=media&#x26;token=a7f140fb-8162-4174-8e64-c16b3fdfdba8" alt=""><figcaption></figcaption></figure>

Your session will be removed from the challenge, but it won't be deleted. You'll be able to find it on the *Sessions* page.

*Have a question? Reach out to us at* [*support@writinganalytics.co*](mailto:support@writinganalytics.co)*. We'll be happy to help!*
