How to Use Logframe

Your logframe is a visual representation of your theory of change. Start from the top and work your way down, then use the Logframe view for a matrix-style summary.

1

Go to your Project

Navigate to your organization, then select or create a project.

2

Open Theory of Change

From your project page, open "Theory of Change" to see the visual logframe canvas.

3

Add objectives in order

Build your logframe from top to bottom: Impact (your ultimate goal), Outcome (changes you want to see), Output (deliverables), and Activity (what you do).

4

Open the Logframe view

Use the Logframe page to review the matrix view and scan objectives by level.

5

Expand and explore

Click any objective to view details, add notes, or attach files. Expand or collapse branches to focus on what matters.

Keep evidence and context organized by attaching notes and files directly to your logframe objectives.

1

Open an objective

Click on any objective in your logframe to open its detail view.

2

Add a Note

Click "Add Note" and write your observation, update, or reflection. Choose the visibility: Private (only you), Project (team members), or Donor (visible in donor reports).

3

Upload Attachments

Upload files like reports, photos, or documents. Set visibility carefully—donor-visible files will appear in the donor view.

Tip: Notes and attachments with "Donor" visibility automatically appear in the donor view.

Indicators are measurable metrics that show your progress. Link them to nodes to track what matters.

1

Go to Indicators

From your project page, click "Indicators" to see all indicators or add new ones.

2

Create an indicator

Give your indicator a clear name (e.g., "Number of women trained"). Set the unit (people, %, USD), baseline (starting value), and target (goal).

3

Set reporting frequency

Choose how often you'll collect data: monthly, quarterly, annually, or custom.

4

Choose your Value Source

Select how progress values will be calculated:

Manual Entry – You enter values directly
Survey Values – Values flow in from mapped survey questions
Activity Evidence – Progress sums from activity contributions (ideal for participant counts)

5

Link to objectives

Attach your indicator to one or more logframe objectives to show which outcomes or outputs it measures.

6

Plan your disaggregation

Decide if you need breakdowns like sex, age group, or location so you can capture them when recording values or mapping survey questions.

Track your progress over time by recording values for your indicators.

1

Open an indicator

Click on any indicator to see its detail page with the progress chart.

2

Add a value

Click "Add Value" and enter the measured value along with the date. Add optional notes for context.

3

Add disaggregation (optional)

Capture breakdowns like sex, age group, or location to unlock disaggregation analytics.

4

Sync from surveys

If the indicator is mapped to survey questions, values will also flow in automatically from submissions.

5

Watch the chart update

Your progress chart and percentage badges update automatically as you add values.

Tip: Set baseline and target values first—otherwise your progress chart will appear flat.

Note: If your indicator uses "Activity Evidence" as its value source, you don't need to add values manually—progress is calculated automatically from activity contributions.

Bring field data into Logframe by connecting survey providers and mapping questions to indicators.

1

Open Surveys

From your project page, open "Surveys" to create or manage survey forms.

2

Import questions

Sync questions from KoboToolbox or other webhook-based providers.

3

Map questions

Map questions to indicators or disaggregation keys like sex, age group, or location.

4

Enable Activity Evidence (optional)

To auto-count participants from activities:

Map a question to both an Activity and an Indicator
Set the indicator's Value Source to "Activity Evidence"
Each survey response creates a contribution that adds to the indicator total

5

Sync submissions

Trigger a sync or webhook and confirm new indicator values appear.

Activity Evidence: When a survey question is mapped to both an Activity and an Indicator with "Activity Evidence" value source, each submission automatically contributes to the indicator's progress—no duplicate entry needed.

Provider Setup Guides

Click your survey provider below for step-by-step setup instructions:

KoboToolbox (Recommended for field surveys)

What you need: A KoboToolbox account with a deployed form

Find your Form ID: Open your form in KoboToolbox. Look at the URL - it contains your "Asset UID" (e.g., aKLNdfd...). Copy this ID.
Get your API Token: Click your profile icon → Account Settings → Security tab → Copy your API Key
Give the token to your admin: Your system administrator needs to add this token to logfram
Link in logfram: Go to your project → Surveys → Link Survey Form → Select "KoboToolbox" → Paste your Asset UID
Import questions: After linking, click "Import Questions" to pull your form structure automatically

Google Forms / Google Sheets

What you need: A Google Form or Google Sheet with your data

Open your spreadsheet: If using Google Forms, go to "Responses" tab → Click the green Sheets icon to open the linked spreadsheet
Share with logfram: Click the "Share" button (top right) → In "Add people", paste this email: logfram-google-integration@logframe-480820.iam.gserviceaccount.com Select "Viewer" access → Click "Share"
Copy the spreadsheet URL: Copy the full URL from your browser address bar
Link in logfram: Go to your project → Surveys → Link Survey Form → Select "Google Sheets" → Paste your URL
Set the sheet name: Enter the tab name (usually "Form Responses 1" for Google Forms)

Typeform

What you need: A Typeform with a published form

Link form in logfram first: Go to your project → Surveys → Link Survey Form → Select "Typeform" → Enter your form title
Copy your webhook URL: After linking, you'll see a "Webhook URL" on the survey page - copy it
Find your Form ID: Open your Typeform in edit mode. In the URL, find the ID after /form/ (e.g., abc123)
Set up webhook in Typeform: In Typeform → Connect tab → Webhooks → Add Webhook → Paste your logfram webhook URL
Test it: Submit a test response in Typeform - it should appear in logfram automatically!

Tally

What you need: A Tally form (free or paid)

Link form in logfram first: Go to your project → Surveys → Link Survey Form → Select "Tally" → Enter your form title
Copy your webhook URL: After linking, you'll see a "Webhook URL" on the survey page - copy it
Set up webhook in Tally: Open your Tally form → Settings (gear icon) → Integrations → Webhooks → Add Endpoint → Paste your logfram webhook URL
Save and test: Submit a test response in Tally - it should appear in logfram within seconds!

Fillout

What you need: A Fillout form

Link form in logfram first: Go to your project → Surveys → Link Survey Form → Select "Fillout" → Enter your form title
Copy your webhook URL: After linking, you'll see a "Webhook URL" on the survey page - copy it
Set up webhook in Fillout: Open your Fillout form → Integrations → Webhooks → Add Webhook → Paste your logfram webhook URL
Test it: Submit a test response - it should appear in logfram automatically!

Airtable

What you need: An Airtable base with your data

Find your Base ID: Open your Airtable base. In the URL, find the ID that starts with app (e.g., appABC123xyz)
Find your Table ID: In the same URL, find the ID that starts with tbl (e.g., tblDEF456)
Create an API token: Go to airtable.com/create/tokens → Create Token → Add read-only scope for your base
Give the token to your admin: Your system administrator needs to configure this token
Link in logfram: Go to your project → Surveys → Link Survey Form → Select "Airtable" → Enter your Base/Table IDs

Note: Airtable data syncs periodically (not instantly like webhooks)

Microsoft Forms (via Power Automate)

What you need: Microsoft Forms + Power Automate access (requires Microsoft 365)

Link form in logfram first: Go to your project → Surveys → Link Survey Form → Select "Microsoft Forms" → Enter your form title
Copy your webhook URL: After linking, you'll see a "Webhook URL" on the survey page - copy it
Create a Power Automate flow: Go to flow.microsoft.com → Create → Automated cloud flow
Set trigger: Choose "When a new response is submitted" (Microsoft Forms)
Add HTTP action: Add a new step → HTTP → POST → Paste your logfram webhook URL
Map fields: In the request body, map your form fields to send the data
Save and test: Submit a test response to verify it works!

Need help? Ask your IT administrator for assistance with Power Automate.

Record progress on activities, track completion, and log expenses with each update.

1

Open an Activity

From your logframe, open an Activity objective to view its updates.

2

Add an update

Record status, percent complete, and notes to document progress.

3

Log expenses

Add expense categories, amounts, and descriptions to track spending.

4

Review totals

Expense totals roll up into analytics and reports automatically.

5

View contributing evidence

For indicators using "Activity Evidence" value source, visit the indicator page to see the Contributing Evidence card showing all activity contributions with gender breakdown.

Explore project progress with built-in dashboards for trends, disaggregation, and activity performance.

1

Open Analytics

From your project page, click "Analytics" to view dashboards.

2

Switch dashboards

Review Project Overview, Indicator Trends, Disaggregation, and Activity Progress.

3

Adjust filters

Use date ranges and indicator selectors to focus on specific trends.

4

Export results

Download CSV exports for reports or deeper analysis.

Create donor-ready reports with your latest indicators, activity updates, and narratives.

1

Open Reports

From your project page, click "Generate Report" to view the reporting workspace.

2

Review report sections

Check the outcome summaries, indicator tables, and expense rollups.

3

Download formats

Export a PDF or Word report for sharing with donors.

4

Optional AI narrative

Use AI narrative tools in the report to draft summary text when needed.

Keep track of important dates with milestones and reporting deadlines.

1

Open Timeline

From your project page, open "Timeline" to see all events.

2

Add milestones

Create milestone events for key project moments: launches, completions, reviews.

3

Add reporting deadlines

Set deadlines for when reports are due to funders or stakeholders.

4

Generate from cadence

If your project has a reporting cadence set, you can auto-generate recurring deadlines.

Create a curated view of your project for funders and external stakeholders.

1

Configure donor view

Go to your project and click "Donor View Settings" to customize what donors see.

2

Select outcomes, outputs, and indicators

Choose which outcomes, outputs, and indicators to highlight. Less is often more—curate the most meaningful metrics.

3

Add branding and narrative

Upload a donor logo, add a headline, and provide a narrative update.

4

Set access and share

Preview the donor view, then share the link. Make it public or keep it private.

Remember: Notes and attachments with "Donor" visibility will automatically appear here.

Invite teammates, assign roles, and keep project access organized.

1

Invite team members

Go to your project team page and send invitations by email.

2

Assign roles

Choose the right role for each teammate to control access and edit permissions.

3

Manage membership

Update roles, resend invites, or remove members as needed.

Stay ahead of risks with alerts for overdue updates, missing data, or upcoming deadlines.

1

Open Attention

Use the Attention page to see what needs action across your projects.

2

Triage alerts

Review, snooze, or dismiss items as you resolve them.

3

Set preferences

Customize alert types and reminders in Settings > Attention.

Let AI help you build your logframe and generate report narratives faster.

1

Get objective suggestions

When creating or editing an objective, click "AI Suggestions" to get recommended child objectives based on your context.

2

Generate narratives

In the Reports section, use the AI narrative tools to draft outcome summaries.

3

Review and edit

AI suggestions are starting points—review and customize them to match your voice and context.

Note: AI features may be rate-limited and are optional. You can always write everything manually.

Help us improve Logframe by sharing your experience and suggestions.

1

Visit the feedback page

Click "Feedback" in the navigation or go directly to the feedback form.

Log in to try

2

Rate your experience

Give us a quick rating from 1-5 stars. It only takes a few seconds.

3

Add comments

Share what's working, what's confusing, or what you'd like to see improved.

4

Consent to follow-up (optional)

If you're open to being contacted, let us know so we can learn more about your needs.

Provider Setup Guides

Ready to get started?