--- title: Ask Graphit description: Explore metrics, draft dashboards and reports, and find controls with an assistant that understands the page you are viewing. --- # Ask Graphit The assistant helps you understand your metrics and move from a question to a useful next step. It can read data available to your role, compare periods, prepare drafts for review, and help you find controls in Graphit. Open **Ask Graphit** in the navigation, select the assistant button in the top bar, or press **⌘J** on Mac / **Ctrl+J** on Windows. On a phone, open **More** to find Ask Graphit. The assistant must be included and enabled for your workspace. ![Ask Graphit with page context and Explore, Draft, and Find tabs](/screenshots/assistant-explore.png "Start with a task, then refine the question in the composer.") ## Start with a task A new conversation has three tabs. Choose the one that matches what you want to do. | Tab | What it does | What happens when you choose a starting point | | --- | --- | --- | | **Explore** | Understand numbers, changes, and available metrics. | A suggested question is sent immediately. Suggestions may relate to your current dashboard, metric, or setup page. | | **Draft** | Prepare a dashboard, report, or target. Administrators can also prepare a calculated metric. | An editable prompt appears in the message box. Review or personalize it, then select **Send**. | | **Find** | Locate a destination or a control. | An editable question appears in the message box. Send it when it says what you need. | You can also write your own question. Press Enter to send or Shift+Enter to add a line. A question you have not sent stays in the message box if you close and reopen the assistant. **Where do I…?** starts a navigation question without sending it. Complete the question in the message box first. ## Check the page context The strip at the top of the assistant shows the current context, such as **Using This dashboard** or **Using This metric**. Expand **Context** to see the page and the filters shared with the assistant. Context updates as you navigate. A question from a metric detail page identifies that metric; a question from a dashboard identifies that dashboard. Where supplied by the page, the context also includes a period, campus selection, or grouping. This is not a copy of everything visible on your screen. If a date range, campus, service, or other detail matters, include it in your question and check that the answer uses it. For example: > Compare this metric in the first quarter of this year with the first quarter of last year. Use weekly totals and call out missing weeks. ## Explore and verify numbers Useful questions name the metric, the period, and the comparison you need. Use the metric names in your workspace. These examples are prompts to adapt, not claims about your data: - “Show the weekly trend for Weekend Attendance over the last 12 weeks.” - “Compare First-time Guests this quarter with the same quarter last year.” - “Which metrics changed the most this month compared with last month?” - “Does the drop reflect missing entries or a change in recorded values?” The assistant may answer with text, a chart, a comparison, or a table. Check the dates, grouping, campus scope, and underlying entries before relying on a conclusion. A lower total alone does not explain why something changed. While a response is running, the activity area shows its progress. Select **Stop** to stop the current response. You can write the next question while it works; sending becomes available when the current response ends. After a response finishes: - Expand its step summary to see the work it performed. - Select **Copy answer** to copy its text, including Markdown formatting. Chart images and interactive cards are not included. - Use **Good answer** or **Bad answer** to leave feedback. - Ask a follow-up in the same conversation to refine the question. ## Review a draft before saving Editors and administrators can ask for dashboard, report, and target drafts. Administrators can also draft calculated metrics built from existing metrics. A calculated metric can combine values into a total, ratio, or period average; use the normal metric setup flow for a manually entered metric. 1. Open **Draft** and choose a starting point, such as **Build a dashboard**. 2. Edit the prepared prompt to explain your audience, metrics, and intended result. 3. Select **Send**. Answer any follow-up questions about dates, filters, layout, or goals. 4. Review the draft card. Check its name, definition, scope, and available preview. 5. Select its **Save** action to apply it, or **Not now** to leave it unsaved. 6. Use the confirmation's **Open** link to inspect the saved item in Graphit. Asking for a draft does not save the item. The save action checks your current permissions again. If a draft has expired, ask the assistant to prepare it again. The same conversation can prepare changes to an existing dashboard or report, a report email schedule, or a report template when your role permits it. Be specific about what should change. Review schedule recipients and timing before saving. Viewers can explore data and ask navigation questions. The Draft tab explains when editor access is needed. In a workspace with a read-only subscription, drafting is paused until write access is restored. ![Draft starting points in Ask Graphit](/screenshots/assistant-draft.png "Draft starters prepare editable prompts. Review the proposed work before saving.") ## Find a control Open **Find** or select **Where do I…?** and ask a specific question: > Where do I share this dashboard with my team? When the assistant returns a navigation card, select its action. It can open the destination and highlight the relevant control. If the control is inside a menu or requires edit mode, the highlight first shows what to open. You choose that control; the highlight then moves to the destination. On a phone, a destination in the full navigation may first highlight **More**. On phones and tablets, the assistant closes when it needs to reveal a highlighted control. Reopen Ask Graphit to continue the conversation. If a control is unavailable for your role or no longer visible, Graphit gives a location hint instead of pretending it opened the control. You can also use [workspace search and navigation](navigation.md). ## Continue earlier work Select **Conversation history** in the assistant header. Search by a word in a conversation title, then choose the conversation to reopen it. Clear the search to see the full list again. Select **New conversation** for a separate topic. This starts a fresh conversation rather than deleting the previous one; reopen earlier work through history. The **Style** picker changes the assistant's response style: Pastor, Coach, Analyst, Mentor, Encourager, or Strategist. It does not change your permissions or the underlying data. The selected style is used for the next question and remembered in this browser. On desktop, the assistant sits beside the page. On phones and tablets, it opens as a full-screen sheet so the page and conversation are not squeezed into narrow columns. Use **Close assistant**, press Escape, or drag the top handle downward to return to the page. Closing the panel does not erase the conversation. ## Get help with Rock setup On integration and Rock measurement pages, available suggestions can help administrators discover measurements and understand setup requirements. The assistant may prepare a Rock measurement draft when the connection and organization allow it. Creating a measurement in Rock requires more than ordinary read access: - The organization must allow assistant-created Rock metrics in **Settings → AI**. - Rock must allow Graphit to create metrics through its plugin settings. - Required campus mappings must be complete. - You must review the proposed measurement and explicitly confirm it. The assistant explains an unmet requirement and can point to the relevant setup page. After you resolve it, return to the draft or ask for another proposal. A Rock setup request can run in the background; read its progress and final result before assuming the measurement is connected. ## Use the assistant on a phone or tablet On smaller screens, the assistant opens over the workspace so answers and controls have room to fit. Close it to return to the page. Your unsent question stays in the composer. ![Ask Graphit on a phone with task tabs and a message composer](/screenshots/assistant-mobile.png "Explore, Draft, and Find remain available on a phone. The composer stays within reach.") ## When the assistant cannot continue | What you see | What to do | | --- | --- | | Assistant unavailable or not set up | Check with an owner or administrator that the assistant is included and enabled for the workspace. | | Cannot reach the assistant | Check your connection and select **Try again**. | | Monthly allowance used up | Wait for the next monthly reset, or ask an owner or administrator to review the AI allowance in settings. | | A failed response | Select **Try again** where offered. The unsent question is preserved when sending fails. | | Lost touch with the assistant | Reopen the conversation from history to check for the final response. | | Drafting or saving unavailable | Check your role and whether the workspace is in read-only mode. | | Copy failed | Select the answer text and copy it manually. | For your first question, open a metric or dashboard you know well. Ask for a comparison you can check, then use the same conversation to explore the next question. --- --- title: Build a useful dashboard description: Organize dashboard pages, filter related widgets, compare actuals with targets, and connect reports and Rock tools. --- # Build a useful dashboard A dashboard brings related metrics into one view. Start with a question or meeting, then select the few numbers that help answer it. A useful dashboard explains its time period and gives readers enough context to interpret each chart. ## Find a dashboard Open **Dashboards**. Use **Mine**, **Shared with you**, and **Organization** to find the relevant collection. Use tags to narrow the collection. Select a dashboard's name to open it; use its star to keep it in **Favorites**. ![Executive Overview dashboard showing example measurements](/screenshots/dashboard-overview.png "A saved dashboard combines related numbers and charts in one view.") ## Create and arrange a dashboard 1. Choose **Create dashboard** and enter its details. 2. Open the dashboard and choose **Edit dashboard**. 3. Use **Add widget** in the editing toolbar. 4. Choose the widget type and configure its metric, period, and available options. 5. Arrange and size widgets on the canvas. 6. Choose **Done editing** to return to the reading view. Editing controls sit above the canvas so they do not cover chart values. Check the resulting dashboard at both desktop and phone widths before sharing it. ## Choose the right widget Use a number tile for a single result, a trend chart for change over time, and a comparison chart when the relationship between categories matters. Text can explain a definition or decision; a report widget can place a compact report in the same workspace. Avoid placing every available metric on one dashboard. Separate operational detail from a board or leadership overview, and keep related widgets together in sections where useful. ### Show a chart as a table Line, bar, and area widgets can show their values as a table instead. Set **Show as** to **Table (one row per period)**. The table lists each period, newest first, with a column for each series and a **Total** when the series can be added together. Comparison and target series are left out of the table. ### Show zero instead of no data By default, a number widget shows “No data available” when the selected campus or period has no entries. Turn on **Show 0 when there is no data** when an absent entry really means zero, such as a ministry that did not meet. Its comparison is then treated as zero too. Leave it off when a missing entry could mean that nobody recorded the number. ## Organize the dashboard into pages Pages give one dashboard several focused views, such as Overview, Attendance, and Finance. While editing, choose **Add page**. Use **Manage pages** to name pages, change their order, or add another page, then choose **Save pages**. New widgets belong to the page you are viewing. To move an existing widget, open its configuration and change **Dashboard page**. Moving a section moves its contents with it. Move or remove a page's widgets before deleting the page; a dashboard must keep at least one page. Readers switch pages using the tabs above the canvas. The address updates for the selected page, so browser back and a copied page link can return to that view. Active dashboard filters stay in place when switching pages. Dashboard managers can set **Who can view this page** to **Everyone with dashboard access** or **Selected organization members**. For a restricted page, select the allowed roles or members. The owner and administrators retain access. Restricted pages are excluded from public links and embeds. Page restrictions control access to that dashboard page and its widgets. They do not change access to the underlying metrics elsewhere in Graphit, and they do not inherit Rock security-group permissions. Review those permissions separately before using a restricted page for confidential information. To hide a confidential number everywhere in Graphit, restrict the [metric's audience](metrics.md#control-who-can-see-a-metric) as well. ## Make the period explicit A number such as “Attendance: 420” needs a period to be meaningful. Put the period in the widget title or use its configured period display. When comparisons or targets are enabled, leave enough room for the supporting text. A percentage change is a comparison with the configured baseline. Check that baseline before interpreting it as growth or decline. In the date-range controls, **Last 13 months** and **Last 24 months** include the current month through today plus the preceding 12 or 23 calendar months. **This ministry year** and **Last ministry year** use the organization's reporting calendar. A full ministry-year range can show future periods, which is useful for budgets. Choose **Recurring season** for a period that repeats every year, such as a summer program. Set **Season starts** and **Season ends**. Graphit uses the latest season that has started; an end date before the start date continues into the following year. Use **Custom dates** for a one-time range. **Last month** under **Rolling period** covers the previous full calendar month. To compare it with the whole month before, such as February with all of January, set a number widget's comparison to **Previous month**. **Previous period** compares with the same number of days just before the range instead. Choose **Last N days, weeks or months** for a window that moves forward each day. Set **Number of periods** and **Period**. The window always ends today, so the current, partial period is included: | Window | Covers | | --- | --- | | 30 **Days** | Today and the 29 days before it. | | 14 **Weeks** | The last 98 days, not aligned to calendar weeks. | | 6 **Months** | From the day after the same date six months ago. | | 6 **Months** with **Start on the 1st of the first month** | From the first day of the month six months back, through today. | ### Count only certain weekdays Use **Days to count** on a chart or number widget to include only entries recorded on selected weekdays, such as Sunday check-ins in a weekend summary. All days are selected by default, and at least one must stay selected. The filter uses each entry's recorded date and applies to the comparison period as well. ## Show categories over time Choose **Time and partition** when a chart should show a separate series for each service time, fund, or other metric breakdown. Select the time interval and partition. Under **Combined categories**, enter a category name and select values to combine, such as several holiday service times. Values that you do not combine remain separate series. Grouping by **Partition Type** alone shows one bar for each partition value. **Combined categories** works here too: for example, combine individual serving teams into broader volunteer types. Each value can belong to one category, and values you do not combine keep their own bars. For stacked bars, the actual series stack together. Comparison and target series appear as lines over those bars, so a previous-year total does not add to the current-year stack. ## Compare actuals with a changing budget Use a separate metric for the budget, either ordinary budget measurements or an existing Rock Goal connection. See [budget measurements](/integrations-rock#connect-budgets-and-goals). Select both the actual and budget metrics for the chart. Under **Actuals and targets**, mark each as **Actual** or **Target**. The budget can then vary by period instead of appearing as one flat target line. Use **Values over time** to control how the chart treats those measurements: | Control | When to use it | | --- | --- | | **Show values as → Each period’s value** | Show the result for each week, month, or other interval. | | **Show values as → Running total from range start** | Accumulate additive values, such as giving or completion counts. Unique-person counts, averages, and latest-value snapshots cannot be added this way. | | **Periods without entries → Leave a gap** | Distinguish missing data from a recorded zero. Use **Show zero** only when an absent entry should mean zero. | | **Future actual values → Hide future actuals, keep targets** | Show the remaining budget without displaying actual values in future periods. | | **Assign entries to → Week ending Tuesday** | Assign an entry to the next Tuesday, or keep it on Tuesday, before grouping. Other weekdays are available. This can move an entry into a different reporting month. | Leave **Assign entries to** set to **Their recorded date** unless the source's reporting definition calls for a week-ending rule. These display calculations do not change the source entries. Check currency, campus mappings, date ranges, and the actual/budget definitions before comparing results. ## Filter and inspect If the dashboard has filters configured, the filter toolbar appears above the canvas. Choose a campus or available breakdown to narrow the view. Use **Reset** to return to the dashboard's defaults. To let a chart filter the dashboard, edit a chart grouped by campus, partition, or time and partition. Turn on **Use chart clicks to filter this dashboard**, then save the widget. When a reader selects a category such as **Missions**, compatible charts, number tiles, and reports use that selection and an active-filter chip appears. Select the same category again or remove its chip to clear it. The category controls also work with a keyboard. You can combine filters from different dimensions, such as campus and fund. Selecting another value within the same dimension replaces that selection. A combined category selects all the values assigned to it. Metrics without that partition remain unchanged, and unrelated fixed widget filters still apply. Public links and embeds cannot use these selections to expand a widget's published scope. These selections do not save changes to the dashboard's definition. They follow you between pages of the current dashboard. On charts without click filtering enabled, legend controls continue to show or hide series. Use a widget's action menu for other available tools, including chart-data views. ### Open a dashboard with filters already applied The dashboard address records the campus and partition filters you select, so you can bookmark or share a filtered view. Choose the filters, then copy the address from your browser. Values that match the dashboard's defaults are left out of the address. | Parameter | Accepts | | --- | --- | | `campus` | A Graphit campus ID, the GUID of the linked Rock campus, or `all` to override a default campus. | | `partition` | A partition type ID and value ID separated by a colon, such as `partition=12:48`. Repeat the parameter for more than one partition type. | For example, a link from a Rock page can open a dashboard for one campus by adding `?campus=` and that campus's Rock GUID. An unknown campus shows all campuses. The same parameters work on public dashboard links, where they can only narrow what the link already shows. ## Include a report Add a report widget, choose its report, and set the number of displayed rows. The widget keeps the report's grouped rows, subtotals, and hierarchy. Dashboard campus and category selections apply to compatible report metrics, including the widget's Excel download. The displayed row limit keeps the widget compact; it does not replace the report's definition. Use the [report builder](reports.md) to change columns, ordered row groupings, calculations, and preview the complete result. ## Add a live group directory Choose **Add widget → Group directory**, select the **Rock connection** and **Group types**, and save the component to load its live data. The connected Rock plugin must support group directories. **Respond to page filters** makes the directory follow the selected campus. Use **Find a group** to search the list and **Refresh group directory** to reload it. Each row shows the group, campus, leader total, and member total. Open a group to view its record in Rock, where Rock checks your access. A person in several groups can contribute to several membership or leadership totals; those totals are not a count of unique people across all groups. To divide the list into sections, set **Group rows by** to **Group type** or **Named categories of groups**. For named categories, enter a **Category name** and the **Rock group IDs** that belong to it, separated by commas. A group can belong to one category. Groups outside your categories appear under **Other** unless you turn on **Hide groups outside these categories**. Each section heading shows its group count with leader and member subtotals. ## Link to details or a Rock tool In a widget's configuration, turn on **Add a link below this widget** and enter a **Link label**. Choose **Another dashboard page** for a link within the dashboard, or **A report, Rock tool, or web page** and enter its **Web address**. For a Rock tool that accepts a campus parameter, enter its expected name in **Campus query parameter (optional)**, such as `CampusId`, and choose a **Campus value**: - **Linked source campus ID** passes the Rock campus ID. This is the default. - **Linked Rock campus GUID** passes the Rock campus GUID, for Rock pages that expect a GUID. - **Graphit campus ID** passes Graphit's identifier, for another Graphit page. A linked value exists only for campuses matched to a Rock connection. Confirm the campus mapping and destination behavior before sharing the link. Links open a destination; they do not run a workflow or attendance recalculation automatically. Rock still controls access to its tools and the actions available there. ## Restricted widgets A widget that uses a [restricted metric](metrics.md#control-who-can-see-a-metric) shows a lock, **Restricted**, and “You don't have access to this data” to anyone outside that metric's audience. The widget's title and values are not loaded. The same placeholder appears on public links and embeds when the person who created them cannot see the metric. Dashboard page restrictions and metric audiences are separate controls; a person needs both to see a restricted widget's values. ## Share the right view Use the dashboard's action menu to review available sharing controls. Organization-wide access and public links serve different audiences. Check the displayed scope before sharing a link outside your team. For a structured output with selected metrics and date grouping, use a [report](reports.md). To review or correct underlying values, open the [metric](metrics.md). --- --- title: Build and complete data-entry forms description: Create repeatable collection forms, choose a layout, and record values for the right date and campus. --- # Build and complete data-entry forms A form groups metrics that people record together. Use a short form for a recurring task, such as entering weekend attendance after each service. Owners and administrators can create forms. Editors can complete forms and update existing forms where their access allows it. ## Build a form 1. Open **Data entry → Create form**. 2. In **Form details**, enter a name and a short description of when and how to use the form. 3. Choose an **Entry layout**. 4. In **Add metrics**, find the first metric and add it. 5. Add compatible metrics, then arrange **Selected metrics** in the order people should enter them. 6. Choose **Create form**. ![Data entry form builder showing form details and compatible metric groups](/screenshots/form-builder.png "Name the form, choose a layout, then add metrics that share a collection structure.") The setup and metric-selection areas sit beside each other on larger screens and stack on phones. The first selected metric determines which other metrics can be combined. Metrics on one form need compatible partition types. If an expected metric is unavailable, compare its breakdowns with the metrics already selected. Create separate forms when the collection tasks use different breakdowns. ## Choose Cards or Matrix | Layout | Best for | | --- | --- | | **Cards** | A short sequence of fields, especially when people enter data from a phone. | | **Matrix** | Comparing or entering several metrics across service times, rooms, or similar choices in a grid. | The saved layout is also used when the form is displayed in Rock. On a narrow screen, a wide matrix may need horizontal scrolling; Cards is often easier for a quick mobile task. ## Enter values 1. Open the form from **Data entry**. 2. Check the **date** before entering values. Use the date the measurement belongs to, which may differ from today. 3. Select the **campus** when the workspace requires one. 4. Choose the relevant breakdown values if the form has partitions. 5. Enter the values in the displayed fields. 6. Review the unsaved changes and save them using the form's save action. Do not assume an empty field means zero. Enter **0** when the measured result really was zero; leave uncollected values empty rather than inventing a measurement. Graphit shows errors next to fields that need attention. When a campus is required, choose one before trying to save again. After saving, review the success state and recorded values before moving to another date or location. ![Sunday Service form with date, campus, and separate service-time entries](/screenshots/data-entry-form.png "Check the date and campus before entering values for each service.") ## Work with repeated breakdowns A partitioned form may show one set of fields for each selected value or combination. For example, a service-time form can display separate entries for 9:00 AM and 11:00 AM. Use the selection controls to show the values you need. When the form offers a remembered selection, save that preference for the recurring task. Existing recorded values may remain visible even when they are outside the initial selection. ## Correct or remove a value To change a saved value, open the form again for the same date, campus, and breakdown, or edit the entry from the metric's **Entries** table. Owners and administrators can also [delete an entry](metrics.md#delete-an-entry) that should not exist, such as a duplicate. Deleting removes the value from every dashboard and report that uses the metric. ## Stay within your plan's limits Each plan includes a number of data entries per calendar month. When you have used 80% of that allowance, Graphit shows how many entries you have used this month. At the limit, **Add entry** and **Import spreadsheet** are unavailable until the next month or a plan change, and the notice links to **Upgrade**. See [plan limits](workspace-settings.md#plan-limits-and-usage). ## Use keyboard entry Choose **Show shortcuts** on the form to see its available keyboard shortcuts. Tab moves through fields. The save controls display their keyboard hint where supported. On a phone, use the persistent task navigation to return to Data entry without reopening the main menu. ## Edit a form safely Use **Edit form** to change its description, layout, selected metrics, or ordering. Changes to a form affect the collection interface; check the underlying metric definition when the unit or meaning of a number needs to change. A lock marks [restricted metrics](metrics.md#control-who-can-see-a-metric) in the form builder. You can add them, but people outside a metric's audience do not see its fields when they open the form. See [metrics](metrics.md) for metric definitions and [troubleshooting](troubleshooting.md) for empty or missing entries. --- --- title: Frequently asked questions description: Answers about pricing, supported Rock versions, data security, syncing, access, support, and cancelling. --- # Frequently asked questions Short answers to common questions, with links to the guides that explain each topic in full. ## Getting started ### How much does Graphit cost? Is there a free trial? Plans, prices, and the current trial offer are on the [Graphit pricing page](https://graphit.io/#pricing). To see Graphit with your own data first, [contact the Graphit team](https://graphit.io/contact) for a walkthrough. Your plan sets limits such as the number of campuses, dashboards, and metrics. Graphit warns you as you approach a limit. See [Plan limits and usage](./workspace-settings.md#plan-limits-and-usage). ### Do I need Rock or Planning Center to use Graphit? No. You can define metrics and record values with [data-entry forms](./data-entry.md). Connecting a church management system brings in the numbers it already keeps, so your team does not have to enter them twice. ### Should I connect Rock or Planning Center? Connect the system your church uses as its main database. | | Rock RMS | Planning Center | | --- | --- | --- | | How it connects | The free Graphit plugin, installed from the Rock Shop, then browser authorization. | Sign in to Planning Center and allow access. Nothing to install. | | What Graphit reads | Metrics you already keep in Rock, plus standard measurements Graphit can create there for you. | Check-ins, headcounts, groups, People lists, giving, and scheduled volunteers. | | Breakdowns | Campus, service time, and other partitions from your Rock metrics. | Giving by campus and headcounts by service time; other guided measurements are organization-wide. | | Show Graphit in your system | Embed dashboards, reports, widgets, and data-entry forms on Rock pages. | Not available. | Start with [Graphit for RockRMS](./rockrms.md) or [Connect Planning Center](./integrations-planning-center.md). ### Which versions of Rock are supported? The Graphit plugin supports Rock 17.2 and later. The current release is tested on Rock 17.2, 18.2, and 19.1. The Rock Shop listing shows each release's required Rock version. See [Graphit for RockRMS](./rockrms.md#before-you-begin). ## Data and security ### Is my data safe? Graphit connects to Rock and Planning Center through authorizations that an administrator approves. The Rock plugin stores its access tokens encrypted, and disconnecting Rock revokes them immediately. Inside Graphit, each person sees only what their role, campus access, and [metric audiences](./metrics.md#control-who-can-see-a-metric) allow. The [security page](https://graphit.io/security) and [privacy policy](https://graphit.io/privacy) describe how Graphit protects and handles data. ### What data leaves Rock? The Graphit plugin is designed to send as little as possible: - **Sent:** measurement values and counts, with their dates, campuses, and breakdowns. To count each person only once, some sources also send Rock's internal person IDs. These IDs are pseudonymous: they identify a person only within your Rock. - **Never sent:** names, email addresses, phone numbers, postal addresses, birth dates, ages, genders, photos, and individual gift amounts. - **Stays in Rock:** your metric SQL and Lava. Graphit receives only a fingerprint to detect changes. The one exception is an embedded data-entry form. So that each entry is attributed to the right person, the form tells Graphit which signed-in Rock person made it, including their name and email. Graphit reads Rock with the permissions of the administrator who connected it. Uninstalling the plugin removes its tables, settings, and admin page; metrics Graphit created stay in Rock as your data. ### Can I keep some numbers confidential? Yes. Owners and administrators can restrict a category or metric to selected roles and people. Everyone else does not see those metrics anywhere in Graphit, and dashboards show a **Restricted** placeholder in their place. See [Control who can see a metric](./metrics.md#control-who-can-see-a-metric). ### Who can see what? | Role | Can | | --- | --- | | **Viewer** | View dashboards and reports and apply filters. | | **Editor** | Also create dashboards and charts, record data, and schedule reports. | | **Administrator** | Also manage users, roles, data sources, and confidential metrics. | | **Owner** | Full control, including billing. | Campus access, dashboard page restrictions, and metric audiences can narrow what a person sees. Public links and embeds show what the person who created them can see. Rock's own security does not carry over into Graphit. See [Workspace settings](./workspace-settings.md#manage-people-and-sign-in). ## Syncing ### How often does data sync? | Source | How often | | --- | --- | | Rock metrics | Graphit checks for new values every hour. Standard measurements that Graphit creates in Rock are recalculated by Rock weekly, early on Monday. | | Planning Center, guided setup | Every morning at 6 a.m. in your organization's timezone. | | Planning Center, sources you add | Daily at 6 a.m. or hourly, as you choose. | | Data-entry forms | Immediately when saved. | Use **Sync now** on a connection or source to import available values without waiting. Weekly briefs are sent on the day and time set under **Settings → AI assistant**. ### Why is a Rock attendance number lower than our attendance? Graphit's standard attendance measurements count check-ins, not headcounts. People who are not checked in, often adults in the main service, are not counted. Record adult services with a headcount metric alongside. See [What the standard measurements count](./integrations-rock.md#what-the-standard-measurements-count). ## Account and billing ### How do I get help? Email [support@graphit.io](mailto:support@graphit.io) with your organization name and a short description of what you see. The [contact page](https://graphit.io/contact) lists other ways to reach the team. Before writing, [Troubleshooting](./troubleshooting.md) covers the most common problems and what to include in a report. ### How do I remove someone who has left? An owner opens **Settings → Users & roles**, chooses the person's **Actions**, and selects **Remove from workspace**. The reports, dashboards, folders, and forms they own pass to the owner who removes them, so nothing they built is lost. To stop someone signing in without removing them, choose **Deactivate**. See [When someone leaves](./workspace-settings.md#when-someone-leaves). ### How do I cancel? The organization's owner opens **Settings → Subscription & billing** and chooses **Manage billing**. Cancellation takes effect at the end of the current billing period. Graphit shows the date your subscription will end. ### What happens to our data if we cancel? Your dashboards and history are kept, but you cannot add or change data until you choose a plan again. To have your account and data deleted, contact [privacy@graphit.io](mailto:privacy@graphit.io). ### Can I export our data? Yes. Any report can be exported as Excel, CSV, or PDF from its **Export** menu, and report widgets on dashboards can be downloaded as Excel. Build a report with the metrics, date range, and row groups you need, then export it. Metrics Graphit created in Rock stay in Rock. For a broader export, contact [support@graphit.io](mailto:support@graphit.io) before cancelling. --- --- title: Get started with Graphit description: Set up your workspace and take one number from collection to a useful dashboard. --- # Get started with Graphit Graphit brings your organization's numbers into one workspace. Start with a single question—such as “How is weekend attendance changing?”—then connect or enter the numbers that answer it. The examples in these guides use **Riverbend Community Church**, a fictional organization with sample data. ## Understand the four main tasks | Task | Open | What you do there | | --- | --- | --- | | Define a number | **Metrics** | Choose what to measure, its unit, calculation, and breakdowns. | | Record values | **Data entry** | Fill out a form containing one or more metrics. | | See a pattern | **Dashboards** | Arrange charts, number tiles, text, and reports. | | Prepare an output | **Reports** | Select metrics and a date range, then view, export, or schedule the result. | A metric defines what a number means. An entry is a recorded value for that metric. A dashboard or report reads those entries; it does not replace them. ## Set up your workspace Open **Getting started** to see your organization's setup checklist. The checklist saves progress as you go, and you can return to it later. 1. **Start with your campuses.** Add the places your organization meets. Check the timezone, especially if you report across locations. 2. **Create a category.** Use recognizable areas such as Attendance, Giving, or Groups to keep related metrics together. 3. **Connect your data.** If you use RockRMS or Planning Center, open [Integrations](integrations-rock.md). You can also start with manual entry. 4. **Pick starter metrics.** Define only the measurements you need first. 5. **Make your first report** and **your first dashboard** to put those numbers to use. 6. **Invite your team** when the workspace is ready for others. Assign access for the work each person needs to do. You do not need to complete the checklist in one sitting. **Back to workspace** returns to your dashboards. Skipping a step does not configure that feature for you. ![Workspace setup with a step list and a focused campus setup panel](/screenshots/getting-started.png "Work through one setup task at a time. Your workspace keeps its progress.") ## Try a complete manual workflow 1. Open **Metrics** and choose **Create metric**. 2. Name it **Weekend attendance**, select **Count**, and use **Total** when you want recorded values added within each reporting period. 3. Choose an attendance category. Leave partitions empty for the simplest first metric. 4. Review and create the metric. 5. Open **Data entry**, create a form, and add that metric. 6. Open the form, check its date and campus, enter a value, and save. 7. Open the metric again to confirm the recorded entry and trend. 8. Add the metric to a dashboard or report. For recurring work, decide who records the number, when it is due, and what the number includes. Put that definition in the metric description so teammates use it consistently. ## Choose your next guide - [Find your way around](navigation.md) - [Define and manage metrics](metrics.md) - [Build and complete data-entry forms](data-entry.md) - [Create a dashboard](dashboards.md) - [Build a report](reports.md) ## If something is missing Your role, campus access, and organization plan can affect the controls available to you. Confirm the organization shown in the workspace switcher before changing settings. Ask an owner or administrator when you need access to a task that is not available. --- --- title: Glossary description: Plain-language definitions of Graphit concepts and where to use them. --- # Glossary ## Workspace The organization's Graphit environment: its people, settings, metrics, dashboards, reports, and connections. Switch workspaces from the organization selector when your account belongs to more than one. ## Metric A named measurement, such as worship attendance or fund giving. Its definition includes a unit and how values are combined. A metric's entries hold its actual measurements. See [Manage metrics](./metrics.md). ## Entry A recorded value for a metric at a particular date, with any applicable campus and breakdown values. An entry with zero is a measurement; an absent entry is missing data. ## Aggregation The rule used to combine multiple values, such as summing values or taking an average. Use a rule that matches the meaning of the measurement. ## Calculated metric A metric whose values are derived from other metrics through a calculation. Enter or sync the source measurements rather than manually collecting the calculated result. ## Category A subject group used to organize metrics and other supported items. Attendance and giving are examples. A category helps people find related work; it does not split an individual measurement into separate values. ## Audience The roles and people allowed to see a category or metric. A restricted audience hides those metrics from everyone else; owners and administrators always have access. A metric's audience can only narrow its category's. See [Control who can see a metric](./metrics.md#control-who-can-see-a-metric). ## Partition type and partition value A partition type is a dimension used to break down metric data, such as service time. Its values are the individual choices, such as 9:00 AM and 11:00 AM. A metric can use the partition types appropriate to its collection process. ## Campus An organizational location associated with data and user access. Campuses also have timezone settings. A campus filter narrows the data being shown. ## Data entry form A reusable collection screen that brings compatible metrics together. A form definition chooses what to collect; filling it records the measurements. See [Collect data](./data-entry.md). ## Dashboard and widget A dashboard is a saved arrangement of visualizations. Each widget displays selected data in a particular form, such as a chart, number, or table. Date and campus filters can change what its widgets show. See [Build dashboards](./dashboards.md). ## Report A saved selection of metrics and parameters for repeatable output. Reports support sharing and supported export or delivery actions. See [Create reports](./reports.md). ## Report template The layout used to render report output. A template defines presentation; the report supplies the selected metrics and parameters. Without a template, PDFs use Graphit's built-in table layout. ## Report schedule A recurring email delivery of a report, with its frequency, time, format, and recipients. A schedule can be paused and resumed, and pauses itself when its creator loses access or every recipient unsubscribes. See [Schedule regular delivery](./reports.md#schedule-regular-delivery). ## Standard measurement A metric definition that Graphit creates in Rock for you, such as Weekend Attendance or Giving. Rock calculates its values; Graphit can update the definition when it improves the template, unless your church has changed the metric in Rock. See [What the standard measurements count](./integrations-rock.md#what-the-standard-measurements-count). ## Integration A connection between Graphit and another system. Connecting a provider and configuring the sources that feed metrics are separate steps. ## Data source or measurement A configured selection of provider data that Graphit can import into metrics. The terminology and available choices depend on the provider. Review the source mapping, schedule, and sync status when troubleshooting imported data. ## Sync An attempt to read configured provider data and update Graphit. A connection can be healthy while an individual source is paused, misconfigured, or failing. ## Annotation An event, holiday, or campaign marker shown on supported charts to help explain changes over time. ## Assistant context The page and supported filters sent with your next assistant question. Open **Context** in the assistant to see what is included. It is not a guarantee that every visible item has been read or interpreted. See [Work with the assistant](./assistant.md). ## Draft An unsaved proposal prepared for review. In the assistant, a draft does not mean a dashboard, report, or other change has already been applied. Review the proposed action and confirm it when you are ready. --- --- title: Graphit documentation description: Practical guides for setting up your workspace, capturing metrics, exploring dashboards, and sharing reports. --- # Your guide to Graphit Build a shared understanding of what matters. Learn how to define metrics, collect consistent data, explore changes, and share the results with your team. ## Start with your next task | I want to… | Start here | | --- | --- | | Get a workspace ready for my team | [Set up your workspace](./getting-started.md) | | Find a page, metric, or action quickly | [Find your way around](./navigation.md) | | Decide what to measure and how to organize it | [Manage metrics](./metrics.md) | | Give people a simple way to submit numbers | [Collect data](./data-entry.md) | | See important measures together | [Build dashboards](./dashboards.md) | | Prepare an update to share | [Create reports](./reports.md) | | Ask questions or get help inside Graphit | [Work with the assistant](./assistant.md) | | Keep some numbers confidential | [Control who can see a metric](./metrics.md#control-who-can-see-a-metric) | | Find a quick answer about pricing, security, or syncing | [Frequently asked questions](./faq.md) | ## Bring your data together Connect a source when data already lives elsewhere. The setup guides explain what you need before connecting, how to map the information into metrics, and where to check the connection afterward. - [Install the RockRMS plugin](./rockrms.md), then [connect Rock RMS](./integrations-rock.md) - [Connect Planning Center](./integrations-planning-center.md) For your organization's identity, appearance, people, and access, use [Workspace settings](./workspace-settings.md). ## Understand how the pieces fit **Metrics** define what you measure. **Data entries** record values over time. **Dashboards** put those values into context. **Reports** turn a selection of information into a shareable output. ![The Graphit metrics library with search, category filters, and metric cards](/screenshots/metrics-library.png "The metrics library is the starting point for definitions, recorded values, and the views built from them.") Use the [Glossary](./glossary.md) when a term is unfamiliar. If an expected page, value, or action is missing, begin with [Troubleshooting](./troubleshooting.md). Common questions are answered in the [FAQ](./faq.md). ## Use this documentation Search from the top bar, browse the task groups, or follow **On this page** to jump to a section. Each guide ends with the next guide and a Markdown download. Select a screenshot to enlarge it; press **Escape** to return to the guide. Screenshots show a local demonstration workspace. Names and example values are illustrative. Available actions depend on your role, workspace settings, and connected services. For agents and documentation tools, use the [agent index](/llms.txt), [complete Markdown reference](/llms-full.txt), or [structured guide index](/guide-index.json). --- --- title: Connect Planning Center description: Choose Planning Center sources, match them to metric calculations, and verify a first sync before enabling a schedule. --- # Connect Planning Center Planning Center sources feed Graphit metrics with check-ins, headcounts, list counts, group attendance and membership, giving, and scheduled-volunteer activity. A guided setup creates the most common measurements for you. For anything else, you choose the source records, destination metric, history, and schedule yourself. ## Before you begin Use a Graphit **Owner** or **Administrator** account to connect Planning Center and manage sources. Your Planning Center sign-in must have access to the products and records you want to use, and the connection must grant the corresponding permissions. ## Connect your account 1. Open **Integrations** from the sidebar, or **More → Integrations** on a phone. 2. On **Planning Center**, choose **Connect**. 3. Sign in to Planning Center and complete its authorization. Allow every product you want Graphit to count: People, Check-Ins, Groups, Giving, and Services. 4. Return to Graphit. **Set up Planning Center** opens automatically. If you leave before finishing, choose **Finish setup** on the Planning Center card in **Integrations**. **Save and exit** keeps your progress, and setup returns to the step you left. ## Set up Planning Center step by step The guided setup has four steps. 1. **Connect.** **What Graphit can read** shows each Planning Center product as **Allowed** or **Not allowed**. If a product you need is not allowed, choose **Reconnect and allow more**. Under **Campuses & service times**, choose **Match all campuses** to match Planning Center campuses to yours by name and add any Graphit does not have yet. Resolve any campus left unmatched. Service times come from recent Check-Ins events and Services plans. 2. **Measurements.** Choose what Graphit should count, and answer each measurement's question, such as which events or funds to include. 3. **First sync.** Choose **Start first sync**. Graphit reads the last year of history, then refreshes every morning. You can continue while it runs; each measurement shows its status and how many values it imported. 4. **Review.** Check **Your measurements**, then choose **Create starter dashboard** for a dashboard with one card per measurement. Cards fill in as each first sync finishes. To return to the guided setup later, open the Planning Center card's actions menu and choose **Guided setup**. ### Measurements the setup offers | Measurement | What it counts | Needs access to | | --- | --- | --- | | **Check-ins** | Every check-in at the Check-Ins events you choose. | Check-Ins | | **Unique check-in attendees** | People who checked in at least once in the period, each counted once. | Check-Ins | | **Headcounts** | The headcounts your team records in Check-Ins for one event, by service time. | Check-Ins | | **Group attendance** | Attendance taken at the groups you choose. | Groups | | **Group members** | Current members and leaders of the groups you choose. | Groups | | **People list count** | How many people are on a People list you keep in Planning Center. | People | | **Giving** | Total given, by day and campus. Leave funds empty to include every fund. | Giving | | **Giving units** | Distinct donors who gave in the period. | Giving | | **Scheduled volunteers** | People scheduled or confirmed on Services plans. | Services | A measurement is unavailable, with the product it needs, until the connection allows that product. Reconnect and allow it to use the measurement. Measurements that already have history are marked **Set up** and keep their settings; change them in **Integrations**. **Group members** and **People list count** are current counts. They build history from the day you set them up and cannot reconstruct earlier values. ### Known limits of the guided setup - **Check-ins, Unique check-in attendees, Group attendance, Group members, Giving units, and Scheduled volunteers** are not split by campus or service time. They are whole-organization counts. - **Headcounts** are split by service time, and **Giving** is split by campus. - Check-ins and headcounts are dated on your organization's local day, so an evening service stays on the day it happened. If you need a different breakdown or schedule, add a source yourself as described below. ## Reconnect when access is revoked If Planning Center stops accepting Graphit's access, for example because the authorization was revoked or has expired, syncing stops. The Planning Center card shows “Planning Center access was revoked or has expired. Reconnect to resume syncing.” Choose **Reconnect**, sign in to Planning Center, and allow access again. The guided setup also offers **Reconnect Planning Center** and continues where you left off. Your measurements and their history are kept while the connection waits to be reconnected. ## Add sources yourself Create the destination [metric](./metrics.md) first, with a calculation that matches the question you are asking. For example, a current list size uses **Latest value**; giving totals use **Total**; distinct donors use **Unique entities**. A calculated metric that combines other Graphit metrics does not accept a Planning Center source directly. If an existing connection needs Groups, Giving, or Services access, open **More Planning Center actions → Settings** and use the **Reconnect** prompt. Reconnecting requests the current product permissions; source choices remain limited to the permissions Planning Center actually grants. Group sources need Groups access. If a needed source remains absent, check permissions with your Planning Center administrator and Graphit support. ### Choose a compatible source The **Source type** choices are filtered by the connection's permissions and the destination metric's calculation. Use this table before creating a source. | Source type | Choose in Planning Center | Compatible Graphit calculation | | --- | --- | --- | | **List count** | One list | **Latest value** | | **Check-ins activity** | One or more Check-ins events | **Unique entities**, **Occurrences**, or **Repeat participation** | | **Group attendance** | One or more groups | **Unique entities**, **Occurrences**, or **Repeat participation** | | **Group membership** | Groups, then **Members and leaders**, **Members**, or **Leaders** | **Latest value** | | **Recorded headcounts** | One Check-ins event; optional headcount categories | **Total**, **Average**, **Minimum**, or **Maximum**, depending on the question | | **Giving totals** | Optional funds and campus | **Total** | | **Giving donor activity** | Optional funds | **Unique entities**, **Occurrences**, or **Repeat participation** | | **Scheduled volunteers (Services)** | Service types; optional teams | **Unique entities**, **Occurrences**, or **Repeat participation** | For activity sources, **Unique entities** counts each identified entity once within the reporting period; **Occurrences** counts activity, including anonymous activity; **Repeat participation** applies the metric's occurrence threshold. These are different questions and can produce different values from the same source. Scheduled-volunteer data represents scheduled or confirmed volunteers on service plans. Do not treat that source as proof that someone attended or served. ### Add and save a source 1. Choose **Choose what to sync → Add Planning Center source**. The same source editor is available from a compatible metric. 2. Enter a **Source name**, or leave it blank to use the metric name. 3. Choose the **Connection**, **Destination metric**, and **Source type**. When adding from a metric, its destination is already selected. 4. Choose the source records using the lists in the editor. For funds and teams, an empty optional selection means all funds or teams within the selected scope. For recorded headcounts, no category selection means all categories for that event. 5. For sources with **Initial history (days)**, choose how far back the first import should go. The default is 90 days; the field accepts up to 3,660. Use 732 days when you need approximately two years for comparisons. 6. Choose **Daily at 6 a.m.** or **Hourly** under **Schedule**. The daily option shows the timezone that will be used. 7. Choose **Save source**. The source appears as **Paused**. Saving does not start a sync or enable its schedule. After creation, the connection, destination metric, and source type are fixed in that source's editor; create another source if you need a different combination. ### Verify, then enable the schedule Choose **Sync now** on the source to start its first import. Check the source's status and **Imported … through …** history coverage when available, then open the destination metric to inspect the resulting values. Before enabling a schedule, compare a known date or reporting period with Planning Center. Check the selected events, groups, funds, teams, campus, and metric calculation. Historical comparisons remain incomplete until the first import succeeds. When the result is right, choose **Enable schedule**. You can later choose **Pause**, change its schedule through **Edit**, or run **Sync now** again. The Planning Center connection's **Sync enabled** switch controls the connection as a whole; each source also has its own schedule state. ## Understand counts and missing history - **List counts and group membership are snapshots.** Today's count does not reconstruct past membership. Graphit records the observations it imports; increasing the history window cannot invent old snapshots. - **A list count of zero is a value.** A recorded headcount with no source record is missing data, rather than an automatic zero. - **Group membership counts each group separately.** Someone in two groups contributes to both group counts. Use a compatible activity calculation when the question is unique participation across a period. - **Recorded headcounts can count things other than people.** Choose the category and metric unit deliberately. - **History and later refreshes differ.** The initial import uses your selected history window; later activity imports refresh the recent window shown in the editor, normally 90 days. - **The source editor imports counts or activity facts, not a personal-profile directory.** Cohort rules for a list belong in Planning Center. ## Recover from common problems | Problem | Check or next action | | --- | --- | | **Source type** has no compatible options | Check the metric calculation and the connection's granted product permissions. A list or membership source requires **Latest value**. | | Giving or volunteer sources are missing | Open the connection's **Settings** and use its Giving/Services **Reconnect** prompt when shown. | | Group sources are missing | Open the connection’s **Settings** and use **Reconnect** when Groups is listed. If it remains missing, ask your administrator to check Groups access and the connection’s configured authorization scopes. | | The source is saved but has no values | New sources are paused. Choose **Sync now**, then inspect the destination metric and import status. | | Historical comparisons are incomplete | Wait for the initial import to finish successfully and check its date coverage. Current snapshots cannot reconstruct historical list or membership values. | | A scheduled import is not running | Check both the source's **Scheduled/Paused** state and the connection's **Sync enabled** switch. Confirm the displayed schedule timezone. | | A source returns an error | Check authorization and selected records, then retry that source. Keep existing results in view while investigating; a started sync is not proof of a completed import. | For a connection check, open **More Planning Center actions → Settings → Check connection** or **Check again**. The **Last check** result is separate from a source's import result. To stop one source, use **Pause**. To stop the entire connection temporarily, turn off **Sync enabled**. **Disconnect** requires confirmation and disables the connection's sources. Continue with [metrics](./metrics.md), [reports](./reports.md), or [RockRMS setup](./integrations-rock.md). --- --- title: Connect RockRMS description: Connect Rock, match your campuses and service times, choose measurements, and check the first values. --- # Connect RockRMS Connect Rock to bring its metrics into Graphit. You can read measurements that already exist in Rock or ask Graphit to create standard measurements there. Setup makes that choice for each measurement before you add it. Coming from the Rock Shop? Start with [Graphit for RockRMS](./rockrms.md) for plugin installation, requirements, and the first-use walkthrough. ![Integrations directory with a sample Planning Center connection and Rock connection option](/screenshots/integrations-overview.png "The demonstration workspace shows provider status and the next available setup action.") ## Before you begin You need an **Owner** or **Administrator** role in the Graphit organization and an administrator account in Rock. Install the Graphit plugin in the Rock instance you intend to connect. The **How to connect** link on Graphit's RockRMS integration card opens the plugin installation link and pairing instructions. Use the address of your Rock server, such as `https://rock.yourchurch.org`. Graphit must be able to reach that server. A normal plugin installation pairs through the browser; you do not copy REST keys or webhook URLs into Graphit. Confirm the intended Graphit organization before allowing the connection. A Rock installation pairs with one Graphit organization; connecting it to a different organization replaces its previous authorization. ## Connect the two systems 1. Open **Integrations** from the sidebar, or **More → Integrations** on your phone. 2. On the **RockRMS** card, choose **Connect**. 3. Enter the **Rock server URL**, then choose **Connect** again. 4. Follow the redirect to Rock and sign in as a Rock administrator if asked. 5. On **Connect Rock to Graphit**, check the **Graphit organization**. Choose **Allow and connect** to continue the authorization round trip. 6. Return to Graphit. A newly connected Rock opens the guided **Set up Rock** flow. You can also begin from Rock's **Admin Tools → Installed Plugins → Graphit** page using **Link Rock to Graphit**. Both entry points take you through Graphit organization selection and authorization. If you leave before finishing, use **Finish Rock setup** in the navigation, the **Finish setup** banner, or the RockRMS card's **Finish setup** button. **Save and exit** leaves the guided flow with progress saved. ## Discover what Rock already has The **Discover** step reads metrics, campuses, service times, and the availability of attendance and giving data. It separates current measurements from status snapshots, stopped measurements, empty metrics, and results it could not read. Review these groups before choosing what to bring into Graphit: - **Ready for your dashboard** contains recent values suitable for the starter dashboard. - **Status snapshots** describe a point in time. They can be read into Graphit but are excluded from the suggested weekly dashboard. - **Stopped updating** lets you choose **Keep history** or **Skip**. Historical values can still be useful even when a measurement no longer belongs on the current dashboard. - **No values yet** means Rock has a metric definition but has not produced values. Check the explanation: a metric with no schedule needs attention in Rock. - **Couldn’t read yet** is an incomplete check. Use **Refresh** and resolve the connection or plugin issue before treating the result as complete. Some older plugin versions cannot report exact value dates. Graphit shows an update notice when this affects discovery; do not interpret an unknown date as proof that the source has no history. ## Match campuses and service times The next step connects Rock's campuses and service times with their equivalents in Graphit. These matches determine where imported values belong. Choose **Match all campuses** to match names and add missing active campuses in Graphit. Closed campuses are left out. Review the result; duplicate names can require a manual choice. Use **Configure manually** to select an existing Graphit campus or **Add as new campus**. Use **Match all service times** for the same process with service times. Retired times are left out. If Rock has no service times to match, the page says there is nothing to do. These actions establish matches and, when needed, create the corresponding items in Graphit. They do not rename your campuses or service times in Rock. Resolve required matches before adding measurements that use them. ## Choose measurements and understand what changes On **Measurements**, select the rows you want. Open **Edit** on a row to review its Graphit name, folder, and any source questions. | Choice | What Graphit does | What happens in Rock | | --- | --- | --- | | **Use the one already in your Rock** | Creates the Graphit metric and connects it to the selected Rock metric. | Reads its metadata and values. A metric owned by Rock continues to calculate on its Rock schedule. | | A standard measurement marked **Not in your Rock yet — Graphit creates it there for you** | Creates the corresponding Graphit metric and its synchronization. | Creates the measurement in Rock using the selected answers and schedule. This requires metric-write permission. | | **Create a new one in Rock instead** | Uses a new standard measurement instead of connecting the existing candidate. | Creates a new metric; it does not replace the unrelated existing Rock metric. | | A row marked **Can’t bring in yet** | Leaves the measurement unchanged. | No setup occurs until the stated compatibility, permission, or matching issue is resolved. | For a creation row, inspect **What Graphit creates in Rock**. Answer the questions that apply, such as groups, rooms, campuses, or online channels. A single standard measurement can produce more than one metric. Choose **Add selected** once the list is correct. Follow each row's result. If some rows fail, use **Retry the ones that didn’t work** after resolving their error; the successful rows remain set up. ### Service times suggested from real check-ins For weekend measurements, Graphit suggests which services to count. It uses the service times set up for your campuses, plus any schedule that had weekend check-ins in at least 6 of the last 13 weeks. When every matched campus is covered, the answer is filled in for you, with a note such as “Using your 3 services” and the reason. Choose **Change** to review the list, and **Show all** to see every schedule. This also works when Rock has no weekend service times configured, as long as check-ins use a schedule. Midweek measurements always ask. Schedules with recent weekday check-ins are listed first. Graphit asks instead of suggesting when no schedule is marked as a weekend service or had recent weekend check-ins, when a weekend schedule has no day and time, or when a matched campus has no weekend service. Schedule suggestions need the Graphit plugin 0.7.2 or later. ### Recover when Graphit cannot create metrics If Graphit can read Rock but cannot create metrics, use **Save and exit** if you are in guided setup. In Rock, an administrator can turn on **Metric writes** on the Graphit page. Then open **Integrations → More RockRMS actions → Settings → Allow creating metrics** to authorize again. This recovery is available before setup is finished. Both the authorization and Rock's write setting must allow creation. ## What the standard measurements count Standard measurements that Graphit creates in Rock are weekly SQL metrics. Rock recalculates them on its own schedule, early each Monday. Read what each one counts before comparing it with numbers you already report. **Attendance measurements count check-ins, not headcounts.** Weekend Attendance, Midweek Attendance, NextGen Attendance, First-Time Guests, and Room Attendance count people who were checked in and marked as attended. People who are not checked in are not counted. At many churches adults are not checked in to the main worship service, so these numbers often cover kids and students only. Track adult services with a headcount metric, such as usher counts, alongside the check-in measurement. | Measurement | What it counts | | --- | --- | | **Weekend Attendance** | Check-ins on Saturday or Sunday in the selected areas and services, per campus, service time, and week. | | **Midweek Attendance** | The same, for check-ins on any other day. | | **NextGen Attendance** | Weekend check-ins in kids, students, and nursery areas, per campus and age group. | | **First-Time Guests** | Weekend check-ins that Rock flagged as a first visit. Guests who are not checked in are not counted; use a connection card or guest form for them. | | **Room Attendance by Location** and **Room Capacity by Location** | Weekend check-ins per room, and each room's capacity. Together they give room utilization. Rooms without a capacity are skipped. | | **Giving** | Contributions to the selected accounts and their sub-accounts, per campus and week. Only contribution transactions count; event registration and invoice payments are excluded. The campus comes from the account, or from the giver when the account has none. | | **Giving Units** | Givers counted by Rock's giving ID, so a household giving together counts once. Sub-accounts are included. | | **Volunteers Serving** | People with attended check-ins in the selected serving group types, on any day. Scheduled volunteers who did not check in are not counted. | | **Groups Participation** | Two metrics, Active Group Members and Active Groups, as rosters stood at the end of each week. | | **Steps** | Completed steps per campus and step type. | | **Online Attendance** | Interactions in the selected online channels, with a separate unique-people count. | | **Connection Status Snapshot** | Active people per connection status and campus. | **Distinct counts add up across campuses and teams.** In Giving Units, Volunteers Serving, and Groups Participation, each person or giving unit counts once per week. They are placed under one main campus and team: the campus they gave the most to, the campus and team they served with most, or the campus and group type where they hold the most memberships. Campus totals therefore add up to the whole church without counting anyone twice. ### When Graphit improves a standard measurement Graphit updates its standard measurements when it finds a better way to count. The next sync pushes the improved definition to the metrics Graphit created in your Rock. When the calculation itself changes, Rock recalculates the last 52 weeks so past values match the new definition. A wording-only change updates the description without recalculating. Graphit leaves a metric alone if your church has changed it in Rock since Graphit last updated it, including its title, SQL, partitions, or schedule. An update keeps the metric's category in Rock. Metrics you connected from Rock, rather than asking Graphit to create, are never changed. ## Budget measurements {#connect-budgets-and-goals} If your budget is stored as ordinary measurements in a separate Rock metric, connect that metric through the regular measurement setup and use it as the chart's target series. A budget does not have to use Rock's Goal measurement type. Existing connections to Rock Goal measurements continue to synchronize as separate Graphit metrics. Actual values and goal values remain independent, even when they come from the same Rock metric; ordinary actual imports do not include goals. Each source keeps its own synchronized values, dates, campuses, and breakdowns. Check the budget metric's currency, campus and other partition matches, and dates against Rock. On a dashboard chart, select both metrics and mark their roles under **Actuals and targets**. See [changing budgets and chart calculations](dashboards.md#compare-actuals-with-a-changing-budget). ## Use donor, step, and group data Period-distinct donor sources, completed-step sources, and live group directories require the updated Graphit plugin with those capabilities. An older working connection does not imply that it supports them. Install the compatible plugin in Rock, then use **Settings → Check plugin** before configuring these sources. Plugin installation is a separate administrator action. For a donor source, select **Giving accounts** or leave the selection empty for all accounts. **Transactions to include** distinguishes all transactions with an identified person from contributions only. Graphit counts each person once across the requested period; a household count or a sum of weekly donor counts answers a different question. For a step source, choose **Step types** and, if needed, a specific **Completion status**. Leaving the status empty includes statuses marked complete in Rock. Use occurrences to count completions or unique entities to count people, according to the metric's purpose. **History to keep refreshed (days)** sets the window to reconcile for these private sources. Keep enough history for the comparisons you use. Reconciliation removes missing records only after a complete, successful source response; an error or incomplete response must not be interpreted as deleted data. History outside that window is not reconciled by that run. For existing Rock metric values, the updated plugin can provide a complete snapshot that includes corrections and removals. Older plugins can replay and update values but cannot prove that an absent value was deleted. If a snapshot is too large or cannot complete, resolve the reported synchronization problem before treating the imported history as current. Group directories display live group records and leader/member totals rather than importing a new historical metric. Add one through [dashboard widgets](dashboards.md#add-a-live-group-directory). Group links open Rock and use Rock's access checks. Graphit does not automatically inherit Rock page or group permissions for its own metrics or dashboard audiences. ## Review the starter dashboard The **Review** step proposes a dashboard from eligible measurements with current data. Use **Remove** or **Put back** on proposed widgets, and read **Left out, and why** before choosing **Create dashboard**. Graphit may wait for the first synchronization before building the proposal. **Build now anyway**, when available, creates an earlier proposal with the measurements that are ready. **Build again** refreshes the proposal after more values arrive. You can use **Skip for now** if you do not want a starter dashboard. An empty proposal does not mean the connection failed. The page explains whether it needs first values, more recent history, or different measurements. Graphit creates one starter dashboard per Rock connection; an existing one opens for further editing. ## Check the first values The **Summary** shows what was matched, which measurements were created or read, what is syncing, and what was skipped. Verify those facts even if you skipped the dashboard. When first values arrive, compare the date, campus, and value with Rock. Choose **Confirm** if they are correct. Choose **Something’s off** to open the metric and review its Rock source. Confirming values requires Editor access or higher; connection setup remains an administrator task. Rock calculates measurements on its own schedule. Graphit-created sources check for new values hourly. Initial history may still be loading, and newly created standard measurements attempt a year of history where source data is available. **Sync now** imports available values; it cannot make an unrelated, unscheduled Rock metric produce data. After guided setup, return through **Integrations → RockRMS → Manage measurements**. Use **Choose measurements** to add more, **Check first values** to review pending confirmations, and **Refresh from Rock** after changes in Rock. ## Recover from common setup problems | What you see | What to do | | --- | --- | | **Complete Setup**, **Retry Setup**, or **Reconnect** on the integration card | Continue authorization. Check the server address if the connection could not be reached. | | **Update the Graphit plugin** | Update the plugin in Rock, then use **More RockRMS actions → Settings → Check plugin**. Return to setup after the capability check succeeds. | | A campus or service-time matching warning | Return to the matching step and resolve the listed matches. Graphit does not guess ambiguous names. | | **Waiting on Rock** or **No values yet** | Check the metric's calculation schedule and source data in Rock. A successful connection alone does not create values. | | An expired starter-dashboard preview | Choose **Build again**, review the new proposal, and create it. | | A first value looks wrong | Choose **Something’s off**, check the metric's source and matches, and resolve the difference before confirming. | For a connection check, open **More RockRMS actions → Settings → Check connection** or **Check again**. **Last check** changes to **Working** or the returned failure. This confirms the connection check; verify actual metric values separately. Use **Sync enabled** to pause or resume the connection. **Disconnect** requires confirmation and disables its synchronization sources; it is not the same as pausing one measurement. Continue with [metrics](./metrics.md) or [dashboards](./dashboards.md). --- --- title: Define and manage metrics description: Create clear metric definitions, choose calculations and breakdowns, and review recorded values. --- # Define and manage metrics A metric is a reusable definition of something you measure. Give it a clear name, a unit, and a description that explains what should be counted. The same metric can appear in multiple forms, dashboards, and reports. ![Metrics library with searchable measurements and category filters](/screenshots/metrics-library.png "Find a metric by name, category, or tag, then open it to review its values.") ## Create a metric Open **Metrics → Create metric**. The wizard has four steps: 1. **Basics.** Enter the metric name and description. Choose a unit of measurement and reporting calculation. 2. **Category.** Select a category, create one if needed, or continue without one where offered. 3. **Partitions.** Add optional breakdowns and mark any that must be supplied when entering data. 4. **Review.** Check the definition before creating it. Choose the unit carefully. The metric editor preserves the metric's type and unit after creation to protect the meaning of its existing entries. ![Create new metric dialog with four setup steps](/screenshots/metric-wizard.png "Review the metric definition before creating it.") ## Choose a calculation that matches the question **Total** adds the recorded values within a reporting period. Other available calculations may require compatible source activity rather than manually entered totals. Read the explanation shown below the calculation selector before choosing it. For example, a sum of attendance counts answers “How many attendances were recorded?” It does not automatically answer “How many distinct people attended?” A distinct-person result requires a source that supplies the relevant activity and identity information. Reporting-day and calendar settings can narrow which days count and define week starts, timezone, and reporting-year boundaries. Keep the calendar consistent across related metrics. Changing an imported activity metric's timezone can require rebuilding its history; use the guidance shown in the editor. ### Snapshots that are recalculated in full Some sources recalculate every row each time they run, such as a count of members in each group. For a **Latest value** metric like this, turn on **Each date is a complete snapshot**. Totals then use only the newest date, so a group missing from that date is not carried forward from an older one. Charts plot only the periods that have a snapshot, rather than filling the gaps between them. Leave the setting off when a source reports only the rows that changed. The setting is removed if you change the metric's calculation. ## Use categories and partitions for different purposes | Concept | Purpose | Example | | --- | --- | --- | | Category | Organizes metrics in the workspace | Attendance | | Partition type | Defines a breakdown recorded with a value | Service time | | Partition value | One choice within that breakdown | 9:00 AM | | Campus | Identifies the location associated with an entry | Downtown | Keep a simple metric unpartitioned when you need only one value per date and campus. Add a partition when the breakdown changes the decisions you can make. Avoid creating separate metrics solely to represent every service or room when one metric with a meaningful breakdown would be easier to maintain. ## Review a metric Open its name in **Metrics** to see the metric detail page. Use the trend to understand changes and the entries area to inspect the recorded values behind them. Date, campus, and available breakdown filters narrow the results. An empty result does not always mean the metric has no data. Clear or widen filters before recording another entry. ### Delete an entry Owners and administrators can remove a recorded value. In the metric's **Entries** table, choose the delete button on the entry's row. **Delete this entry?** names the value and date; choose **Delete** to remove it from the metric and from every dashboard and report that uses it. Delete an entry only when the measurement should not exist, such as a duplicate or a value recorded for the wrong date. When a value is wrong, edit it instead. Entries that come from Rock, a calculation, or an activity source cannot be deleted here; correct them at their source. ## Control who can see a metric Most metrics are visible to everyone in the organization. For confidential numbers, such as staff giving or pastoral care, owners and administrators can limit the audience of a category or an individual metric. - **For a category,** open **Settings → Categories**, edit the category, and set **Who can see this category**. - **For a metric,** open the metric, choose **Edit metric**, and set **Who can see this metric** in the **Category and organization** section. Choose **Restricted to selected roles and people**, then select **Editors**, **Viewers**, or individual members. Owners and administrators always have access and are not listed. A restricted audience with nobody selected is visible only to owners and administrators. A lock marks restricted metrics and categories in lists, pickers, and page headers. ### How audiences combine A person sees a metric only when its own audience **and** the audience of its category, and every parent category, all include them. A metric's audience can narrow its category's audience but never widen it. Restricting a category therefore restricts every metric and subcategory inside it. A calculated metric that uses a hidden metric is hidden as well. Only owners and administrators can change an audience, or move a metric into or out of a restricted category. ### What people outside the audience see For someone outside the audience, a restricted metric is absent rather than marked forbidden. It does not appear in metric lists, search, favorites, forms, reports, exports, or the assistant, and opening its address shows that it was not found. | Where | What happens | | --- | --- | | Dashboards | A widget that uses the metric shows **Restricted** and “You don't have access to this data.” No title or values are loaded. | | Reports | The metric's column is left out of the preview, output, and downloads. A report whose metrics are all hidden cannot be generated. | | Forms | The metric's fields are left off the form for that person. | | Public links and embeds | The content shows what the person who created the link or embed can currently see. Access is checked again on every view. If that person leaves the organization, restricted metrics stop appearing. | | Scheduled report emails | The report is generated as the person who created the schedule, for every recipient. Review the recipient list before scheduling a report that includes restricted metrics. | | Weekly briefs | Restricted metrics are always left out, whoever receives the brief. | Graphit audiences are separate from Rock security. Connecting a Rock metric does not copy Rock's permissions into Graphit; set the audience in Graphit before sharing confidential results. ## Edit the definition Open the metric's edit action. On larger screens, section navigation takes you to **Basics**, **Organization**, **Breakdowns**, **Sources**, and **Advanced**. On smaller screens, use the collapsible section headings. Review changes before saving. Removing or changing a breakdown can affect how existing data is interpreted; use the confirmation and impact information shown by Graphit. ## Connect or enter values - For manual collection, add the metric to a [data-entry form](data-entry.md). - For values already maintained in Rock, use [Rock setup](integrations-rock.md). - To present the result, add it to a [dashboard](dashboards.md) or [report](reports.md). --- --- title: Navigate your workspace description: Find dashboards, metrics, data entry, reports, integrations, and the tools you use every week. --- # Navigate your workspace Graphit organizes work into four destinations. The same destinations appear in the desktop sidebar and the navigation bar at the bottom of your phone. | Destination | Use it to | Related tools | | --- | --- | --- | | **Dashboards** | Review charts and key numbers together. Open a saved dashboard or build a view for your team. | Dashboard filters, widgets, sharing, and favorites. | | **Metrics** | Find a measurement, review its trend and entries, and manage how it is collected. | **Categories** organize metrics; **Partition types** define dimensions such as service or age group. These links appear beneath Metrics while you are working in that area. | | **Data entry** | Choose a form and record numbers. Owners and administrators can create forms; editors can update existing forms. | Pin frequently used forms in Data entry to keep them close. | | **Reports** | Build, generate, review, and distribute reports. | **Templates** appears beneath Reports while you are working with reports or report templates. | The highlighted destination shows the area you are working in, including detail and editing pages. For example, a metric's edit page stays within Metrics; a template's editor stays within Reports. ![Desktop task navigation with Metrics organization and workspace utilities](/screenshots/navigation-desktop.png "Task destinations stay at the top; management and assistance stay below.") ## Move between tasks on your phone Tap **Dashboards**, **Metrics**, **Data entry**, or **Reports** in the bottom navigation bar. These destinations stay available while the page scrolls. The bar occupies its own space below the page so it does not cover the page's save controls. Tap **More** for the full navigation drawer. It includes your favorites, the assistant, setup help, and the management destinations available to your role. The organization switcher is at the top of this drawer. Choose a destination to close the drawer and continue. You can also close it with the close button, by tapping outside it, or by pressing Escape when using a keyboard. ![Metrics on a phone with the bottom task navigation visible](/screenshots/navigation-mobile.png "Use the bottom bar for daily tasks and More for the full workspace navigation.") ## Keep frequent work close Select the star on a dashboard, metric, or report to add it to **Favorites**. Your favorites appear in the sidebar and in the phone's More drawer. Forms use a separate shortcut: open **Data entry**, choose **Form options** on a form, and select **Pin form**. The form appears in **Pinned by you** at the top of Data entry. Choose **Unpin form** from the same menu to remove that shortcut. Favorites belong to the current workspace. Switch organizations before looking for another organization's items. On desktop, choose **Collapse sidebar** at the bottom of the sidebar for more room to work. The compact rail keeps the same task destinations; hover or focus an icon to see its label. Choose **Pin sidebar open** to restore the full navigation and related links. Graphit remembers your choice on this browser. ## Search instead of browsing Select the search control at the top of the app, or press **⌘K** on Mac or **Ctrl+K** on Windows, to open workspace search. 1. Type the name of a dashboard, metric, category, partition, report, or settings page. 2. Use the arrow keys to move through the results, or point to a result. 3. Press Enter or select the result to open it. 4. Press Escape to close search. Search combines workspace content with navigation destinations. If an item is not in the current list, try a distinctive word from its name. Available content and actions depend on your access. ## Find connections and administration Owners and administrators have two management destinations: - **Integrations** opens connected services and integration setup directly. For Rock connections, this is where you review measurements and mappings. - **Settings** opens the organization directory: workspace information, branding, people and access, data configuration, and billing. If a linked Rock connection still needs its guided setup, **Finish Rock setup** stays available in the navigation. **Getting started** opens the workspace setup checklist. The account menu in the top-right corner contains your profile, appearance preference, feedback, and sign-out. Organization settings affect the workspace; your profile controls your own account. ## Switch organizations Select the workspace name or logo at the top of the sidebar. On a phone, open **More** first. Choose another organization from the list. The switcher also offers **Create organization** where available. Before entering data or changing settings, check the workspace name so you are working in the intended organization. An administrator impersonating a user sees the impersonated organization pinned until that session ends. ## Ask for help in context Choose **Ask Graphit** in the navigation, select the assistant button in the top bar, or press **⌘J** / **Ctrl+J**. The assistant uses the page you are viewing as context. The assistant is shown only when it is included and enabled for your workspace. For the keyboard shortcut reference, press **?** outside a text field, or **⌘/** / **Ctrl+/**. Press Escape to close menus and dialogs. --- --- title: Build and share reports description: Shape a report with a live preview, ordered row groups, and precise filters, then save or export the result. --- # Build and share reports A report brings selected metrics into one repeatable table. Choose the period, decide what each row represents, and check the actual values before saving. The same saved configuration is used for downloads and scheduled delivery. ## Find a report Open **Reports** and choose **Mine**, **Shared with you**, or **Organization**. Search by name, filter by category or tags, and choose a card or list layout. Open a report to review its metrics, period, row groups, filters, and visibility. Choose **View report** to read its output, or **Edit report** when you have editing access. ## Create a report with a live preview Choose **Create report**. The workspace has three sections you can revisit in any order: 1. **Details.** Give the report a recognizable name. Add a description, category, or tags if useful. Choose a PDF template for formatted output. **Organization-wide report** makes the report visible across your organization; leave it off for a personal report. 2. **Metrics.** Choose **Add metrics**, search for the metrics you need, select them, and add them to the report. Reorder the selected metrics to set their column order. Use **Column label** when the report needs a shorter or more specific heading; the underlying metric name stays the same. 3. **Rows & filters.** Choose the reporting period, row groups, and the data to include. Start with a simple configuration, then inspect the preview as you refine it. On a wide screen, **Report preview** stays beside the controls. On smaller screens, switch between **Configure** and **Preview**. The preview uses real data and updates after you finish changing a control. Wait for **Up to date** before judging the result. **Refresh** requests it again. The preview does not save the report. Choose **Save report** when its definition is ready. Graphit saves the details, selected metrics, and parameters together, then opens the report output. ![Report workspace with configuration sections beside a live data preview](/screenshots/report-builder.png "Move between Details, Metrics, and Rows & filters while checking the result. Save report keeps the complete definition.") ## Choose what each row represents In **Rows & filters**, use **Add row group** to add a campus, date, or available partition. A partition is a breakdown such as service time; see the [glossary](glossary.md#partition-type-and-partition-value). | Row groups, in order | What you get | | --- | --- | | No groups | One summary row across the selected period | | Date, set to Monthly | One row for each month with data | | Campus, then Date | Each campus's values broken down by the chosen date interval | | Date, then Service Time | Each period broken down by service time, when that partition is available | You can select up to four row groups. Use the up and down arrows to change their order, or the remove button to take one out. Metrics remain in columns. For a Date group, choose **Date grouping**: daily, weekly, monthly, quarterly, yearly, or ministry year. **Date range** controls which dates are included; **Date grouping** controls how those dates become rows. A custom range needs both a start and end date. With two or more groups, turn on **Show group subtotals** to include totals at group boundaries and a grand total. These values are calculated from the underlying data. Distinct counts, snapshots, and averages may not equal the sum of the displayed cells. If a metric does not have a selected partition breakdown, its grouped cells are blank and the preview explains why. Remove that grouping, use compatible metrics, or put that metric in a separate report. A blank cell is not a recorded zero. Older reports can retain a previous grouping style. If the controls offer **Use row groups**, select it only when you intend to replace that style, then inspect the new preview before saving. ## Filter the data without changing the rows Under **Include data from**, expand **All accessible campuses** and select the campuses to include. **Use all campuses** clears that selection. Your access still limits the result. Use **Add partition filter** to select a breakdown, then select one or more values to keep. For example, choose the Service Time partition and include two specific services. A filter narrows the data; it does not add a column or create separate rows. Add a row group as well when you want those values shown separately. Select at least one value for each partition filter. Use **Remove filter** to include all values for that partition again. If the result is empty, check the date range, campuses, and partition selections before changing the metrics. ## Continue an unfinished draft Graphit keeps unfinished changes in the current browser tab, separated by organization and report. If you return to the editor in that tab, **Your unfinished draft has been restored** confirms that the draft was recovered. A recovered draft has not been saved to the shared workspace. Choose **Save report** to keep it. **Cancel** offers **Keep editing** or **Discard changes** when there are unsaved edits; discarding also removes the local draft. Do not rely on this temporary draft to move work to another browser, device, or tab. If a preview fails, use **Retry preview**. A previous successful table may remain visible with an explanation; it does not represent the latest configuration until the preview is up to date. If saving fails, the editor keeps the draft so you can correct the issue and try again. ## Read and sort the output The output opens with a bounded preview. Use **More report actions → Switch to full report** when you need every row. Check the selected period, generation time, and row count before interpreting the numbers. Downloads use the full result, even when the on-screen preview is limited. For an ordinary table, select a column heading to sort it and select it again to reverse the direction. When subtotals are present, rows stay in the configured group order so each subtotal remains beside its group. A report without row groups shows a single row labelled **Total** under a **Summary** column. If a metric seems missing, open it to inspect its entries and filters. Follow [Troubleshooting](troubleshooting.md) when the result differs from what you expect. ## Export a report Open **Export** and choose **Export Excel**, **Export CSV**, or **Export PDF**. A PDF uses the report's template when one is assigned. Otherwise Graphit uses an active template owned by your organization. A system library template must be explicitly selected or copied into the workspace. When the organization has no template, the PDF uses Graphit's built-in layout: a landscape table titled with the report name, organization, date range, and generation time. Subtotal and total rows are shaded, any report warnings are printed above the table, and a period without data says so instead of showing an empty table. Sharing access, sending a downloaded result, and making a report organization-wide are different actions. Review the recipient or visibility scope for the action you choose. ## Email a report now Choose **Email report** from the report's action menu. Add each address under **Recipients** and press Enter. Add an optional message, choose **Attach as** **Excel** (the default), **PDF**, or **Both**, then choose **Send email**. Graphit confirms how many recipients the report was sent to. If some addresses could not be reached, a separate message lists them; check those addresses before sending again. Each person can send up to 30 report emails an hour. If you reach that limit, the dialog says how long to wait. Dashboard filters apply only to an Excel attachment. A report sent this way is a one-time email; recipients are not added to any schedule. ## Schedule regular delivery Editors, administrators, and owners can schedule a report when the plan includes scheduled reports. Your plan also limits how many schedules can be active at once. 1. Open the report's action menu and choose **Manage schedule**. 2. Choose **Create new schedule**. 3. Choose a **Frequency**: **Daily**, **Weekly** with a **Day of week**, or **Monthly** with a **Day of month**. 4. Set the **Time** and **Timezone**. The timezone starts as your organization's; everyone receives the report at that time in that timezone. 5. Choose the **Format**: **PDF** (the default for schedules), **Excel**, or **Both**. 6. Add the **Recipients** and, if useful, a **Message (optional)** that appears in the email above the attached report. 7. Choose **Create schedule**. Each schedule in **Manage schedules** shows its recurrence, format, recipients, next send, and **Last sent**, the time of the last successful delivery. Use **Edit schedule** to change the time, timezone, frequency, recipients, message, or format. Use **Pause schedule** and **Resume schedule** to stop and restart delivery without losing the settings, or **Delete schedule** to remove it. The schedule's creator, the report's owner, or an administrator can edit, pause, or delete a schedule. A scheduled report is generated as the person who created the schedule, so recipients see what that person can see, including any [restricted metrics](metrics.md#control-who-can-see-a-metric) they have access to. ### When a delivery fails If a delivery fails, Graphit tries again after 5 minutes, 30 minutes, and 2 hours, never later than the next regular send. If those attempts also fail, it waits for the next scheduled time. The schedule shows **Last delivery failed** with the reason. A delivery counts as sent when at least one recipient receives it. Editing the schedule clears the failure message. ### When a schedule pauses itself A schedule shows a **Paused** badge and its reason when Graphit stops sending it. This happens when: - The person who created it no longer has an account, has been deactivated, has left the organization or is no longer an editor, or can no longer open the report. - Every recipient has unsubscribed. To restart delivery, review the recipients and choose **Resume schedule**. If the creator can no longer send the report, the person who resumes or edits the schedule becomes its sender. ### Unsubscribe links Every scheduled email ends with **Unsubscribe from this report**. The link works without signing in and applies only to that email address and that schedule. The recipient confirms on the page that opens; other reports they receive are not affected. Many email apps also show their own unsubscribe button for these emails. Manually emailed reports are one-time messages and do not include an unsubscribe link. ## Create a PDF template Administrators can create and edit the templates used across the workspace. Open **Templates** from the Reports navigation. Start with a copy from the template library or create a template. System templates stay read-only; edit your own copy. The template editor has three work areas: - **Variables** lists the supported report values you can insert. - **Template source** separates Body, Header, Footer, and CSS. - **Preview** renders the template against its selected data source. Choose a variable to insert it at the cursor. After editing source, refresh the preview. Check the result before saving or exporting a PDF. Sample preview data is illustrative; select an actual report when you need to verify how the template handles its values. On smaller screens, use the **Variables**, **Editor**, and **Preview** tabs instead of side-by-side panels. ![PDF template editor with variables, source, and preview](/screenshots/template-editor.png "Insert variables into the source, then use Preview or Refresh to check the rendered layout.") ## Keep reports maintainable Use names that identify an audience or purpose, such as **Weekly ministry review**. Describe what the report includes and how it should be read. Reuse a template for consistent output, and keep the underlying [metrics](metrics.md) clearly defined. --- --- title: Graphit for RockRMS description: Install the Graphit RockRMS plugin, connect your organization, and turn Rock measurements into dashboards and reports. --- # Graphit for RockRMS Bring your Rock measurements into Graphit to explore attendance, giving, and ministry trends in shared dashboards and reports. The Graphit plugin connects your Rock installation to your Graphit organization; you choose which measurements to bring across. This is the installation and getting-started guide for the **Graphit Rock Shop plugin**. Already installed? [Connect your organization](#connect-your-organization). Already connected? [Choose measurements and check your first values](#choose-measurements-and-check-your-first-values). ## Before you begin You need: - An administrator account in the Rock installation you want to connect. - A [Graphit account and organization](https://app.graphit.io), with **Owner** or **Administrator** access to that organization. - Your Rock server's HTTPS address, such as `https://rock.yourchurch.org`. Graphit must be able to reach it. - Rock 17.2 or later. The current plugin is tested on Rock 17.2, 18.2, and 19.1. Check the package's Rock version requirement before installing or updating. ## Install the plugin in Rock 1. Sign in to Rock as an administrator and open **Admin Tools → Rock Shop**. 2. Open the **Graphit Integration** listing and install the package compatible with your Rock version. Follow Rock's installation prompts. 3. After installation, open **Admin Tools → Installed Plugins → Graphit**. 4. Choose **Link Rock to Graphit** to begin connecting your organization. The plugin provides the connection; measurements, dashboards, and reports are managed in Graphit. For Rock's package installation help, see the [official Rock Shop](https://www.rockrms.com/rockshop). ## Connect your organization Starting from **Link Rock to Graphit** in Rock takes you through Graphit sign-in, organization selection, and authorization. Check that you have selected the intended organization before continuing. You can also start in Graphit: 1. Open **Integrations** from the sidebar, or **More → Integrations** on a phone. 2. On the **RockRMS** card, choose **Connect**. 3. Enter your **Rock server URL** and choose **Connect** again. 4. Follow the redirect to Rock and sign in as a Rock administrator if asked. 5. On **Connect Rock to Graphit**, check the **Graphit organization**, then choose **Allow and connect**. 6. Return to Graphit to continue **Set up Rock**. On the Graphit page in Rock, a successful link shows **Connected** and the linked organization. **Open Graphit** takes you back to the app. ![Graphit's Integrations page with Connect and How to connect on the RockRMS card](/screenshots/integrations-overview.png "Choose Connect on the RockRMS card. This demonstration workspace also has a Planning Center connection.") The normal setup uses browser authorization. You do not need to copy REST keys or webhook URLs into Graphit. A Rock installation pairs with one Graphit organization; connecting it to another organization replaces its previous authorization. If you need to stop, choose **Save and exit**. Return through **Finish Rock setup** or the RockRMS card's **Finish setup** button. ## Choose measurements and check your first values Work through the guided setup in Graphit: 1. **Discover what Rock already has.** Review which measurements have recent values, which only have history, and which need attention in Rock. 2. **Match campuses and service times.** Match Rock's campuses and times to Graphit so each value lands in the right place. Review ambiguous or missing matches. 3. **Choose measurements.** Select the rows you want. Each row explains whether Graphit will use an existing Rock metric or create a standard measurement in Rock. Review the row's questions and choose **Add selected**. 4. **Review the suggested dashboard.** Keep or remove proposed widgets, then choose **Create dashboard**, or skip this step for now. 5. **Check the first values.** Compare the date, campus, and value with Rock. Choose **Confirm** when correct, or **Something's off** to investigate. For the complete walkthrough, including matching, measurement choices, and first-value checks, use [Connect RockRMS](./integrations-rock.md). ![Graphit's metrics library showing measurement names, category filters, and search](/screenshots/metrics-library.png "Use the metrics library to find and organize measurements. All screenshots in this guide show the fictional Riverbend demonstration workspace.") Rock calculates its measurements on their own schedules. Initial history may still be loading after connection. **Sync now** imports available values; it cannot make an unscheduled Rock metric produce data. After guided setup, open **Integrations → RockRMS → Manage measurements** to add more measurements or check pending first values. Use **Refresh from Rock** after changing the source in Rock. ## Understand what the plugin can change | Your choice | What it does | | --- | --- | | Connect an existing Rock metric | Reads its metadata and values into Graphit. The Rock metric continues calculating on its existing schedule. | | Ask Graphit to create a standard measurement | Creates the measurement in Rock using the options you review during setup. This requires metric-write permission. | | Match campuses or service times | Connects the two systems' records and can create missing equivalents in Graphit. It does not rename those records in Rock. | Creating measurements requires both **Metric writes** on the Graphit page in Rock and authorization in Graphit. If Graphit can read but cannot create, open **Integrations → More RockRMS actions → Settings → Allow creating metrics** to authorize after checking the Rock setting. Reading existing measurements does not require you to enable creation. The plugin sends Graphit counts and measurement values, not people's profiles. Some sources include Rock's internal person IDs so Graphit can count each person once; names, contact details, birth dates, and individual gift amounts are never sent. Your metric SQL stays in Rock. The one exception is an embedded data-entry form, which tells Graphit which signed-in Rock person made each entry. See the [FAQ](./faq.md#what-data-leaves-rock) for details. Only enable the sources your organization needs. Some optional donor, step, and group features work with individual or group records, not just totals. Review [donor, step, and group data](./integrations-rock.md#use-donor-step-and-group-data) before configuring those sources. Graphit access is managed separately from Rock; review who can see your metrics, dashboards, and reports in [workspace settings](./workspace-settings.md#manage-people-and-sign-in). ## Build your first dashboard or report Start with a few measurements that answer a useful question: weekend attendance by campus, giving over time, or progress in a ministry. Add a date range and clear labels so your team knows what the numbers represent. ![An Executive Overview dashboard with attendance, giving, and ministry widgets](/screenshots/dashboard-overview.png "A demonstration dashboard combines several measurements in one view. Your dashboard reflects the measurements and layout you choose.") - [Build a dashboard](./dashboards.md) with pages, charts, comparisons, and shared filters. - [Create a report](./reports.md) grouped by campus, date, or multiple dimensions, with a preview before sharing. - [Manage metrics](./metrics.md) to organize definitions, recorded values, and sources. ## Show Graphit content on a Rock page The plugin also includes a **Graphit Embed** block. Use it to place a dashboard, report, individual widget, or metric entry form on a Rock page. 1. Create the content you want in Graphit first. 2. In Rock's page editor, add a **Graphit Embed** block to the intended page. 3. Open the block configuration bar and choose the **Edit Embed pencil**. The content picker is here, rather than in Rock's ordinary settings gear. 4. Select **Dashboard**, **Report**, **Widget**, or **Metric entry form**, then choose the resource by name. Use **Refresh list** if you just created it; only content eligible for embedding appears. 5. Choose **Panel with title**, **Panel without title**, or **No panel**. Adjust the background and Graphit header display to suit the page, then save. 6. Open the page as a member of its intended audience and check both the content and the page's access settings. Metric entry forms require the visitor to sign in to Rock and attribute the submission to that Rock person. If the block asks you to **Reconnect to enable Graphit embeds**, reconnect from **Admin Tools → Installed Plugins → Graphit**, then reopen the embed settings. ### How embeds stay secure and current Each embed is a signed, time-limited link bound to the Rock site it was created for. Graphit content can be framed only by that Rock site; another website cannot display it in a frame. Anyone who has the embed's address can still open its data outside a browser frame, so embed only content that every viewer of the Rock page may see. If an embed's address is exposed, contact Graphit support to revoke it. From plugin 0.7.2, an embed renews its own signature when it is displayed within 7 days of expiring. You do not need to re-save the block. If a renewal fails, the error is recorded in Rock's Exception Log and the embed keeps working until its current signature expires. An expired embed shows “Graphit is unavailable right now” instead of an error page. Embeds display what the person who created them can see in Graphit. A widget that uses a [restricted metric](./metrics.md#control-who-can-see-a-metric) that person cannot see shows a **Restricted** placeholder. ## Update or troubleshoot the connection Install compatible plugin updates through Rock's normal plugin process. Then open **Integrations → More RockRMS actions → Settings → Check plugin** in Graphit to refresh the available capabilities. | What you see | Next step | | --- | --- | | The Graphit page is missing in Rock | Confirm installation completed, sign in as a Rock administrator, and check **Admin Tools → Installed Plugins**. | | Connection failed, **Reconnect**, or **Retry Setup** | Check your Rock HTTPS address and reachability, then complete browser authorization again. Verify the intended Graphit organization. | | **Update the Graphit plugin** | Install a compatible current release in Rock, then use **Check plugin** in Graphit's integration settings. | | Graphit can read measurements but cannot create them | Check **Metric writes** in Rock and **Allow creating metrics** in Graphit's integration settings. | | **Waiting on Rock** or **No values yet** | Check the metric's schedule and source data in Rock. Allow the initial import to finish. | | Values appear under the wrong campus or date | Review source matches and compare the first values with Rock before confirming them. | Use **Settings → Check connection** for a connection test. A working connection is the first check; compare actual measurement values as well. See [connection troubleshooting](./integrations-rock.md#recover-from-common-setup-problems) for more detail. For help, email [support@graphit.io](mailto:support@graphit.io) or [contact the Graphit team](https://graphit.io/contact) with your Rock version, Graphit plugin version, the step you were on, and the error shown. Include screenshots with any private information removed. --- --- title: Troubleshooting description: Resolve common navigation, data, reporting, integration, and assistant problems. --- # Troubleshooting Start with the workspace name, the page you are viewing, and its current filters. Many apparent data problems come from the wrong workspace, campus, or date range. ## I cannot find a page or action Use the sidebar on a computer or the bottom task bar and **More** on a phone. Search can also find pages, metrics, dashboards, and reports. See [Find your way around](./navigation.md). Some actions require an owner or administrator. Editing controls can also be unavailable when a workspace is read-only. Ask an administrator to confirm your role and campus access if an expected action is missing. ## A chart or report has no data Check these in order: 1. Confirm the workspace in the navigation header. 2. Open the metric itself and check whether it has entries. 3. Compare the entry dates with the dashboard or report date range. 4. Check campus and partition filters. 5. For imported data, review the source's last sync and any errors under **Integrations**. A missing entry and an entry with a value of zero mean different things. Enter zero when a measurement was taken and its result was zero. Do not enter zero merely to hide a missing-data state. ## A widget says Restricted or a metric is missing The metric has a restricted audience that does not include you. Owners and administrators can review **Who can see this metric** on the metric and **Who can see this category** on its category and each parent category. See [Control who can see a metric](./metrics.md#control-who-can-see-a-metric). On a public link or embed, the content shows what its creator can see. If that person has left or lost access, ask someone with access to create the link or embed again. ## A total differs from what I expected Check the metric's aggregation method, the selected date range, and any breakdown filters. Summing a series, averaging its values, and using a last recorded value can produce different answers from the same entries. For calculated metrics, check the source metrics and calculation. For reports, review the report's parameters as well as its selected metrics. See [Manage metrics](./metrics.md) and [Create reports](./reports.md). ## I cannot add a metric to a data entry form Forms group measurements that can share the form's breakdown structure. An incompatible partition configuration can prevent a metric from being added. Review the metric's partition types and use a separate form when the collection structure differs. Calculated metrics are derived from other metrics; collect their source values instead. See [Collect data](./data-entry.md). ## My form has unsaved changes Keep the page open and inspect validation messages. Use the form's save action after correcting the affected fields. If an error reports a failed save, verify the saved entries before entering the same values again. On a phone, scroll within the form if a control is out of view. The bottom navigation changes pages; it does not save your form. ## An integration is connected but no measurements arrive A connection establishes access to the provider. It does not mean every source has been selected or scheduled. - In Rock setup, finish matching campuses and service times, selecting measurements, and reviewing the proposed setup. - In Planning Center, choose data sources and review their schedule state. A saved source can still be paused. - Inspect errors and recent sync activity before reconnecting. Repeated reconnects do not resolve missing provider permissions or a source that has not been configured. If Planning Center shows that access was revoked or has expired, choose **Reconnect** on its card. See [Reconnect when access is revoked](./integrations-planning-center.md#reconnect-when-access-is-revoked). A Rock attendance measurement that seems low may be working as designed: it counts only people who were checked in. See [What the standard measurements count](./integrations-rock.md#what-the-standard-measurements-count). Follow [Connect Rock RMS](./integrations-rock.md) or [Connect Planning Center](./integrations-planning-center.md) for provider-specific recovery. ## A report export looks different from the page The report template controls the exported layout. Check the report's selected template, filters, and parameters. Preview a custom template with representative data before sharing it. If a template variable produces no content, check that the data is included in the report. See [Create reports](./reports.md#create-a-pdf-template). ## A scheduled report stopped arriving Open the report, choose **Manage schedule**, and read the schedule's status. - **Paused** with a reason: the creator lost access, or every recipient unsubscribed. Review the recipients and choose **Resume schedule**. - **Last delivery failed**: Graphit retries automatically, then waits for the next scheduled time. Check the reason and the recipient addresses. - Neither: check the recipient's spam folder, and whether they used **Unsubscribe from this report**. See [Schedule regular delivery](./reports.md#schedule-regular-delivery). ## The assistant gives an incomplete or unexpected answer 1. Expand **Context** to inspect the page and filters included with the question. 2. Name the metric, campus, and time period explicitly. 3. Ask one concrete question at a time. 4. Check important values against the source metric or report. Draft and Find starters place text in the composer for review. Explore suggestions send their question immediately. Drafted changes still need review and confirmation when an action is offered. See [Work with the assistant](./assistant.md). If the assistant is unavailable, review the displayed message and workspace settings. Some requests need a configured integration or a role with additional access. ## What to include when reporting a problem Record the page, approximate time, selected workspace, active filters, exact error text, and steps that led to the problem. Include a screenshot of the affected area if useful. Remove private data and credentials before sharing it. Send it to [support@graphit.io](mailto:support@graphit.io). --- --- title: Workspace settings description: Configure organization preferences, appearance, access, campuses, and shared defaults. --- # Workspace settings Owners and administrators manage the workspace from **Settings**. Personal preferences live in **Your profile**, opened from your account menu. ## Find a setting Open **Settings** from the sidebar, or **More** on a phone. Search settings by name or use the groups below. On wide screens, section navigation stays beside the form. On smaller screens, use the selector showing the current section. | Group | Use it for | | --- | --- | | Workspace | Organization information, locale, branding, campuses, and chart colors | | Access | Users, roles, campus access, and sign-in methods | | Data & connections | Categories, partition types, integrations, assistant preferences, and chart annotations | | Billing | Subscription, plan usage, and billing | ![Workspace settings grouped by task](/screenshots/workspace-settings.png "Use the settings directory to find workspace, access, data, and billing controls.") ## Set organization preferences 1. Open **Settings → Organization**. 2. Review the organization's contact information. 3. Under **Locale & formatting**, choose the workspace defaults for date, time, and calendar formatting. 4. Use **Save changes** when the pending-changes bar appears. **Discard** restores the saved values. A person's profile can override supported locale preferences. If two people see different date formats, compare their profiles before changing the organization defaults. ## Personalize the workspace Open **Settings → Branding & appearance**. - **Workspace identity** controls the display name people see in the app. - **Logos & icon** accepts PNG, JPEG, or WebP images up to 2 MB and 4096 pixels per side. Provide artwork suitable for each supported background. - **Color scheme** controls the primary color, optional secondary color, and navigation appearance. Review your draft before saving. Picking a file or changing a color does not publish it immediately. Save to apply the changes, or discard to return to the saved appearance. Use **Chart colors** for the palette assigned to chart series. The workspace's primary button color and its chart-series colors serve different purposes. ![Branding settings for display name, logos, and workspace colors](/screenshots/branding-settings.png "Edit your workspace identity and review appearance changes before saving.") ## Configure campuses and metric organization Use **Campuses** to manage locations and their timezone settings. Campus access also affects which data a person can use. Use **Categories** to group metrics by subject, such as attendance or giving. Use **Partition types** to define breakdowns within a metric, such as service time or age group. See [Manage metrics](./metrics.md) before choosing a new breakdown: a category and a partition solve different problems. A category can also limit who sees its metrics. Edit the category and set **Who can see this category** to restrict it to selected roles and people. See [Control who can see a metric](./metrics.md#control-who-can-see-a-metric). ## Manage people and sign-in Open **Users & roles** to invite people and review their roles and campus access. Give each person the access their work requires. The available controls depend on your own role and workspace state. | Role | Can | | --- | --- | | **Viewer** | View dashboards and reports and apply filters. | | **Editor** | Also create dashboards and charts, record data, and schedule reports. | | **Administrator** | Also manage users, roles, data sources, and who can see confidential metrics. | | **Owner** | Full control, including billing and the subscription. | Open **Authentication** to review allowed sign-in methods and configure supported providers. Provider setup includes values that must also be entered in the provider's administration console. Follow the values shown for your workspace, including its redirect address; do not copy addresses from another workspace. Keep a working sign-in method available while testing a provider change. Check the new method in a separate browser session before relying on it. ### When someone leaves In **Users & roles**, open the person's row **Actions** and choose one of two options. Both ask you to confirm. | Action | What happens | | --- | --- | | **Deactivate** | The person can no longer sign in to Graphit, in this workspace or any other workspace they belong to. Everything they own stays where it is. **Activate** restores their access. A deactivated person still counts toward your plan's user limit. | | **Remove from workspace** | Owners only. The person loses access to this workspace immediately. The reports, dashboards, folders, and forms they own here pass to you. Their campus access, the items shared with them, and their assistant conversations here are deleted. Data entries, metrics, and other records they created stay, without their name attached. If this was their only workspace, their Graphit account is deleted too; to bring them back, invite them again. | You cannot remove yourself, and a workspace's last owner cannot be removed; make someone else an owner first. Deactivating or removing someone also affects the work that runs in their name: - **Scheduled reports** they created pause at their next send and show why. The report's owner or an administrator can review the schedule and resume it; the person who resumes it becomes its sender. - **Public links and embeds** they created keep working, but show only what that person can currently see. After removal, restricted metrics no longer appear in them. ## Plan limits and usage Your plan sets limits on users, campuses, dashboards, metrics, and data entries per month. Open **Settings → Subscription & billing** to see your plan. When a limit is 80% used, the related page shows a short usage line, such as how many dashboards of the plan's allowance you have created. At the limit, a notice explains which limit was reached and links to **Upgrade**. Create buttons for that item, such as **Create dashboard**, **Add campus**, or **Invite user**, are unavailable until you remove an item or change plans. Counts update as soon as you create or delete an item. ## Configure the assistant and connected tools **AI assistant** contains workspace assistant preferences and weekly brief settings. Read [Work with the assistant](./assistant.md) for the distinction between asking a question, preparing a draft, and confirming an action. **Integrations** is also available directly in navigation. Follow the provider-specific guide for [Rock RMS](./integrations-rock.md) or [Planning Center](./integrations-planning-center.md). ## When a change will not save Read the message next to the affected field or the page's error message. Correct the invalid value and retry. Do not reload while you still need unsaved changes. If the controls are unavailable, check your role and whether the workspace is read-only. See [Troubleshooting](./troubleshooting.md).