The "Settings" page in RuffRuff Order Bonus has three sections: "Admin," "Online store (Theme Extensions)," and "Automation."
Manage the language displayed in the app admin and other settings.
Set the language displayed in the app admin.
Option | Language |
|---|---|
English | English |
Japanese | Japanese |
Tip: The default is the language set for your Shopify account. This does not affect the language customers see on the online store.
Configure how gifts are added, how product card badges appear, and the popup and toast text on the online store.
Configure how gifts are added to the cart when "Use settings page configuration" is selected as the Simple gift distribution method.
Field | Description |
|---|---|
Automatically add gift to cart | Automatically adds a gift to the cart when the conditions are met. This is available only when the gift type is "Simple gift." |
When checked (enabled): The gift is added to the cart automatically when the distribution conditions are met.
When unchecked (disabled): The gift is not added automatically when the distribution conditions are met. The customer must select "Claim" in the widget to add the gift to the cart.
Set the position and size of product card badges.
Field | Description | Default value |
|---|---|---|
Badge position | Choose Top Left, Top Right, Bottom Left, or Bottom Right. | Top Left |
Top inset | Shown when the position is at the top. Adjusts the badge position upward (px). | 0px |
Bottom inset | Shown when the position is at the bottom. Adjusts the badge position downward (px). | 0px |
Left inset | Shown when the position is on the left. Adjusts the badge position to the left (px). | 0px |
Right inset | Shown when the position is on the right. Adjusts the badge position to the right (px). | 0px |
Maximum badge count | Maximum number of badges displayed per product card (1–10). | 2 |
Font size | Badge text size (px). | 14px |
Font weight | Badge text weight. | 500 |
Caution: If the badge is not displayed or the layout appears broken, contact support.
If badges are not displayed on your theme or a third-party app's product card, you can use CSS selectors to specify the target elements.
Field | Description | Example |
|---|---|---|
Product card selector | CSS selector that identifies the product card element. It must contain a link to the product page. | .custom-product-card |
Badge container selector | CSS selector that identifies the element where the badge is inserted. If omitted, the badge is inserted directly into the product card element. | .custom-product-image-wrapper |
You can change the shared popup and toast text for each language. Blank fields use the default text. The settings apply to the whole store.
For the fields, default texts, setup steps, and notes such as character limits, see "Change the popup and toast texts".
These processes run after an order is created.
Configure post-order distribution and recovery of missed gifts separately. Both are disabled by default.
Field | Description |
|---|---|
Distribute gifts after the order | Adds the gift component products to orders from channels set to "After the order" under the campaign's "Distribution method by channel." |
Recover gifts missing from online store orders | Adds the component products when an online store order is missing a gift that should have been distributed automatically. |
Automatic addition after an order requires the following.
Gift: A free Simple gift or Repeatable gift.
Additional permissions: If the permissions are missing, select "Grant permissions."
Enable the global setting, then configure the applicable channels in the campaign.
(1) Enable and save post-order distribution
Enable "Distribute gifts after the order," then save the settings.
(2) Configure the campaign distribution methods
In the applicable campaign, go to "Gift" → "Distribution method by channel."
Online Store: Select "After the order (not added to cart; added after the order)."
Draft Orders, Point of Sale, and subscription apps: Select the applicable channel from "Add channel."
Other channels: Under "Other channel," enter a display name and identifier. Find the identifier in the "Post-order gift" block for an applicable order.
(3) Save the campaign settings
Confirm the channels and distribution methods, then select "Save."
Subscription apps: Orders recorded as subscription orders are handled together. The first order is usually treated as an online store order, but eligibility is evaluated using the channel actually recorded on the order.
If the entire order is fulfilled: The gift is not distributed.
Caution: If the global setting is disabled, configured post-order distribution also stops. You also cannot newly configure "After the order" or channels other than the online store.
Recovery applies to gifts that should have been distributed automatically on the online store.
Automatic distribution: Eligible for recovery.
Use settings page configuration: For a Simple gift, also enable "Automatically add gift to cart" under "Online store (Theme Extensions)."
Manual distribution: Not eligible for recovery.
Choice gifts and non-free gifts: They are not added automatically.
For eligible orders and setup steps, see Automatic recovery for missed gift distribution.
To check processing results, add the "Post-order gift" block to the order details in Shopify admin. Automated processing runs even if the block is not present.
If the issue remains after these checks, please contact us through the contact form.
When you contact us, please share the following information.
When the issue occurred
The settings page you had open
The checks you already completed