How can we help?
Search our help center or browse by category below.
All Help Articles
Features
How does the battery last 6+ months?
How does WiFi work on SWELLFRAME?
What does "always on" mean?
What forecast data does SWELLFRAME show?
• Wave height: swell size in feet or meters
• Swell period: interval between waves (longer = more power)
• Wind speed & direction: offshore, onshore, or cross-shore
• Tide data: current level plus high/low times
• Session rating: our at-a-glance quality score (stars or verbal)
• Best windows: the optimal times to surf today
• 7-day outlook: so you can plan your week
All of this is updated multiple times per day, automatically.
How is the display readable in all conditions?
Getting Started
How does SWELLFRAME work?
Does it need WiFi?
Does it need to stay plugged in?
What comes in the box?
What is the pairing token and where do I find it?
How to get your pairing token:
- Plug in your Swellframe and complete the WiFi setup.
- Once connected, the screen will show a QR code and a pairing token.
- Scan the QR code with your phone to go straight to account setup, or visit swellframe.co and enter the token manually.
How do I set up my SWELLFRAME?
Step 1: Plug it in
Connect the USB-C cable. The screen will show a boot splash with the SWELLFRAME logo and firmware version.
Step 2: Connect to WiFi
The screen changes to a setup slide that reads:
Let's get started.On your phone or computer, connect to the SWELLFRAME-Setup WiFi network. A setup page will open automatically (or browse to the device's IP). Pick your home WiFi network, enter the password, and save.
Find this Wi-Fi network on your phone or PC:
SWELLFRAME-Setup
Connect, then follow the on-screen steps.
Step 3: Pairing token appears
Once connected, the screen changes to the pairing slide. You will see a surf photo on the left and on the right:
Wi-Fi connected.Either scan the QR code with your phone camera (it takes you straight to signup) or go to swellframe.co and enter the token manually. The token is active for about 15 minutes.
Scan the QR code to get started, or visit swellframe.co and enter this pairing token to link the device to your account:
A1B2C3
Step 4: Create your account and claim
Follow the signup flow: enter your name and email, then pick your first surf spot. Once you complete signup, the device detects the claim automatically within seconds.
Step 5: Welcome screen
The display updates to a welcome message:
Amazing! You've added your Swellframe to your account. You can now set it to your favorite surf spot on our website.Step 6: Your first forecast
Welcome to the family. Enjoy the waves.
The device fetches your forecast and renders it on screen. From here on, it refreshes automatically every 3 hours. You can manage your slides, spots, and settings anytime at portal.swellframe.co.
Token expired? If you see "Your Claim Token Has Expired" on the screen, just press the reset button on the back. A fresh token will appear within seconds.
What is the SWELLFRAME portal?
• View and configure your slides (add, remove, reorder, change format)
• Pick surf spots for each slide
• Switch between star and verbal ratings
• Adjust your refresh interval and monitor battery life
• See your device status and last check-in
• Request new surf spots and contact support
Changes you make in the portal are pushed to your device on the next refresh.
Can I mount it on the wall?
Can I move it to a different WiFi network?
My screen says "Wi-Fi cleared." What does that mean?
What was preserved:
- Your account
- Your surf spots
- Your slide selections and layout
- On your phone or computer, connect to the SWELLFRAME-Setup WiFi network.
- A setup page will open automatically. Pick your WiFi network, enter the password, and save.
- Your Swellframe will reconnect and start showing your forecast again within seconds.
What does the reset button do?
Quick press
- Forces an instant refresh: the device wakes up, connects to WiFi, pulls your latest settings and forecast data, and updates the screen.
- Use this any time you change a slide or spot in the portal and want to see the result immediately instead of waiting for the next 3-hour cycle.
- Also generates a new pairing token if the device hasn't been claimed yet (or if the previous token expired).
- Enters WiFi setup mode: the device creates the SWELLFRAME-Setup hotspot so you can connect it to a new network.
- Your account, slides, and spot selections are saved in the cloud and stay intact.
- Triggers a factory reset: wipes WiFi credentials and account pairing, returning the device to its out-of-the-box state.
- Use this when transferring the device to a new owner. See "How do I factory reset my Swellframe?" in the Support section for details.
I changed my slide but the display didn't update right away. Is that normal?
The 3-hour cycle
- New forecast data is published every 3 hours.
- Your Swellframe wakes up on the same schedule, pulls fresh data, renders the display, and goes back to sleep.
- This is by design: it keeps battery life at 6+ months on a single charge.
- Press the reset button on the back of the device.
- This triggers an instant pull: the device wakes up, grabs your latest settings and forecast, and updates the screen within seconds.
- Any time you change a slide, switch a spot, or just want a fresh render, one press is all it takes.
- If you have more than one slide, the device rotates through them every ~30 seconds.
- To support this rotation the refresh interval drops to 5 minutes, but that does not mean new forecast data arrives every 5 minutes.
- Forecast data still updates every 3 hours. The shorter interval simply keeps the slide rotation running smoothly.
I ordered more than one Swellframe. How do I set them up?
Keeping both for yourself?
- Click Claim Swellframe #1 and create your account. Any included subscription lands here.
- Open the Swellframe #2 link and choose Log in and claim it to add it to the same account.
Gifting one?
Open that Swellframe's claim button and choose It's a gift, send it to them. We email the lucky recipient their own activation link, and they set it up under their own account. The included subscription stays with the Swellframe it is marked on, so gifting the second frame never gives away your subscription.
Your Forecast
How often does the forecast update?
If you have multiple slides, the refresh interval automatically shortens to 5 minutes so the device can rotate between them, but that does not mean new forecast data arrives more often. The underlying data still updates every 3 hours.
Want an immediate update? Press the reset button on the back of the device to trigger an instant pull.
Can I choose my surf spot?
Can I show different spots on different slides?
What if I want to change my surf spot later?
What slide types can I choose from?
2-Day Detail: Hourly breakdown for the next 2 days. Wave height, wind, tide, session ratings, sunrise/sunset, water temp, and a "Days to Watch" section flagging upcoming good sessions.
7-Day Outlook: A full week at a glance with morning and afternoon conditions for each day, plus the best 3 sessions ranked by quality.
Local Insights (AI Briefing): A personalized, editorial-style forecast written by our AI in natural surf language. Covers today, tomorrow, and the rest of the week with specific insights about conditions. Greets you by name.
You can add, remove, and reorder slides from the portal. Each slide can show a different spot and a different format.
What is Local Insights?
Today: what to expect right now, the best window to paddle out, and specific conditions (wave size, wind direction, tide timing).
Tomorrow: whether conditions are building, holding, or fading, and when to go.
Rest of the Week: the bigger picture trend so you can plan ahead.
It greets you by your first name and is written in real surf language, not generic weather copy. Every insight is specific to your spot and the actual forecast data.
How does the slide rotation work?
How does multi-slide mode affect battery life?
What does the 2-Day Detail slide show?
• Hourly wave height and swell period
• Wind speed and direction for each time block
• Tide times (high and low)
• Session quality ratings (stars or verbal)
• Sunrise and sunset times
• Water temperature and wetsuit recommendation
• "Days to Watch" section highlighting upcoming sessions worth planning for
It's designed to answer "should I surf today or tomorrow, and when?"
What does the 7-Day Outlook slide show?
Can I request a new surf spot?
What if my surf spot isn't listed?
Is AI forecasting included?
Every Swellframe ships with the forecast you need built in, free forever.
Local Insights, our AI written daily briefing, and multi-slide rotation are premium features, included with any of the three annual subscriptions.
- 1-Year Plus, $9.99 a year. One device, one sport, switch your sport once a year.
- 1-Year Pro, $19.99 a year. Up to two devices, two sports, locked for 12 months.
- 1-Year Unlimited, $29.99 a year. Unlimited devices, every sport, switch any time.
Every paid tier includes all premium features. The tiers differ in how many devices and sports you can run, not in what they unlock.
How Our Forecast Works
Where does Swellframe get its surf data?
Each spot's forecast is refreshed every three hours and cached so your device always has the latest conditions. Currently, 752 surf spots across 15 countries are active in the system, spanning the US East and West Coasts, Hawaii, the Caribbean, Western Europe, and Morocco.
How does Swellframe turn raw ocean data into wave heights?
1. Shelf Attenuation: wide continental shelves absorb swell energy through friction. New Jersey's 80-mile shelf eats about 25% of incoming swell before it reaches shore, while Hawaii has no shelf so swells arrive at full power.
2. Period Shoaling: long-period swells break bigger than short-period swells at the same height. A 14-second groundswell produces roughly 14% taller breaking waves than a 10-second swell.
3. Break Amplification: reef breaks amplify waves more than beach breaks because the seafloor rises abruptly, causing waves to jack up.
4. Spot Calibration: a fine-tuning factor for each spot to match what surfers actually see in the water.
The result: Display Height = Raw Swell x Shelf x Shoaling x Break Amp x Spot Cal
Why does the same buoy reading show different heights at different spots?
Continental shelf width is the biggest variable. A 5 ft reading on an offshore buoy loses about 25% crossing New Jersey's wide shelf (showing as 3-4 ft at the beach), but arrives nearly intact in Hawaii (showing as 4-5 ft).
Break type matters too. A reef break amplifies incoming swell more than a beach break because waves shoal abruptly over shallow reef. The same raw swell produces taller waves at Pipeline (reef) than at a gentle sandy beach.
Swell period affects how much waves grow as they approach shore. A 14-second groundswell breaks bigger than a 7-second windswell at the same height.
This is why Swellframe applies spot-specific corrections rather than just showing the raw buoy number.
Why does a long-period swell produce bigger waves than a short-period swell at the same height?
A long-period swell (14+ seconds) was generated by a distant storm thousands of miles away. These waves travel deep beneath the surface, interact with the seafloor earlier, and undergo more shoaling amplification as they approach the coast. The result: they break taller, more powerfully, and more organized than the raw height suggests.
A short-period swell (under 8 seconds) was generated by local wind. These waves are steep, choppy, and carry less energy per wave. They don't grow much as they approach shore.
In practice, a 3 ft swell at 16 seconds can produce breaking waves nearly as tall as a 4 ft swell at 8 seconds, but with significantly more power behind each wave. That's why experienced surfers get excited about period, not just height.
How do the star ratings work?
Wave Energy (biggest factor): computed from wave height and period. Bigger waves with longer periods score higher.
Swell Period: bonus points for long-period groundswell, which produces better-shaped waves.
Swell Direction: how well the swell direction matches the spot's ideal angle.
Tide: whether the tide stage favors the break (most spots prefer low tide).
Wind: offshore wind boosts the score; onshore wind caps or reduces it.
| Stars | Label | What it means |
|---|---|---|
| 1 | Sucks | Not worth paddling out |
| 2 | Rideable | Marginal conditions |
| 3 | Fun | Good session, worth the paddle |
| 4 | Pumping | Great conditions |
| 5 | Legendary | Best it gets |
How does Local Insights explain conditions?
Energy labels (soft, moderate, punchy, powerful, heavy) that capture both wave size and period in a single word.
Swell character descriptions like "short-period windswell" or "long-period groundswell" that explain where the swell came from.
The AI uses these to write copy that helps beginners understand what the conditions actually mean. Instead of just "3-4 ft @ 14s," a beginner reads something like: "A punchy long-period groundswell fills in this morning with clean offshore conditions. Best window is 6-8am before the wind shifts."
Three briefings are generated per day (morning, afternoon, evening), each tailored to the time of day and what's ahead.
How accurate is Swellframe?
This achieves roughly 80% of the accuracy of premium bathymetric models at a fraction of the complexity. Our scoring engine also considers more variables (tide conditions, precise swell direction matching, wind direction classification) than most other services' automated rating systems.
We periodically validate our forecasts against other major surf forecast services and refine our regional calibration factors based on those comparisons. If you notice a consistent mismatch at your local spot, let us know: that feedback helps us tune the model.
Virtual SWELLFRAME
What is a Virtual SWELLFRAME?
How do I claim my SWELLFRAME?
What if I lost my claim email?
Do I need the physical device before creating an account?
What happens when my physical SWELLFRAME arrives?
- Connect to the SWELLFRAME-Setup WiFi network on your phone and enter your home WiFi password.
- The device connects and displays a pairing token and QR code on screen.
- Scan the QR code (or enter the token at swellframe.co) and log in to your existing account.
Will I lose my settings when I connect the physical device?
Why do support records show my order number instead of a device ID?
I already created my account before the device shipped. Is that okay?
Rating Systems
What are SWELLFRAME's two rating modes?
Stars: a quick visual scale from ★ (worst) to ★★★★★ (best).
Verbal: plain-language labels: Sucks · Rideable · Fun · Pumping · Legendary.
Both modes show the exact same underlying rating. They're just different ways to display it. You can switch anytime in the portal below the slide preview.
How do the star and verbal ratings line up?
| Stars | Verbal | What it means |
|---|---|---|
| ★ | Sucks | Not worth paddling out. Small, wind-blown, or generally poor. |
| ★★ | Rideable | You can get waves, but don't cancel plans for it. |
| ★★★ | Fun | Solid session. Decent swell with manageable wind. Go surf. |
| ★★★★ | Pumping | Really good. Clean conditions, solid swell, offshore or light winds. |
| ★★★★★ | Legendary | Best of the best. Epic swell, perfect wind, long period. Don't miss it. |
| ★★★★★ | Pro Only | Extremely large or powerful surf. Experienced surfers only. |
How does SWELLFRAME actually calculate its ratings?
What does "Pro Only" mean?
Can I switch between star and verbal ratings?
Orders & Shipping
Can I cancel or refund a subscription?
A subscription bought together with your Swellframe (for example 1 year of Pro on your order) is prepaid for its full term. It cannot be refunded, and there is nothing to cancel: it never renews on its own, it simply runs out at the end of its 12 months.
A subscription you pay for yearly can be canceled anytime from Subscription options in your account menu (Manage or cancel subscription). Canceling stops the renewal: you keep your plan until the end of the period you already paid for, and no further charges happen. Past charges are not refunded.
Switching between plans is always possible from the same place, with fair credit for what you already paid.
What is the return policy?
Is my SWELLFRAME under warranty?
Yes. Every new Swellframe includes a one-year limited hardware warranty covering defects in materials and workmanship under normal use. Coverage starts the day your device is delivered.
If a new device will not power on or will not connect to Wi-Fi during first setup, tell us within 30 days of delivery and we will replace it, shipping covered both ways.
The warranty does not cover drops, liquid or sand damage, misuse, unauthorized repairs, cosmetic wear, or normal battery capacity loss over time. To start a claim, email [email protected] with your order number and a short description of the problem.
When will SWELLFRAME ship?
Can I use SWELLFRAME without a subscription?
Yes. Every Swellframe comes with the forecast you need, and that is yours forever with nothing to pay.
The subscriptions are for ocean and mountain folks who want to go deeper: richer visual slides, more spots to follow, and more than one sport on the same frame.
- 1-Year Plus, $9.99 a year. One device, one sport, switch your sport once a year.
- 1-Year Pro, $19.99 a year. Up to two devices, two sports, locked for 12 months.
- 1-Year Unlimited, $29.99 a year. Unlimited devices, every sport, switch any time.
Every paid tier includes all premium features. The tiers differ in how many devices and sports you can run, not in what they unlock.
Will there ever be a monthly fee for the basic forecast?
No. The forecast you check every morning is included with every Swellframe purchase and stays yours forever. No monthly fee, no annual renewal, no paywall creeping over it later.
The optional subscriptions are billed annually, never monthly, and only add extras on top.
- 1-Year Plus, $9.99 a year. One device, one sport, switch your sport once a year.
- 1-Year Pro, $19.99 a year. Up to two devices, two sports, locked for 12 months.
- 1-Year Unlimited, $29.99 a year. Unlimited devices, every sport, switch any time.
Every paid tier includes all premium features. The tiers differ in how many devices and sports you can run, not in what they unlock.
Why are the subscriptions paid?
We want to be transparent about this. The premium features carry real ongoing costs on our end.
Local Insights generates a personalised AI briefing for your spot every single day, which means running AI models against your forecast data daily. Multiple slides make your frame refresh far more often so it can rotate between them, which is many times more server requests per device.
The subscriptions are billed annually so we can keep delivering those sustainably without ever resorting to ads, selling data, or putting the core forecast behind a paywall. The base forecast is free forever. The paid tiers exist so people who want more can get more, and the cost stays honest.
Sustainability
What makes SWELLFRAME sustainable?
• Ultra-low power: a full year of operation uses less energy than charging your phone for a single day
• No planned obsolescence: firmware updates are free forever, and the hardware is built to last years
• Minimal packaging: recycled and recyclable materials throughout
We believe surf products should protect the ocean, not pollute it.
How much energy does SWELLFRAME use?
Is SWELLFRAME designed to last?
What about the packaging?
What is the Round Up for the Ocean?
Are there ads on SWELLFRAME?
Our slogan is Know when to paddle out. Everything you need, nothing you don't. We mean that literally. Ads are something you don't need, so we don't have them now and we never will.
There are no ads on any tier of SWELLFRAME, free or paid. Your forecast display will never show sponsored content, banners, pop-ups, or promotions of any kind. Not today, not ten years from now.
Swellframe is funded by hardware sales and subscriptions. We will never monetize your attention or sell your data. That's not a marketing line. That's the deal.
Community
Who created SWELLFRAME?
Where is SWELLFRAME made?
How can I help grow the SWELLFRAME community?
How does SWELLFRAME give back to the ocean?
• Round Up for the Ocean: buyers can round up to the next whole dollar at checkout. We match every dollar, sending double to the Surfrider Foundation per round-up.
• Referral donations: when you refer a friend, you can donate your share of the reward to Surfrider instead of keeping it as store credit.
Surfrider is a nonprofit dedicated to the protection and enjoyment of the world's ocean, waves, and beaches. Every dollar we send goes directly to their mission.
Can I submit a surf spot?
Is SWELLFRAME built by a big tech company?
Support
How do I contact support?
My SWELLFRAME isn't updating. What should I check?
- Press the reset button on the back of the device. This forces an immediate refresh and is the quickest fix.
- Check your WiFi: make sure other devices on the same network can connect to the internet.
- Verify power: confirm your Swellframe is plugged in or has battery remaining.
- Check the portal: log in to portal.swellframe.co and look at the last check-in time under your device status.
- Move closer to the router temporarily if the signal might be weak.
Does SWELLFRAME get firmware updates?
Is my data private?
Is SWELLFRAME available in other languages?
How do I transfer my Swellframe to someone else?
- Remove the device from your account. Log in to portal.swellframe.co, find the device, and click the remove (trash) icon. This unpairs it from your account.
- Factory reset the device. Hold the reset button on the back for 15 seconds or longer, then release. The screen will show "Factory Reset / Restarting..." and the device will reboot into a fresh state.
How do I factory reset my Swellframe?
A factory reset:
- Wipes the saved WiFi credentials and account pairing.
- Preserves the hardware device ID (this is permanent and never changes).
- Returns the device to its out-of-the-box state, ready for a fresh setup.
| Hold duration | Action |
|---|---|
| Quick press (under 5s) | Instant refresh |
| 5 to 15 seconds | WiFi setup mode |
| 15 seconds or longer | Factory reset |