Overview
Introduction to the tool: the Theoretical Framework Builder is a guided laboratory for selecting, justifying, applying and writing a theoretical framework in film and television research. Each step explains a principle, shows a film or television example, collects your entries and checks them with transparent rules. All steps feed one framework draft and one report.
Academic purpose and intended users: postgraduate students, doctoral researchers and academics in the Cinema and Television track of the Department of Audio-Visual Production. The tool prioritises qualitative research (interviews, focus groups, reception studies, textual, semiotic, narrative and discourse analysis) and also supports surveys, quantitative content analysis, mixed methods and critical or theoretical work. It does not assume that every study needs one formal theory: a perspective may serve as an interpretive lens, an explanatory framework, a critical standpoint, a source of sensitising concepts or a source of hypotheses.
Main features:
- A twelve-step Theoretical Framework Builder with required-field checks, a progress indicator and a “Guidance for this step” link in every step.
- A Theory Explorer with eighteen profiles (feminist film theory, auteur and genre theory, Barthes’ semiology and Metz’s film semiotics, structuralism and post-structuralism, Hall’s representation theory and encoding/decoding, reception theory, uses and gratifications, cultivation, narrative theory, psychoanalytic film theory, postcolonial theory, the Frankfurt School, cultural studies, political economy and cultural proximity), with search, filters and compatibility badges.
- A Theory Comparison Matrix showing assumptions, concepts, questions, methodological implications, strengths, limitations and documented relations (complementary, in tension, different levels).
- A Theoretical Concepts Matrix with CSV and JSON export and import.
- A Theory–Research Alignment Matrix linking every research question to concepts, analytical focus, evidence and procedure.
- A Framework Visualizer: an editable map with hierarchical, relational and network layouts, draggable elements and SVG download.
- A ten-part framework composer, a rule-based writing checker, a twelve-item refinement checklist and a ten-criterion quality evaluation.
- A final report you can edit, copy, print, save as PDF or download as Word or text.
The workflow: Steps 1–2 define the study and what it needs from theory. Steps 3–5 explore, compare and select. Steps 6–8 define concepts and connect the theory to the questions and the method. Step 9 maps the framework. Step 10 writes it; Step 11 evaluates it; Step 12 produces the final version and report.
Have ready before you start: your problem, questions and design; the foundational texts you have actually read (with page numbers for any quotation); recent applications of the theory in film or television studies; and your institution’s or journal’s guidelines. The tool uses only what you enter. Library profiles are short orientation summaries: read the original sources before citing them.
Moving around: use Next step and Previous step, or the numbered circles. Fields marked with an asterisk (*) are required; you cannot continue until they are complete. Everything saves automatically on this device.
Example used in this guide: a qualitative semiotic study of how two Saudi streaming series construct belonging through the family home, using Hall’s representation theory supported by Barthes’ semiology.
Accessing the tool
Open the tool from the Teaching Experience page (Digital Learning Resources) or directly at: Theoretical Framework Development in Film and Television Studies. Every Builder step also has a “Guidance for this step” link that opens this guide at the same step in a new tab.
↑ Back to contentsLearning outcomes
After completing the tool’s steps you will be able to:
- Identify what the study needs from theory: interpretation, explanation, critique, sensitising concepts or hypotheses.
- Distinguish a theory, a theoretical tradition, a critical perspective, a conceptual model and an analytical method.
- Compare theoretical perspectives by their assumptions, concepts, methodological implications and limitations.
- Select and justify a coherent theoretical approach, including alternatives and any combination of theories.
- Define key concepts from original sources and connect them to the questions and methodology without predetermining findings.
- Map the framework, write a critical theoretical framework section, self-assess it and prepare a researcher-reviewed final report.
Theoretical Framework Builder: the twelve steps
Step 1 — Define the research context
| Field | Purpose | Required information | How to complete the field | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Research title * | Anchors the framework | Working or final title | Copy the title you use | Belonging and the family home in Saudi streaming drama | A title broader than the study |
| Research problem * | The theory must address it | What is not yet understood (one or two sentences) | State the problem, not the topic | Little is known about how platform originals represent belonging in urban settings. | “This study is about Saudi drama.” |
| Research questions * | Linked to concepts in Step 7 | One question per line | They become RQ1, RQ2… later | How do the series construct belonging through the family home? | Questions that already state the answer |
| Research objectives | Context for alignment | One per line (optional) | Use verbs such as examine, interpret, compare | — | Repeating the questions |
| Academic specialisation | Frames terminology | Area of film and TV studies | Choose from the list | Cultural representation and identity | — |
| Research methodology * | Adapts compatibility notes | Qualitative, quantitative, mixed or theoretical/interpretive | Choose the methodology first | Qualitative | “Quantitative” for an interview study |
| Research design * | Shapes pathways and checks | The design | The list follows the methodology | Semiotic analysis | Naming a method you will not use |
| Research materials or participants | Defines the object | Films, series, scenes, documents or participants | Be specific | Two Saudi streaming series (2021–2023); 12 scenes | “Media content” |
| Cultural and geographical context | Locates the study | Place, platform, period | Short phrase | Saudi Arabia; regional streaming platforms | “The Arab world” for one country |
| Proposed analytical approach | Links to Step 8 | How you expect to analyse | One phrase | Close semiotic reading of scenes | Listing every possible method |
The research profile below the step summarises your entries.
↑ Back to contentsStep 2 — Identify the theoretical needs of the study
| Field | Purpose | Required information | How to complete the field | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Study focus * | Drives compatibility badges | One or more of ten foci (representation, audience interpretation, narrative, aesthetics, identity, gender, ideology, meaning, consumption, industry) | Tick all that apply, ideally no more than four | Representation; cultural identity | Ticking everything |
| Main focus | Prioritises the focus | The most important focus | Choose one | Representation | — |
| Why does the study need theoretical grounding? * | States the need | What the theory must help explain or interpret (8+ words) | Name the explanatory or interpretive task | The study needs concepts that explain how identity is constructed through signs rather than reflected. | “Because the university requires a theory.” |
| Role of theory in the analysis * | Sets the theory’s function | Interpretive lens, explanatory framework, critical perspective, sensitising concepts or hypothesis-generating theory | Choose one | Interpretive lens | “Hypothesis-generating” for an interpretive study |
The output states the theoretical need in one short paragraph.
↑ Back to contentsStep 3 — Explore relevant theoretical perspectives
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Search theories | Finds profiles | A name, theorist or concept | Type a word; results update as you type | gaze; Hall; representation | Searching for your topic instead of a concept |
| Focus, Design and Analytical purpose filters | Narrow the library | — | Choose a value or “All” | Focus: Representation | Filtering so tightly that nothing remains |
| Read the profile | Shows the full profile | — | Opens theorists, background, assumptions, concepts, typical questions, methods, applications, strengths, limitations, an example and foundational references | — | Citing the summary instead of the original |
| Compatibility badges | Explain fit | — | Show matches with your focus (Step 2), design (Step 1) and role of theory; they explain, they do not choose | “Matches your focus: Representation” | Treating a badge as a recommendation |
| Add to shortlist * | Builds your shortlist | At least one perspective (two to four recommended) | Click on each card | Hall’s representation · Barthes’ semiology · Cultural studies | Shortlisting ten perspectives |
| Another perspective not in the library | Adds your own | Name as used in the literature, plus its assumptions and concepts with a source | Optional | Cultural negotiation framework | Adding a perspective without a source |
| Notes on your shortlist | Records your reasoning | Optional | Why these deserve comparison | — | — |
Each profile states the kind of perspective: a formal theory, a theoretical tradition, a critical perspective, a conceptual model or a theory-informed analytical method. Barthes’ semiology (cultural meaning of images and myth) and Metz’s film semiotics (cinematic codes and syntagmatic structure) are separate profiles because they serve different analytical purposes.
↑ Back to contentsStep 4 — Compare and evaluate theories
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Comparison matrix | Places perspectives side by side | — | Read across rows: kind, assumptions, focus, concepts, questions, methodological implications, strengths, limitations | — | Comparing names rather than assumptions |
| Relations between the perspectives | Shows documented relations | — | Complementary, in tension or working at different levels | Hall + Barthes: complementary | Combining perspectives in tension without comment |
| Relevance to your study * | Your judgement in words | At least four words per shortlisted perspective | Explain why it is or is not relevant to your problem | Relevant because the problem concerns how belonging is produced through images. | “Very important theory.” |
| Your judgement | Rates relevance | Highly, partly or not relevant | Optional | Highly relevant | — |
The Theory Comparison section of the website offers the same matrix for any two to four perspectives, independent of your shortlist.
↑ Back to contentsStep 5 — Select and justify the theoretical approach
| Field | Purpose | Required information | How to complete the field | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Main theoretical perspective * | Your primary lens | One perspective from the shortlist | Choose from the list | Hall’s representation theory | Choosing a perspective you did not compare |
| Secondary perspective | Optional complement | Only if the combination is justified | Tick one at most, ideally | Barthes’ semiology | Adding perspectives “to cover all sides” |
| Why is the selected theory relevant? * | Relevance | One or two sentences | Link it to your focus and materials | — | Praising the theory in general |
| How does it address the research problem? * | Problem fit | Use the problem’s key terms | Say what the theory lets you see | — | No link to the problem |
| Which aspects does it explain or help interpret? * | Scope | Specific aspects | Name them | Domestic space, generational roles | “All aspects” |
| Why are alternatives less appropriate? * | Considered choice | At least one named alternative | Explain the different purpose | Cultivation measures long-term effects, which this study does not examine. | No alternative named |
| How does the theory relate to the methodology? * | Method fit | A sentence | Link to selection, categories or interpretation | — | Repeating the design name |
| Why is combining theories justified? | Needed only with a secondary perspective | Shared assumptions or different levels | Explain how they work together | Barthes provides tools for reading signs; Hall links them to discourse and power. | “Both are useful.” |
Checks warn about three or more perspectives, documented tensions without explanation, a missing alternative and an uncommon design fit.
↑ Back to contentsStep 6 — Identify and define key theoretical concepts
| Column | Purpose | Required information | How to complete it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Concept * | Names the idea | Term as used by the theorist | One concept per row (at least two) | Connotation | Vague words such as “culture” |
| Definition * | Precise meaning | From the original theorist or a reliable source | Paraphrase; quote only with page numbers | Secondary, culturally associated meaning of a sign | Dictionary or website definitions |
| Original theorist or source | Attribution | Author and year | Hall (1997) | Barthes (1972) | Attributing a concept to the wrong theorist |
| Theoretical context | Locates the concept | The theory it belongs to | Short phrase | Barthes’ semiology | — |
| Relevance to the problem | Justifies inclusion | One sentence | Link to the problem | — | — |
| Related questions | Prepares Step 7 | RQ numbers | RQ1, RQ2 | RQ1 | — |
| Analytical application | Shows use | What you will look for | Concrete | Costume, colour and setting in selected scenes | Abstract restatement of the definition |
| Supporting reference | In-text citation | (Author, Year) | Enter it as it will appear | (Barthes, 1972) | Citing a textbook for an original concept |
| Operational definition | For quantitative designs only | How the concept is measured | Items, scales or coding rules | Hours of weekly viewing of imported drama | Turning interpretive concepts into variables in qualitative work |
Quick add chips insert concept names from your selected theory; you still write each definition. Use Export CSV / Export JSON and Import CSV or JSON to move the matrix to a spreadsheet and back.
↑ Back to contentsStep 7 — Connect theory with research questions
| Column | Purpose | Required information | How to complete it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Question | From Step 1 | — | Shown automatically | RQ1: How do the series construct belonging through the family home? | — |
| Concepts * | Links concepts to each question | At least one concept per question | Tick concepts from Step 6 | Representation; connotation | A question with no concept |
| Analytical focus | What you will look at | A phrase | Specific and observable | Domestic space, framing | “Everything in the series” |
| Research evidence | What you will examine | Materials | Number and type | 12 scenes | — |
| Procedure | How you will examine it | Analytical procedure | Name the procedure | Close semiotic reading | — |
Checks flag unlinked questions, concepts not used by any question, missing evidence and wording that predetermines findings (“to prove that…”). The theory should guide interpretation, not determine the results.
↑ Back to contentsStep 8 — Connect theory with methodology
| Field | Purpose | Required information | How to complete the field | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Research design * | Theory and overall design | 5+ words | How the theory shapes the design | A qualitative semiotic design of two series. | Naming the design without the theory |
| Data collection | What the theory leads you to collect or ask | Optional | — | — | — |
| Selection of films, scenes, documents or participants | Sampling logic | Optional | Explain criteria derived from the theory | Scenes in which domestic space is central | “Random scenes” in interpretive work |
| Analytical categories | Coding frame | One per line | Usually your concepts | Denotation · Connotation · Stereotyping | Categories unrelated to the theory |
| Interpretation of research materials * | How theory guides reading | 6+ words | Describe the interpretive move | Scenes are read for connotations of belonging. | — |
| Presentation of findings | Reporting | Optional | Themes, annotated stills, tables | — | — |
The methodological pathway card adapts to your design and theory: semiotic analysis, feminist film criticism, audience reception research, narrative analysis, surveys or experiments, mixed methods, or critical/theoretical analysis.
↑ Back to contentsStep 9 — Build the framework map
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Build from my entries | Creates the map | — | Builds problem, theory, concepts, questions, dimensions and method; click twice to replace an existing map | 11 elements, 12 connections | Rebuilding after manual edits without meaning to |
| Layout | Arranges elements | Hierarchical, Relational or Network | Hierarchical for a chain, Relational with theory at the centre, Network for many relations | Hierarchical | — |
| Drag | Positions elements | — | Drag with the mouse or select and use the arrow keys | — | — |
| Elements | Edit the map | Type and label | Add element, rename or delete | Add a dimension “Generational roles” | Labels longer than a short phrase |
| Connections * | Show relations | From, to, kind, optional label | Relation (line), Direction (arrow) or Causal claim (bold arrow) | Theory — informs — Concept | Causal arrows in an interpretive study |
| Reset positions / Download map (SVG) | Tidy and export | — | The SVG opens in browsers and Word | — | — |
The map needs at least three elements. In interpretive research use simple relations; use arrows only when the theory and design justify directional or causal claims. The map image appears in the report.
↑ Back to contentsStep 10 — Write the theoretical framework
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Historical and intellectual development | Writing field | Your summary with citations | Two to four sentences | Hall developed the constructionist approach within British cultural studies (Hall, 1997). | Long biography of the theorist |
| Core assumptions | Writing field | Your wording | “Insert the library summary as a starting point”, then rewrite it | — | Leaving the library text unedited |
| Relevant scholarly applications | Writing field | Film or TV studies that used the perspective, with citations | Prefer recent peer-reviewed studies | — | Applications from unrelated fields only |
| Theoretical debates and limitations | Writing field | Criticisms with citations, and what they mean for your study | Engage, do not just list | Critics argue the approach neglects audiences (Morley, 1980); this study therefore makes no audience claims. | Description without critique |
| Concluding synthesis | Writing field | Your theoretical position | One or two sentences | — | Introducing a new theory here |
| Ten parts | The composer | — | Switch each part on or off, reorder, edit or reset it | — | Deleting justification or connections |
| Full framework draft * | The combined text | — | Updates automatically until you edit it directly; “Rebuild from parts” (click twice) replaces your edits | — | — |
The ten parts are: introduction to the perspective, historical and intellectual development, core assumptions, principal concepts, relevant scholarly applications, debates and limitations, justification, application to the current research, connections with questions and methodology, and a concluding synthesis. Do not fabricate quotations: quote only from sources in front of you, with page numbers.
↑ Back to contentsStep 11 — Evaluate and refine the framework
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Automated checks | Twelve framework checks | — | Read “Missing”, “Revise” and “Good” items | “Combination: perspectives with conflicting assumptions combined without explanation.” | Ignoring red items |
| Refinement checks | Writing-level checks | — | Sentence length, critical engagement, quotations without pages, unsupported claims, citations, predetermined findings, causal language, overclaiming, named but unselected theories, clichés, placeholders | — | — |
| Framework refinement checklist | Self-review | Tick what is true | Twelve items | — | Ticking without checking |
| Ten criteria (1–5) | Quality evaluation | A score for each | “Use the suggested scores”, then adjust | — | Accepting all suggestions unread |
| Reflection and revision plan | Your notes | Optional | Note what you will change | — | — |
Recommendations appear for criteria rated 3 or below. This evaluation supports scholarly self-review; it does not replace academic supervision or expert evaluation.
↑ Back to contentsStep 12 — Final theoretical framework report
| Control | Purpose | Required information | How to use it | Film or TV example | Common mistakes |
|---|---|---|---|---|---|
| Final theoretical framework | Your text | Starts from the Step 10 draft | “Copy the Step 10 draft here” (click twice to replace), then polish | — | Submitting without checking citations |
| References (APA 7) | Reference list | One reference per line | Enter only works you cited and read | Hall, S. (Ed.). (1997). Representation… | Citing works missing from the list |
| Notes for your supervisor | Communication | Optional | — | — | — |
| Report tools | Output | — | Regenerate report, Copy report, Print / Save as PDF, Download Word (.doc) or text (.txt) | — | Losing manual report edits (you are asked to confirm) |
The report contains the research title and context, theoretical need, selected perspective, comparison, justification, concepts matrix, alignment matrix, methodology integration, the framework map, the full draft, evaluation results, your reflection, revision recommendations, your final framework, your references and the foundational references for the selected perspectives.
↑ Back to contentsReading the feedback
- Colours and statuses: “Good” (green) needs no work, “Revise” (amber) is worth a look, “Missing” (red) is an essential element that is absent, and “Note” (blue) is information to consider.
- Compatibility badges in the Explorer: compare a profile with your focus, design and role of theory; they explain fit and do not choose for you.
- Relations between perspectives: “complementary”, “tension” and “different levels” are documented in the library; where none appears, explain compatibility in your own words.
- Alignment checks: flag questions without concepts, unused concepts and wording that presumes the findings.
- Map check: warns about causal links in interpretive designs and about unconnected elements.
- Suggested scores: appear under each criterion in Step 11 and come from the checks; accept or change them. Recommendations appear for criteria rated 3 or below.
Other sections of the website
Theory Explorer: the same library as Step 3 for browsing without a project. Read the distinctions between theory, theoretical framework, conceptual framework, literature review and analytical method, and the five kinds of perspective.
Theory Comparison: tick two to four perspectives to see the comparison matrix and their documented relations. Use it to test a combination before you choose it in Step 5.
Theoretical Concepts: the same concepts matrix as Step 6 (changes appear in both places), with export and import.
Theory–Research Alignment: the alignment matrix and checks, shared with Step 7, plus the methodological pathway.
Framework Visualizer: the same map as Step 9; edits in either place are shared.
Writing and Refinement: the writing checker for any pasted text (or “Use my Builder draft”), the refinement checklist, descriptive versus critical writing, rewriting templates for each part and common mistakes.
Quality Evaluation: descriptors of weak, developing and strong performance for each criterion.
Academic Examples: seven illustrative frameworks (labelled as such) on feminist readings of Saudi cinema, representation in Saudi streaming drama, reception of Turkish serials, semiotic analysis, narrative analysis, streaming audiences and critical aesthetics, plus nine verified published studies with learning tasks.
References: APA 7 references for frameworks, foundational theory, film and media theory debates, the published examples and the tutorials in the attached reference file.
↑ Back to contentsGuidance on scholarly referencing
- Original theorists for concepts: attribute concepts to their originators (for example Mulvey, 1975; Hall, 1997; Barthes, 1972) and give the edition you used for translations, with the original date.
- Recent work for applications: support applications and debates with recent peer-reviewed film and television studies where possible (for example 2020 onwards).
- Do not cite what you have not read: library profiles are orientation summaries. Read the source, or cite it as a secondary source.
- Quotations need page numbers: the checker flags quotation marks without a page reference. Never reconstruct a quotation from memory.
- One style, consistently: the tool assumes APA 7 (Author, Year). Check every DOI by opening it.
- Journal rankings: do not state Q1/Q2 or indexing unless you have checked the current SJR or JCR listing.
Saving, editing, copying, printing and exporting
- Automatic saving: every change is saved in this browser on this device; the time of the last save appears above the steps.
- Editing: return to any step through the numbered circles. Concepts, alignment and the map are shared with their website sections.
- Copying: use Copy next to the draft, “Copy final framework” or “Copy report”.
- Printing and PDF: in Step 12 click “Print / Save as PDF” and choose “Save as PDF”. Only the report is printed, including the map.
- Downloading: “Download Word (.doc)” and “Download text (.txt)”; the map can be downloaded as SVG in Step 9.
- Concept files: export the concepts matrix as CSV (opens in Excel or Google Sheets) or JSON; import adds rows to the existing matrix.
- Project files: “Export my project (JSON)” saves everything; “Import project” restores it on another device or browser.
- Switching language: your entries and current step are kept; your own text is never translated.
- Deleting: “Delete my saved data” (click twice to confirm) removes your project from this browser. Do this on shared computers.
Common mistakes
| Mistake | Why it is a problem | What to do |
|---|---|---|
| Theory as a label | Named but never used | Show where each concept works in the analysis (Steps 6–7) |
| A list of theories | Suggests no real framework | Choose one perspective and justify any addition (Step 5) |
| Confusing framework and literature review | Reviews studies instead of explaining the theory | Discuss assumptions, concepts and application (Step 10) |
| Conflicting assumptions | Effects theories with active-audience theories, unexplained | Reconcile or choose (Steps 4–5) |
| Concepts as variables in qualitative work | Misreads interpretive concepts | Use them as sensitising or analytical categories (Step 6) |
| Theory determines findings | Questions written to confirm the theory | Use open questions and report surprises (Step 7) |
| Causal arrows in interpretive maps | Implies claims the design cannot support | Use simple relations (Step 9) |
| Purely descriptive writing | No critical engagement | Add debates, limitations and their implications (Step 10) |
| Second-hand definitions | Textbook or website wording | Cite the original theorist (Step 6) |
| Fabricated quotations | Academic misconduct | Quote only with exact source and page |
Troubleshooting
- “Next step” does nothing: a required field is empty or too short; the message at the top and the highlighted fields show what is missing.
- No theories appear in the Explorer: the filters exclude them all; set Focus, Design and Analytical purpose to “All” and clear the search.
- My secondary perspective is not listed: only shortlisted perspectives other than the main one appear. Add it to the shortlist in Step 3.
- The draft did not change after I edited an earlier step: you edited the full draft directly. Use “Rebuild from parts” (your edits will be replaced) or edit the draft yourself.
- A part is missing from the draft: the part is switched off, or its source is empty (for example no concept has a definition).
- The map looks crowded: switch layout, drag elements, or delete minor elements; “Reset positions” restores the layout.
- The CSV import failed: the first row must contain the column names exported by the tool; save the file as CSV (UTF-8).
- Arabic text looks wrong in Excel: open the CSV through Data › From Text/CSV and choose UTF-8.
- My data disappeared: data are stored per browser and device; private windows and clearing site data remove them. Import your exported JSON file.
- The printed report includes other parts of the page: print from Step 12 using the button, not the browser menu.
Academic integrity and limitations
- Your content, your responsibility: every statement in the framework comes from what you entered or from library text you chose to insert and then rewrote. You remain responsible for its accuracy and for every citation.
- No invented content: the tool does not generate studies, findings, quotations or references. Illustrative examples are labelled and are not real studies; published examples link to verified DOIs.
- Rule-based, not AI: checks rely on word lists, counts, citation patterns and documented theory relations. They can miss problems or flag acceptable wording, and they do not judge scholarly quality.
- Compatibility is not a recommendation: badges and relations explain fit; the choice and its justification are yours.
- Translation: the tool does not translate. For two languages, write each version yourself.
- Not a substitute: the tool supports learning and refinement. It does not replace supervision, reading the original theory or peer review.
Frequently asked questions
- Why can’t I move to the next step?
- Some required fields (marked with an asterisk) are empty or too short. A message appears at the top of the step and each missing field is highlighted with a note below it; complete them and click Next again.
- Where are my answers saved?
- In this browser’s local storage on this device only; nothing is sent to a server. On another device or browser your answers appear only after you import a JSON file you exported earlier.
- Does the tool choose the theory for me?
- No. Badges and relations only explain fit; you choose, justify the choice and compare alternatives.
- Can I cite the library profiles?
- No. Profiles are short orientation summaries; read the foundational sources listed in each profile and cite them directly.
- Do I have to combine two theories?
- No. One coherent approach is often enough. Add a secondary perspective only if you can explain why the combination is intellectually justified.
- Why does the check warn me about causal arrows?
- Because interpretive research does not usually claim causal relations. Use “Relation (line)” unless your theory and design justify a directional or causal claim.
- How do I move the concepts matrix into Excel?
- Use “Export CSV” in Step 6 or in the Theoretical Concepts section and open the file in Excel as UTF-8. To bring it back, edit and save as CSV, then use “Import CSV or JSON”.
- How do I save the report as a PDF?
- In the final step click the print button (“Print” or “Print / save as PDF”), then choose “Save as PDF” in your browser’s print dialog. Only the report is printed, not the rest of the site.
- Are my answers translated when I switch to the Arabic version?
- No. Your answers move to the other version exactly as you wrote them; only the interface and guidance change language.
- My answers have disappeared. What happened?
- Usually the browser data was cleared, private (incognito) browsing was used, or the tool was opened in a different browser. They can only be restored from an exported JSON file, so export a backup regularly.
- Does the tool use artificial intelligence?
- No. All feedback, formulations and suggested scores come from transparent programmed rules (word lists and templates), so the tool may miss a problem or flag something that is fine; your judgement and your supervisor’s come first.
Ready to start? Open the tool and follow the steps alongside this guide.
Open the tool