Key Concepts
The building blocks of Agnos in plain words: companies, matters, cases, questionnaires, documents, milestones and roles.
Agnos organizes your firm's immigration work in three levels: the company that sponsors the work, the matter for each person, and the cases filed for that person. Almost everything else, from documents to milestones and invoices, hangs off one of these three.
Company (the employer or client)
└── Matter (one person: an employee or a dependent)
└── Case (one petition or application)
Company
A company is a client of your firm, usually the employer sponsoring a visa or green card. In search results companies appear under Clients.
A company holds the details that apply to all of its people, such as its address, contacts and company-level documents. Every matter belongs to one company.
Matter
A matter is the record of one individual, usually the foreign national employee (the beneficiary). It holds that person's personal details, history and documents, and all of their cases.
A family member is a dependent: a matter of its own, linked under the principal's matter. Files can be moved between a principal and their dependents (Move to Dependent and Move to Principal).
Each matter has a matter type, set by the template your firm uses for it, which decides which fields you see.
Case
A case is one petition or application for the person, for example an H-1B extension or a PERM labor certification. A matter can have many cases over the years.
Each case has a case type, which decides the fields, forms, milestones and documents that apply. Cases can be active or deactivated; whether you can see deactivated cases depends on your role.
To learn how to open and work with each level, see Companies, matters and cases and Create a case.
Questionnaires and forms
A questionnaire is an online form you send to a client, such as the beneficiary or an HR contact, to collect information. The client opens it from a secure link, fills it in, and their answers flow into the matter or case so you don't have to retype them. See Questionnaires.
Documents
Files are kept at the level they belong to:
- Company Materials for files about the company.
- Matter Materials for the person's own documents, such as passports and diplomas.
- Case Materials for the documents of one filing.
- Government Correspondence for notices and letters from the government.
Your firm's internal files, such as templates and policies, live separately under Firm Documents. See Case documents.
Milestones
Milestones are the steps a case goes through, such as "Filed" or "Approved". Your firm defines the milestones for each case type, and each one can have a due date. You check off a milestone when it's done; some milestones are checked automatically by your firm's rules.
Each milestone also appears as an action item, so completing one completes the other.
Action items
Action items are dated to-dos attached to a company, matter or case. They come from case milestones, from client emails that need a reply, or from items your team creates. See Action items.
Roles and permissions
Each user has a role, and the role decides what they can see and do. A role is a set of permissions, for example:
- Administrator: access to the Admin area and all firm settings.
- View: can open the main Agnos portal.
- Firm: a member of the firm's staff, with access to Firm Documents.
- Attorney: marks the user as an attorney.
- Editor: can use the actions menu on companies, matters and cases in Browse / Edit.
- Accounting and Billing: access to billing, when your firm uses it.
- Timetracking: access to time tracking, when your firm uses it.
- Recruiter and Hiring Manager: access to the recruitment area.
- Deactivated Cases: can see cases that have been deactivated.
A user can also be limited to certain companies, so they only see those companies' matters and cases. Your firm's administrator manages roles; see Users and roles.
If you can't find a company, matter or case that a colleague can see, your role may not include that company. Ask your firm's administrator.
Related
Last updated Nov 17, 2026
Still need help?
- Ask your firm's Agnos administrator. They manage users, permissions, forms and settings for your firm and can fix most access problems right away.
- Use Help in Agnos. Open your profile menu and choose Help to email your firm's support contact.
- Contact Agnos support at support@agnos.global. Say which page you were on and what you expected to happen. Never send passwords, and send client documents only through Agnos itself.