Docs
Last updated: April 2026
1. Getting started
Create an account
Go to relens.xyz and click Get Started. Sign in with your Google account — this creates your Relens account and lets you connect data sources. No card required at sign-up.
New accounts come with a free trial of 3 questions so you can try Relens before subscribing.
Connect Google Analytics 4
Google Analytics is connected via a separate OAuth step that grants analytics read access:
- →From the landing page or the /connections page, click Connect Google Analytics
- →You'll be redirected to Google's OAuth consent screen — approve the analytics.readonly permission
- →After approving, you'll be taken to the property picker to select which GA4 property Relens should query
- →Select your property and click Start Asking Questions — you'll land in the chat
Note: If your Google account has access to multiple GA4 properties, you can pick any one. You can switch properties later from the connections page.
Connect Shopify
Shopify is connected from the /connections page:
- →Go to /connections and click Connect Shopify
- →Enter your Shopify store domain (e.g. my-store.myshopify.com)
- →You'll be redirected to Shopify's OAuth consent screen — approve the read permissions
- →After approving, you'll be returned to /connections with Shopify shown as connected
Note: Relens requests only read-only permissions. It cannot place orders, modify products, or access card data.
Connect Support Email (IMAP)
Your support inbox is connected from the /connections page using IMAP credentials:
- →Go to /connections and find the Support Email card
- →Enter your email address — Relens will auto-fill the IMAP host and port for Gmail, Outlook, and Yahoo
- →Enter your password (or App Password — required for Gmail, Outlook, and Yahoo when 2-step verification is on)
- →Click Connect Email → — Relens tests the connection and lists your mailboxes
- →Choose which folder contains your support emails (usually INBOX) and click Use
Note: Relens accesses your inbox in read-only mode — it reads email metadata (sender, subject, date) and short snippets only. It cannot send emails, delete messages, or modify your inbox in any way. Your credentials are encrypted with AES-256-GCM before being stored.
Connect Omnisend
Omnisend is connected from the /connections page using an API key:
- →In Omnisend, go to Account → Integrations → API keys and create a new key
- →Copy the key and paste it into the Omnisend card on the /connections page
- →Click Connect — Relens will verify the key and display your store name
What Relens can access: Campaign performance, revenue attribution, contact growth trends, and top-performing campaigns. All access is read-only.
Connect Klaviyo
Klaviyo is connected from the /connections page using a private API key:
- →In Klaviyo, go to Account → Settings → API keys and create a Private API key with read-only access
- →Copy the key and paste it into the Klaviyo card on the /connections page
- →Click Connect — Relens will verify the key and display your account name
What Relens can access: Campaigns, flows, lists, and campaign performance metrics. All access is read-only.
You only need one source
All five sources are optional individually — you only need at least one connected to start chatting. When multiple sources are connected, Relens can answer cross-source questions that combine data from all of them in a single conversation.
2. Asking questions
Once a source is connected, just type your question in the chat box. Relens figures out which data to fetch, queries your connected sources, and streams back a clear answer. No SQL, no dashboards, no metric hunting.
Google Analytics questions
Things you can ask:
- →Why did traffic drop last week?
- →Which pages have the highest drop-off rate?
- →Show me top traffic sources this month
- →Are there any anomalies I should know about?
- →How did mobile vs desktop perform over the last 30 days?
- →Which country drives the most conversions?
- →What's my bounce rate on the pricing page?
- →How many new users did we get yesterday?
Shopify questions
Things you can ask:
- →What was my revenue this month?
- →Which products are selling best?
- →How many new customers did I get last week?
- →Show me daily revenue for the past 30 days
- →What's my average order value?
- →Which customers have spent the most this year?
- →How many orders were cancelled last month?
- →What are my product costs and estimated margins?
Support email questions
Things you can ask:
- →How many support emails did we receive this week?
- →Show me unanswered emails from the last 7 days
- →Who are my top senders this month?
- →What's our average response time?
- →Show me emails received in the last 3 days
- →How many threads are still unanswered?
Omnisend questions
Things you can ask:
- →How did my last email campaign perform?
- →Which campaign drove the most revenue this month?
- →Show me my contact growth over the last 90 days
- →What's my average open rate across recent campaigns?
- →Which campaigns had the highest click-through rate?
Klaviyo questions
Things you can ask:
- →How are my active flows performing?
- →Which campaign had the highest revenue last month?
- →Show me my list sizes and growth
- →What's the open rate on my welcome series?
- →Compare my last 3 campaign stats
Cross-source questions
When multiple sources are connected, you can ask questions that span them:
- →Did the traffic spike last Tuesday lead to more orders?
- →Which traffic channel drives the most revenue?
- →Did the order volume drop this week coincide with a rise in support emails?
- →How does my email marketing revenue compare to my total Shopify revenue?
- →Which Klaviyo campaign brought the most new GA sessions?
- →Compare organic search visitors to my top-spending customers
Tips for better answers
- →Be specific with date ranges — "last 7 days" or "this month" work well
- →Ask follow-up questions in the same conversation — Relens remembers the context
- →If an answer seems off, try rephrasing or adding more detail
- →You can ask for comparisons — "vs last month" or "vs the same period last year"
- →Ask for a chart or graph if you want data visualised inline
3. File attachments
You can attach files directly to your messages. Relens will read the content and incorporate it into the conversation — useful for sharing a data export, a spreadsheet, or a report you want analysed.
Supported file types
- →Spreadsheets — .xlsx and .csv files (Relens parses the data automatically)
- →PDFs — Relens extracts text content from the document
- →Plain text — .txt files
- →Images — screenshots, charts, or any image you want Relens to interpret
How to attach a file
- →Click the paperclip icon in the chat input, or drag and drop a file onto the chat
- →The file appears as a preview above the message box
- →Type your question and send — Relens will read the file as part of your message
- →You can attach multiple files to a single message
Privacy: Attached file content is sent to the AI model to answer your question and is not stored on Relens servers.
4. Charts & reports
Inline charts
Relens can generate charts directly inside the chat. Ask for a visualisation and it will render an interactive chart alongside the text answer — no need to export to a spreadsheet.
Examples:
- →"Show me a chart of daily revenue for the last 30 days"
- →"Graph my session count by traffic source this month"
- →"Plot contact growth over the last 90 days"
PDF reports
You can download any answer as a formatted PDF report. After Relens responds, click the Download PDF button that appears below the message. The PDF includes the question, the full answer, and any data tables — ready to share with your team or save for your records.
Saved reports
You can save any conversation for later. Click Save report in the chat to store the current conversation. Saved reports are accessible from the /saved-reports page, where you can browse, rename, and delete them.
Reports are stored securely and are private to your account.
5. Understanding credits
Free trial
Every new account starts with 3 free questions — no card required. This lets you connect your data and try Relens before committing to a subscription.
Pro subscription
After your free trial, a Pro subscription gives you 200 questions per month. Credits reset on the 1st of each calendar month regardless of when you subscribed.
Pro is available at $20/month or $200/year (≈ $16.67/mo). See pricing for details.
Tracking your usage
When you're signed in, the credit counter in the top-right of the chat shows how many questions you have left this month (e.g. 187 / 200 left). It updates after each question.
When you run out
If you hit your credit limit, Relens will prompt you to upgrade (free trial) or wait until the 1st of next month (Pro subscribers). Your chat history, saved reports, and connections are preserved — only new questions are paused.
6. Managing connections
All your data source connections are managed from the /connections page. You can reach it via the Sources link in the chat header.
Switching your GA4 property
If you have access to multiple GA4 properties and want to switch which one Relens queries, click Switch property on the GA connection card. You'll be taken to the property picker where you can select a different one.
Disconnecting Shopify
Click Disconnect on the Shopify card in /connections. This removes Relens's access token. To reconnect later, click Connect Shopify again and go through the OAuth flow.
Revoking Google Analytics access
To fully revoke GA access from Google's side, visit myaccount.google.com/permissions and remove Relens. You can reconnect at any time via /connections.
Revoking Shopify access
To revoke from Shopify's side, go to your Shopify admin, navigate to Apps, and uninstall Relens.
Disconnecting Support Email
Click Disconnect on the Support Email card in /connections. This immediately removes your stored IMAP credentials — Relens will no longer have any access to your inbox. To reconnect, enter your credentials again.
Disconnecting Omnisend or Klaviyo
Click Disconnect on the relevant card in /connections. This removes your stored API key. To reconnect, paste in a valid key again. You can also revoke the key directly in Omnisend or Klaviyo settings at any time.
7. Company context
Company context is a short description of your business that Relens includes in every conversation. It helps the AI give more relevant, specific answers rather than generic analysis.
When you first connect a data source, Relens automatically generates a 2–3 sentence context by looking at your top pages, traffic channels, and (if Shopify is connected) recent revenue and top products. For example:
"An e-commerce store selling home fitness equipment. Traffic is driven primarily by organic search and paid social. Top products include resistance bands and adjustable dumbbells."
You can edit this text at any time on the /connections page. If the auto-generated version isn't accurate, just overwrite it with a description that fits your business. Changes take effect on your next question.
8. FAQ
Is my analytics or store data stored on your servers?
GA4, Shopify, Omnisend, and Klaviyo data is not stored — it is queried live when you ask a question and discarded after the answer is generated. For Support Email, your IMAP credentials (email and password) are stored encrypted with AES-256-GCM so Relens can connect to your inbox on each request. Email content itself (subjects, snippets) is not stored. Saved reports store only the conversation text you explicitly choose to save.
Can Relens modify my Google Analytics data?
No. We use the analytics.readonly OAuth scope, which is strictly read-only. Relens cannot create, edit, or delete any data in your GA4 account.
Can Relens modify my Shopify store?
No. We request only read permissions. Relens cannot place orders, change prices, edit products, or access payment card data.
Which GA4 metrics and dimensions does Relens support?
Metrics: sessions, activeUsers, newUsers, bounceRate, averageSessionDuration, conversions, screenPageViews, eventsPerSession. Dimensions: date, sessionSource, sessionMedium, sessionCampaignName, pagePath, country, deviceCategory, sessionDefaultChannelGroup, eventName.
Which Shopify data can Relens access?
Orders (revenue, count, AOV, status), daily revenue trends, top products by revenue and units sold, customer data (top spenders, new customers, order frequency), product costs for margin estimates, and the active product catalogue.
Which Omnisend data can Relens access?
Campaign list and performance stats (sends, opens, clicks, revenue), contact growth over time, revenue attribution per campaign, and top-performing campaigns by revenue or engagement. All access is read-only.
Which Klaviyo data can Relens access?
Campaigns (name, status, send time, subject line), per-campaign performance metrics (opens, clicks, revenue), flows (name, status, trigger type), and list sizes. All access is read-only using a private API key.
Can Relens read my full email content?
No. Relens reads email metadata (sender name and address, subject line, date) and a short plain-text snippet of up to 150 characters from the start of the email body. It does not read full email bodies, attachments, or HTML content. Access is strictly read-only — Relens cannot send, delete, or modify emails.
How are my email credentials stored?
Your IMAP password is encrypted with AES-256-GCM before being stored. The encryption key is never stored alongside the credentials. Credentials are deleted immediately when you disconnect the email source or delete your account.
Are Omnisend and Klaviyo API keys stored securely?
API keys are stored in your account's server-side metadata, which is only accessible server-side and never exposed in the browser or JWT. Relens does not log API keys.
What file types can I attach to a message?
You can attach Excel spreadsheets (.xlsx), CSV files, PDFs, plain text files (.txt), and images (PNG, JPG, etc.). Relens parses the content and uses it as context for your question.
How do I save a report?
After getting an answer in the chat, click Save report. Saved conversations appear on the /saved-reports page where you can rename or delete them. Reports are private to your account.
How do I download a PDF?
Click the Download PDF button that appears below any AI response. The PDF includes the question, the full answer, and any data tables in a clean, shareable format.
How do I cancel my subscription?
Go to the Billing page (linked in the chat header) and click Manage subscription. You'll be taken to the Stripe billing portal where you can cancel anytime. Access continues until the end of your current billing period.
I ran out of questions mid-month — what happens?
New questions are paused until your credits reset on the 1st of the next month. Your chat history, saved reports, connections, and company context are all preserved. You can also upgrade to Pro (if on a free trial) to get access immediately.
Can I connect multiple GA4 properties?
Relens supports one active GA4 property at a time. You can switch which property is selected from the /connections page at any time.
How do I delete my account?
Email us at privacy@relens.xyz and we'll delete your account and all associated data within 30 days.