Skip to main content
The Main Account template creates the customer account dashboard page where logged-in customers can view their order history, manage account details, and access account-specific features. This primary landing page after login serves as the central hub for customer self-service, rendering order history, customer information, and account navigation automatically. Use this template to provide customers with easy access to their purchase history and account management tools, reducing support inquiries and improving customer satisfaction.

Template Purpose

The account dashboard serves as the central hub for customer self-service:

Order History

Displays past orders with clickable links to view order details

Account Details

Shows customer name, email, and default address information

Address Management

Provides quick access to address book management page

Account Actions

Links to view/edit addresses and logout functionality

Template Settings

The Main Account template provides minimal customization, focusing on section-level styling:
  • Page Width (default) - Contained within page margins
  • Fluid Width - Extends to container edges
Full width is not available for account pages to maintain comfortable reading width for text-heavy content.
  • Select from available theme color schemes
  • Default: scheme-1
Use a consistent color scheme across all account templates (account, addresses, order, login, register) for cohesive user experience.
  • Top Spacing: 0, 1, 2 (default), 4, or 6
  • Bottom Spacing: 0, 1, 2 (default), 4, or 6
  • None (default)
  • Top Border
  • Bottom Border
  • Both Borders

Account Dashboard Content

While the template itself has limited settings, the account-dashboard snippet automatically displays:

Order History Section

  • Displays all customer orders from newest to oldest
  • Each order shows: order number, date, payment status, fulfillment status, total
  • Click any order to view full order details
  • Automatically handles pagination for customers with many orders
Visual indicators for order states:
  • Paid/Unpaid - Payment status
  • Fulfilled/Unfulfilled/Partially Fulfilled - Shipping status
  • Canceled - Canceled orders
  • Refunded - Fully or partially refunded orders
When customer has no orders:
  • Displays friendly message
  • Suggests browsing collections or continuing shopping
  • Provides CTA button to product pages

Account Information Section

  • Customer name
  • Email address
  • Account creation date (if theme displays it)
  • Default billing/shipping address
  • Link to “View addresses” page
  • Quick access to manage address book
  • View Addresses - Navigate to address management
  • Logout - Sign out of customer account

Customer Access Requirements

The Main Account template is only accessible to logged-in customers. Visitors who are not logged in will be redirected to the login page.
Customer Login States:
Customer StateAccessResult
Logged InGrantedViews account dashboard
Not Logged InDeniedRedirected to /account/login
Guest CheckoutDeniedRedirected to login (no account exists)

Best practices

Design consistency

Use the same color scheme across all account templates and match spacing values on account, addresses, order, login, and register templates. Maintain consistent header and footer across account pages and ensure navigation breadcrumbs or back links are available.

User experience

Keep account pages simple and scannable with clearly labeled order history. Make “View Order” links obvious and clickable, provide clear logout button placement, and display empty state messages encouragingly rather than critically.

Mobile optimization

Test account dashboard on mobile devices to ensure order tables are readable on small screens. Verify CTA buttons have adequate touch targets and check that long order numbers don’t break layout.

Performance

Account dashboard loads customer-specific data dynamically, and Shopify handles pagination automatically for customers with 100+ orders. Keep additional sections minimal and avoid heavy media to maintain fast load times.

Extending the Account Dashboard

While the core template is simple, you can enhance the account experience:

Welcome Message

Add a Rich Text section above with personalized greeting using liquid: “Welcome back, {{ customer.first_name }}!”

Account Benefits

Include Trust Indicators section highlighting loyalty program benefits or member perks

Recommended Products

Add Product Recommendations section below showing personalized suggestions based on order history

Help Resources

Include FAQ Tile or Accordions section with common account questions
Add sections to the account template in the Theme Customizer (Online Store → Themes → Customize → Customers → Account). Sections appear above or below the main account dashboard.

Main Addresses

Address book management page where customers add, edit, and delete shipping addresses

Main Order

Individual order details page showing line items, shipping, and tracking information

Main Login

Customer login form where users authenticate to access account dashboard

Main Register

New account creation form for first-time customers

Common Customizations

Adding a Welcome Section

Edit the account template to add a personalized welcome message:
  1. Navigate to Online Store → Themes → Customize
  2. Select Customers → Account from template dropdown
  3. Click Add section above Main Account
  4. Add Rich Text section
  5. Use liquid to personalize: Welcome back, {{ customer.first_name }}!

Displaying Loyalty Points

If using a loyalty app, many apps provide account page blocks:
  1. Check if your loyalty app offers a section or block
  2. Add it to the account template
  3. Position above or below the main account dashboard

Custom CSS for Order Table

For advanced styling, theme developers can target the account dashboard CSS classes in theme files.
Direct theme file editing requires development knowledge. Test changes on a duplicate theme before publishing.

Troubleshooting

Possible Causes:
  • Customer not logged in
  • Customer account disabled
  • Customer trying to access with wrong email
Solutions:
  1. Verify customer is logged in (check for customer object in theme)
  2. Admin: Check Customers page to verify account is active
  3. Reset password if authentication issues
Possible Causes:
  • Orders placed as guest (no account at time of purchase)
  • Customer logged into wrong account
  • Recent order not yet synced
Note: Only orders placed while logged in OR orders later associated with the account will appear. Guest checkout orders don’t automatically link to accounts created afterward.
Check:
  • Section width setting (ensure not conflicting with theme container)
  • Color scheme contrast (text readable on background?)
  • Browser cache (hard refresh: Cmd/Ctrl + Shift + R)
  • Theme updates (verify theme is updated to latest version)

Quick Summary

  • Purpose: Customer account dashboard landing page
  • Access: Logged-in customers only
  • Core Content: Order history, account details, address management links
  • Configuration: Minimal (section width, color scheme, spacing, borders)
  • Content Source: Automatic from Shopify customer object via account-dashboard snippet
  • Customization: Add sections above/below for enhanced experience
  • Related Pages: Addresses, Order, Login, Register templates
The account dashboard is automatically generated from customer data. No manual content entry needed - Shopify handles all order and account information display.