Support Center

🏠 Dashboard

The central hub for your app's performance.

• 📊 Subscription Plan → Shows your current plan (e.g., Gold Plan).
• 💰 Donations Summary:
  • This Month’s Donations
  • Lifetime Donations
• 🆘 Support Section → Quick access to contact information and help.
• 📈 Graph: Donation Over Time → A monthly breakdown of donations.

📦 Manage Products

This section helps you manage all donation-related products.

• 📝 Manage donation-related products.
• 🔍 Features:
  • Search products
  • Filter products
  • View product status (Active/Inactive)
  • Last updated timestamp
• ⚡ Actions: Create, Edit, Delete products.

💳 Change Plan

• 🔄 Upgrade or downgrade between available plans:
  • 🆓 Free Plan – Basic donation setup.
  • 🥉 Bronze Plan – More transactions.
  • 🥈 Silver Plan – Popular mid-tier.
  • 🥇 Gold Plan – Premium tier with the highest limits.
• 📌 Each plan shows:
  • Included Donation Transactions
  • Transaction fee above limit
• ✅ Current plan highlighted.

⚙️ Settings

• 🛠 Configure app preferences.
• ✏️ Update app details & customization options.

📊 Reports

• 📑 Generate and view detailed donation reports.
• 🔎 Analyze donation trends & performance.

❓ Help

• 📘 Access guides & support resources.
• 📬 Contact support team for troubleshooting.

General Settings

• Auto Fulfill Orders: Toggle ON/OFF to automatically mark donation orders as fulfilled.
  • Enable: For digital donations (no shipping needed)
  • Disable: For physical items requiring manual fulfillment
  
• Sales Tax: Toggle ON/OFF to apply sales tax to donation products.

• Shipping Requirements: Toggle ON/OFF to require a shipping address for donations.
  • Enable: Only if sending physical thank-you items
  • Disable: Recommended for most donations

• Email Notifications: Toggle ON/OFF to send receipt emails to donors.
  • Recommended: Keep enabled for better donor experience

Order Tagging (Gold Plan Only)

Purpose: Automatically tag orders containing donations.

• How to use: Enter a tag value (e.g., "donation", "charitable"). Orders with donations get tagged automatically for easy filtering in Shopify admin.
• Free/Bronze Plans: This feature is unavailable. Upgrade to Gold to enable.

Email Configuration

• From Email: Enter a professional sender email (e.g., donations@yourstore.com).
  • Must be valid email format
• CC Email (Optional): Add multiple emails separated by commas.
  • Useful for admin notifications and record-keeping
  • No duplicates allowed

Email Template

• Subject Line: Set a professional subject (e.g., "Thank you for your donation").
• Template Editor: Customize the receipt email using the text editor.
• Dynamic Variables:
  • {{donor_name}}: Customer name
  • {{date}}: Donation date
  • {{total}}: Donation amount
• Example:

  Dear {{donor_name}},
  Thank you for your donation of {{total}} on {{date}}.
  Best regards,
  [Your Organization]

Saving Changes

• Make changes to any settings. The "Save Settings" button becomes active when changes are detected.
• Click "Save Settings" to apply all changes.
• Validation: Fix any email format errors before saving.
• Button states:
  • Gray (Disabled): No changes
  • Blue (Enabled): Ready to save
  • Loading: Saving in progress

Quick Troubleshooting

• Email errors: Check format (e.g., user@domain.com), remove spaces, and avoid duplicates.
• Not saving: Fix validation errors and check your internet connection.
• No receipt emails: Enable notifications toggle and verify the "From" email.

📋 Overview

The Round-Up Donation feature automatically calculates the difference between a customer's cart total and the next whole amount, allowing them to donate that difference (or more) to a cause of their choice.

• Plan Requirement: Available for Silver and Gold plan subscribers only
• Automatic Calculation: Round-up amount updates in real-time as cart changes
• Multiple Causes: Customers can choose from your configured charitable causes
• Adjustable Amounts: Customers can increase donation beyond the calculated round-up

✅ Prerequisites

• Plan: Silver Plan or Gold Plan

🚀 Installation & Setup

Step 1: Navigate to Theme Editor

Go to Shopify Admin → Online Store → Themes → Click "Customize" on your active theme.

Step 2: Navigate to Cart Page

From the top dropdown, select the "Cart" page template.

Step 3: Add Round-Up Block

Click "Add section" or "Add block" (depending on your theme), then select "Round-Up Donation" under the Apps section.

Step 4: Position the Widget

Round-Up Donation block to position it above the cart total or checkout button area for maximum visibility.

⚙️ Configuration Settings

Customize every aspect of the Round-Up Donation widget to match your store's branding and design language.

1. General & Layout Settings

Set up the core behavior, text, and layout options for the widget.

• Enable Round-Up Donation: Toggle to allow customers to round up their purchases to the nearest dollar.
• Layout Style: Choose the layout style of the widget (e.g., Compact (Narrow)).
• Widget Placement: Control where the widget is placed on the cart page (e.g., Place after cart items line).
• Round-Up Title: The header title displayed at the top of the widget (Default: "Every little bit helps!").
• Round-Up Description: The helper text shown below the title to encourage donations.
• Donation Causes: Specify list of charitable causes (one per line) for the dropdown selection.

2. Alignment, Style & Premium Typography

Control widget positioning, corner shapes, and custom font styles.

• Widget Alignment: Align the widget to the Left, Center, or Right (only applies if placement is not set to follow the cart items line).
• Corner & Button Style: Choose the border/corner curvature style (e.g., Rounded (Pills & Curves)).
• Premium Typography: Toggle Use Custom Typography to override your theme's default fonts. (Note: The selected font family and sizes will only be applied to the widget when this toggle is enabled).
  • Select Font Family: Choose any typography from Shopify's extensive library of fonts.
  • Title Font Size: Control title size (in pixels) via slider or input field.
  • Description Font Size: Control description text size (in pixels).

3. Colors, Background & Inputs

Customize the color scheme of the card background, borders, text elements, and input fields.

• Background Color: Set the solid background color of the widget.
• Enable Gradient Background: Enable gradient effects using a custom start and end color.
• Border Color & Radius: Configure widget border lines and adjust corner radius (in pixels).
• Text Colors: Separately set the colors for Title, Description & Text, and Field Labels.
• Dropdown & Inputs: Customize the background, text, and border colors of the cause dropdown and amount fields.

4. Buttons Customization

Apply custom styles to the Add to Cart and amount adjustment (+/-) buttons.

• Button Background Color & Hover Color: Set the main and hover background color for the primary donation action button.
• Button Text Color & Border Radius: Style the button label text and configure its border corner radius.
• Amount Adjust Buttons: Separately customize the background and text color of the adjustment plus/minus buttons.

🔍 How It Works

Calculation Logic

👥 Customer Experience

Step-by-Step Process

1. View Cart: Customer navigates to cart page with items
   
2. See Round-Up Widget: Widget displays with calculated round-up amount
   • Title and description
   • New cart total preview
   • Cause selection dropdown
   • Amount adjustment controls
   
3. Select Cause: Customer chooses a charitable cause from dropdown
   
4. Adjust Amount (Optional): Customer can increase donation using + button
   
5. Add to Cart: Click "Add to Cart" button to add donation
6. Proceed to Checkout: Donation appears as line item in cart
   

🏪 Admin Dashboard & Reports

Viewing Round-Up Donations in Report Page

Round-up donations appear as regular line items in your Shopify orders with the following details:

• Product Name: "Round-Up Donation"
• Amount: Displays the donation amount
• Order ID: Clickable link to Shopify order
• Donation Name: Shows "Round-Up Donation"
• Date: When donation was made