> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fallback Items

> Fill the empty slots in a MoEngage recommendation with popular items or another recommendation, so a recommendation never reaches a user blank.

When you use a recommendation in a campaign, you set how many items it returns. Each item fills one slot, which is one place in the campaign where an item appears. The model does not always find enough items, so some slots stay empty and the campaign reaches the user with gaps, or with nothing at all.

Fallback items let you choose what fills the slots your recommendation could not. MoEngage uses that choice whenever the recommendation comes up short, so users see items rather than gaps.

# Why Fallback Items Are Needed

A recommendation returns fewer items than you asked for in the following situations:

* **The user is new or inactive.** A personalized model has no history to work from. This also affects every user in the hours after a catalog upload.
* **Filters narrow the pool too far.** Each item attribute filter and business rule removes candidates, and several together can leave few items or none.
* **Items are out of stock or the feed is stale.** A feed that carries only in-stock items excludes the rest, and one that refreshes on a lag can hold items that are gone.
* **The source item is not in the catalog.** An item-to-item model needs the current item's ID in the catalog. If your site sends a different ID than the feed carries, it has nothing to match.

Fallback items cover all of these, because they respond to the result rather than the cause. Whenever the recommendation returns too few items, MoEngage fills the rest.

# How Fallback Items Work

**Number of items to show** sets the number of slots.

MoEngage runs your recommendation first. This is the primary recommendation. If it returns fewer items than there are slots, MoEngage fills the leftover slots from the fallback you configured. MoEngage keeps every item the primary recommendation found and fills only what is left over, so personalized results come first.

A fallback is one level deep. Suppose your recommendation uses Fallback 1, and Fallback 1 has a fallback of its own. MoEngage runs your recommendation, then fills the leftover slots from Fallback 1, and stops there. It does not go on to Fallback 1's own fallback.

<Note>
  A fallback fills empty slots. It does not widen the recommendation itself, so it does not change which items the model considers or the order it ranks them in.
</Note>

# Set the Number of Items to Show

**Number of items to show** sets how many items you want the recommendation to return. That number decides how many slots the fallback has to fill. For example, if you set 10 and the recommendation finds 6 items, the fallback fills the other 4.

MoEngage fills the field with 10 when you create a recommendation. You can change it up to the maximum for your workspace, which MoEngage shows under the field. That maximum is 25 unless you ask for more, so contact MoEngage Support if you need a higher number.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-number-of-items.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=ceda1b56acf89265531a3bdf7563c408" alt="The Number of items to show field highlighted below the Catalog list, with the maximum limit below the field" width="514" height="338" data-path="images/recommendations-fallback-number-of-items.png" />

# Configure Fallback Items

You can configure fallback items while you create a recommendation, or on one you already have. Catalog alerts recommendations have no **Fallback items** section.

The **Fallback items** section opens in a different state for each recommendation:

| Recommendation | State of the section |
| - | - |
| A new Advanced recommendation that can use popular items | MoEngage turns the toggle on and selects **Popular items**. |
| A new Advanced recommendation that cannot | MoEngage turns the toggle on and selects **Select specific recommendation**. |
| A new Basic recommendation | MoEngage leaves the toggle off and selects no option. |
| A recommendation you already have | MoEngage shows whatever you configured earlier. |

An Advanced recommendation cannot use popular items in either of the following cases:

* It uses the Trending Items model, which offers only **Select specific recommendation**.
* Your workspace has no active Advanced recommendation for popular items to draw on, which is the case for your first one.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-basic-toggle-off.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=b33d5f005b4820b7828e07bbdd310471" alt="A new Basic recommendation with the Fallback items toggle off and no option selected" width="1586" height="416" data-path="images/recommendations-fallback-basic-toggle-off.png" />

To configure fallback items, perform the following steps:

1. Open an existing recommendation, or create one:

   * To add a fallback to a recommendation you already have, find it on the Recommendations page and click the edit icon under **Actions**.
   * To create a new recommendation, follow the steps in [Creating Advanced Recommendations](/docs/user-guide/content/recommendations/advanced-recommendations/creating-advanced-recommendations) or in the article for the model you want.
2. Scroll to **Fallback items**, and then turn the **Fallback items** toggle on.

   <img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-toggle-on.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=b4df8e73bc048f5cb1c559498b0f7103" alt="The Fallback items toggle turned on, with the section highlighted" width="1440" height="300" data-path="images/recommendations-fallback-toggle-on.png" />
3. Select one of the following options:

   * **Popular items**: MoEngage fills the empty slots with popular items. For more information, refer to [Popular Items](#popular-items).
   * **Select specific recommendation**: MoEngage fills the empty slots with the items from a recommendation you choose. For more information, refer to [Specific Recommendation](#specific-recommendation).

   <img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-options.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=5ea9d2821070a14d0e06f7c350d07ef6" alt="The two fallback options highlighted, Popular items and Select specific recommendation" width="1512" height="254" data-path="images/recommendations-fallback-options.png" />
4. Click **Save**.

## Popular Items

MoEngage fills the empty slots with popular items. Popular items do not depend on a user's history, so they return results for every user, including a new one.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-popular-items.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=03fa0fcd7b00a84feabf08d3cab23f4a" alt="The Fallback items section with the toggle on and the Popular items option highlighted and selected" width="1656" height="376" data-path="images/recommendations-fallback-popular-items.png" />

You can use this option only on the Recommended items, Similar items, Frequently bought together items, and Frequently viewed together items models. The User Actions, Item attributes, and Trending Items models offer only **Select specific recommendation**.

The option also needs at least one active Advanced recommendation in your workspace. Until you have one, MoEngage disables the option. Hover over it to view the reason.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-popular-items-locked.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=da5c9ce0fe1471536277f22034f94335" alt="The Fallback items section with the Popular items option highlighted and disabled, and its tooltip stating that at least one advanced recommendation must be active" width="1446" height="428" data-path="images/recommendations-fallback-popular-items-locked.png" />

If your model does not offer popular items, or your workspace has no Advanced recommendation yet, choose a specific recommendation instead.

## Specific Recommendation

MoEngage fills the empty slots with the items from a recommendation you choose. Choose one that returns results for any user, such as a Trending Items recommendation, because a fallback that depends on user history can come back empty for the same users your recommendation already missed.

To choose a recommendation as the fallback, perform the following steps:

1. Click the **Select recommendation** box.
2. In the **Search to select** box, type the name of the recommendation you want.
3. Click the recommendation. Its description, the model it uses, and when someone last modified it appear on the right.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-select-list.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=c821f11603527c0cf85b7a3877d5527d" alt="The Select recommendation list open, with the Search to select box highlighted on the left and the details of the selected recommendation highlighted on the right" width="1358" height="608" data-path="images/recommendations-fallback-select-list.png" />

The list holds only the recommendations that:

* Use the same catalog as the recommendation you are configuring.
* Carry the Active status.
* Are not Catalog alerts recommendations.

# Test a Recommendation with Fallback Items

Test a recommendation to check whether its fallback fills the empty slots for a user. Run the test as described in [Test a Recommendation](/docs/user-guide/content/recommendations/getting-started/test-a-recommendation). In the result, the fallback appears under **Recommendation conditions** as **Fallback items**, with a checkbox named after the fallback you configured.

To check what the fallback contributes, perform one of the following actions:

* Select the checkbox to view the recommendation's own items and the fallback items together.
* Clear the checkbox to view only the items the recommendation returned.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-test-panel.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=cdd82d030afc7b6b034fcb1ff3f63b89" alt="The Test recommendation panel, with the Fallback items group highlighted under Recommendation conditions and the item preview on the right" width="3202" height="1368" data-path="images/recommendations-fallback-test-panel.png" />

Compare the two results. The fallback added any item that appears only when you select the checkbox. If both results show the same items, the recommendation found enough items on its own.

# Change the Catalog on a Recommendation

A recommendation and its fallback must use the same catalog, so changing the catalog breaks any fallback link the recommendation is part of. MoEngage warns you when you pick the new catalog, and again when you save.

The first warning states a different message for each fallback link the recommendation has:

| The recommendation | What the dialog box states |
| - | - |
| Has a fallback | Changing the catalog removes that fallback, because both recommendations must use the same catalog. |
| Is the fallback for other recommendations | Changing the catalog removes it as their fallback. The dialog box lists them by name, with the status of each. |
| Both | Both messages. |

To change the catalog, perform the following steps:

1. Open the recommendation.
2. In the **Catalog** list, select the catalog you want to use. The **Are you sure you want to change the catalog for this recommendation?** confirmation dialog box appears.

   <img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-catalog-confirmation.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=3792acfd45a7b5ccdca9d28c18f3f8fa" alt="The catalog confirmation dialog box listing the active recommendations that use this one as their fallback, with the Cancel and Change anyway buttons highlighted" width="1332" height="514" data-path="images/recommendations-fallback-catalog-confirmation.png" />
3. Perform one of the following actions:

   * To change the catalog, click **Change anyway**.
   * To keep the current catalog, click **Cancel**.
4. Scroll to **Fallback items**, and then select a fallback again.
5. Click **Save**. The **Are you sure you want to save this recommendation?** confirmation dialog box appears.

   <img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-save-anyway.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=b29f1bef92401d5d83385e08e25bf9b2" alt="The Are you sure you want to save this recommendation dialog box, with the Cancel and Save anyway buttons highlighted" width="1580" height="694" data-path="images/recommendations-fallback-save-anyway.png" />
6. Click **Save anyway**.

MoEngage removes the fallbacks when you save, which is why it asks a second time. The recommendations that lose the fallback keep running without one, and you cannot undo this. Set a new fallback on each of them afterwards.

# Archive a Recommendation Used as a Fallback

An archived recommendation stops returning items, so it can no longer serve as a fallback. When you archive one, MoEngage removes it from every recommendation that was using it as a fallback.

To archive a recommendation that other recommendations use as their fallback, perform the following steps:

1. On the Recommendations page, click the archive icon under **Actions** for the recommendation. The **Are you sure you want to archive this recommendation?** confirmation dialog box appears.

   <img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-archive-icon.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=c0058ee52626bd782a1a93af224d72de" alt="The Recommendations page with the archive icon under Actions highlighted for the Basic_Main_Fallback recommendation" width="3312" height="1356" data-path="images/recommendations-fallback-archive-icon.png" />
2. Perform one of the following actions:

   * To archive the recommendation, click **Archive Anyway**.
   * To leave the recommendation active, click **Cancel**.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-archive-confirmation.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=381574af444c09ef4e9ea6298d3987b0" alt="The confirmation dialog box, listing the active recommendations that use this one as their fallback, with the Cancel and Archive Anyway buttons highlighted" width="1414" height="544" data-path="images/recommendations-fallback-archive-confirmation.png" />

The dialog box lists every recommendation that uses this one as its fallback, with the status of each. After you archive, those recommendations keep running, but with no fallback. Open each one and select a new fallback. You cannot undo this.

A recommendation that nothing uses as a fallback shows the standard archive prompt instead. For more information, refer to [Manage Recommendations](/docs/user-guide/content/recommendations/basic-recommendations/manage-basic-recommendations).

# When Fallback Items Are Locked

Fallback items is part of Advanced Recommendations. If your workspace does not have Advanced Recommendations, the **Fallback items** section carries a **Locked** badge and you cannot turn the toggle on. The lock covers the whole workspace, so you find it on every recommendation, whichever model you use.

<img src="https://mintcdn.com/moengage/cMbUwShbIQ8MMUeY/images/recommendations-fallback-locked.png?fit=max&auto=format&n=cMbUwShbIQ8MMUeY&q=85&s=67b348c3735a819326074f5a27bc96f0" alt="The Fallback items section at the bottom of the recommendation setup, with a Locked badge next to the toggle" width="2988" height="1236" data-path="images/recommendations-fallback-locked.png" />

<Note>
  To add Advanced Recommendations to your workspace, contact your MoEngage CSM (customer success manager).
</Note>

# Related Articles

* [Test a Recommendation](/docs/user-guide/content/recommendations/getting-started/test-a-recommendation)
* [Manage Recommendations](/docs/user-guide/content/recommendations/basic-recommendations/manage-basic-recommendations)
* [Creating Advanced Recommendations](/docs/user-guide/content/recommendations/advanced-recommendations/creating-advanced-recommendations)
