> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/gamification-basics/missions/featured-manually.md).

# Featured Manually

**Featured Missions** work the same way as **Generally Available** missions, with one key difference: they can **only** be assigned through a **Campaign**, **Automation Rule**, **Mini-game prize**, **Raffle prize**, or **manually** from a player's profile.

These missions:

* Appear at the top of the Gamification Widget with a Featured badge.
* Remain hidden until assigned to specific players.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-4266df49fc4ea23fbdc6940a4e5860f8700527d3%2Fimage%20(92).png?alt=media" alt=""><figcaption><p>GF Widget: Featured Manually Mission</p></figcaption></figure>

<mark style="color:blue;">**\[Opt-in: OFF]**</mark>**&#x20;Featured Manually + Availability Period**

If the opt-in option is disabled and the Start and End dates are configured, the mission will have the following behavior:

{% hint style="success" %}
Missions cannot be issued with a start date set for the future. The Start date must be either the current date and time or a date in the past.
{% endhint %}

* **After the Start Date,** the mission is visible in both the Overview and the Available tabs, with a timer showing the time until the End date is reached.
* **When the End date is reached** and the mission is not completed, it will go to the Missed tab with an Expired label.

<mark style="color:blue;">**\[Opt-in: OFF]**</mark>**&#x20;Featured Manually + Time to Complete the mission**

If the opt-in option is disabled and 'Time to complete the mission' is set, the mission will have the following behavior:

* **When the mission is given to the user,** the mission is visible in both the Overview and the Available tabs, with a timer showing the time left to complete the mission.
* **When the ‘Time to complete the mission’ is reached** and the mission is not completed, it will go to the Missed tab with an Expired label.

<mark style="color:blue;">**\[Opt-in: OFF]**</mark>**&#x20;Featured Manually + Time to Complete the mission + Availability Period**

If the opt-in option is disabled, 'Time to complete the mission' is set, and Start and End dates are configured, the mission will have the following behavior:

{% hint style="success" %}
Missions cannot be issued with a start date set for the future. The Start date must be either the current date and time or a date in the past.
{% endhint %}

* **After the Start Date,** the mission is visible in both the Overview and the Available tabs, with a timer showing the time left to complete the mission. This timer takes into consideration the End date as well, and it shows the shortest period that is left. So, in case the End date is closer in time than the time set in Time to complete the mission, the timer will show the time left until the End date and vice versa.
* **After the time to complete the mission or the End date is reached**, the mission will go to the missed tab with the Expired chip.

<mark style="color:purple;">**\[Opt-in ON]**</mark>**&#x20;Featured Manually + Availability Period**

If the opt-in option is enabled and the Start and End dates are configured, the mission will have the following behavior:

{% hint style="success" %}
Missions cannot be issued with a start date set for the future. The Start date must be either the current date and time or a date in the past.
{% endhint %}

* **After the Start Date,** the mission is visible in both the Overview and the Available tabs, with a timer showing the time until the End date is reached. The opt-in button is active, and there is a ‘Requires opt-in’ chip.
* **After Opt-in,** the timer continues counting the time until the End date, and there is a ‘You are opted in’ chip.
* **When the End date is reached** and the mission is not completed, it will go to the missed tab with the Expired chip.

<mark style="color:purple;">**\[Opt-in ON]**</mark>**&#x20;Featured Manually + Time to Complete the mission**

If the opt-in option is enabled and the 'Time to complete the mission' is set, the mission will have the following behavior:

* **When the mission is given to the user,** the mission is visible in both the Overview and the Available tabs, with an opt-in button and ‘Requires opt-in’ chip.
* **After Opt-in,** the timer appears showing the time left to complete the mission with an ‘You are opted in’ chip.
* **When the time to complete the mission is reached** and the mission is not completed, it will go to the missed tab with the Expired chip.

<mark style="color:purple;">**\[Opt-in ON]**</mark>**&#x20;Featured Manually + Time to Complete the mission + Availability Period**

If the opt-in option is enabled, 'Time to complete the mission' is set, and Start and End dates are configured, the mission will have the following behavior:

{% hint style="success" %}
Missions cannot be issued with a start date set for the future. The Start date must be either the current date and time or a date in the past.
{% endhint %}

* **After the Start Date,** the mission is visible in both the Overview and the Available tabs, with a timer showing the time until the End date is reached. The opt-in button is active, and there is a ‘Requires opt-in’ chip.
* **After Opt-in,** the timer is changed, and it shows the time left to complete the mission. This timer takes into consideration the End date as well, and it shows the shortest period that is left. So, in case the End date is closer in time than the time set in Time to complete the mission, the timer will show the time left until the End date and vice versa.
* **After the time to complete the mission or the End date is reached,** the mission will go to the missed tab with the Expired chip.

### Progress Reset Modes

When assigning a Featured Manually mission via a Campaign (Journey or Scheduled), an Automation Rule, or manually from a user profile, you can configure the **Progress Reset Mode** to determine what happens if the user was already granted the mission:

* **Keep progress if the mission was already given to a user:** Preserves existing task completion and progress without resetting anything.
* **Reset progress, if the mission was given, but not COMPLETED yet:** Clears progress back to zero only if the user has not finished the mission. Already completed missions remain untouched.
* **Reset progress and restart mission, if it was given and already COMPLETED:** If the user previously completed the mission, their completion is wiped so they can receive and complete the mission again. Incomplete missions have their time window extended without wiping current progress.
* **Reset progress if the mission was already given to a user:** Completely resets the mission and clears all progress regardless of whether it was completed or in progress.

### Additional Settings

* **Expose mission immediately on unlock:** Available under the **Additional** settings tab. When enabled, the mission immediately appears in the player's widget upon being granted, without waiting for regular cache updates.
* **Who can see and progress in the mission:** You can apply segment or condition filters. Even when a mission is granted via a Campaign or Automation Rule, the player must satisfy these conditions to see and progress in the mission.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/products/gamification-basics/missions/featured-manually.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
