component

Search

A main function of USAJOBS is to provide a clear and effective search. Our search interface is comprised of serveral components including controls, filters, pagination, and results.

Design complete

Controls

Results found

Viewing 1-10 of 1,562 jobs

Usability

When to use
  • When the number of results are relevant to explain to the user the relative success of their query.
When not to use
  • When there are no results (see "No results found").

No results found

Please refine your search

We want to help you find the right job. Try entering a keyword or location, or use the filters on the right.

Guidelines

  • Do not show search controls or pagination when no results are displayed.

Usability

When to use
  • When zero results are returned by the user's query.

Pagination

First page
Inner page
Last page

Accessibility

  • The previous and next buttons are hidden with aria-hidden when they are non-functional.

Implementation

  • Below the M breakpoint (600px) the pagination is represented by the next and/or previous buttons.
  • Above the M breakpoint there are several rules:
    • The first and last page links are always displayed.
    • Current page number is always displayed with +/- 1 page to either side.
    • When displaying the first and last pages +/- 2 pages are displayed.
    • When displaying the first page the Previous button is not displayed.
    • When displaying the last page the Next button is not displayed.
    • There are only ever 5 page links displayed, including first and last page. All other pages are abbreviated into ellipses.
  • Pagination should always be shown at the bottom of the page, near the bottom of the list that it paginates.

Usability

When to use
  • When it is not feasible to show all ordered data on a single page.
Do not use when
  • When it is undesirable to have the user pause for navigation. Some alternatives include the infinite scroll pattern or simple un-numbered navigation.

Results

Core variation

Requirements

The search card component MUST include the following:

  • Position title
    • display position title as a link that opens the job posting (job announcement) in the same window.
    • on click, change the link to visit link state (purple link).
      • MUST remain in this state for the entire session.
      • MUST remain in this state even when the user signs out and signs back in.
  • Agency name
  • Department name
  • Location
  • Starting salary & matching starting-ending pay schedule (example: GS13-14)
  • Appointment type (formerly known as work type)
  • Work schedule
  • Hiring paths icons
  • The label/description is shown on the hover state
  • Opening and closing period
  • Save/saved star trigger
    • Only show to signed-in users
    • Display as a link that will allow users to save and un-save a job posting.
    • Follow the save/saved star trigger guidelines.
    • Do NOT display the save/saved star trigger to signed-out users.

The search card component MAY include the following:

  • Application status: If the user has a started or finished an application to this job then the application status should appear. The same state names and colors as appear for application status in the profile dashboard should be employed.
When to use
  • To represent a job announcement in a list of announcements.
When to use
  • To represent a job announcement an a Mission Critical Occupation page.
  • THIS VARIATION IS TO BE REPLACED BY THE STANDARD CORE VARIATION ABOVE.
When to use
  • To represent a job announcement in the recruitment tool.
Opportunity variation
Research digital information - what and how are Federal agencies sharing about their digital work?

HHS’ Digital Communications Division in the Assistant Secretary for Public Affairs Office (ASPA Digital) is seeking help for an online research project. We are updating our website, HHS.gov/web.

For Department of Health and Human Services employees only

Requested by

Debra Harris

Open
When to use
  • To represent an opportunity in Open Opportunitites.

Teasers

Data Science variation
Cyber Security variation
Privacy variation
Event variation
Guidelines
  • The teaser, when it appears, should appear between the 5th and 6th job result. Ideally it would be loaded via an asynchronous request after results are displayed so that it does not negatively impact search performance.
  • Only one teaser should be shown in one set of search results. Currently there is overlap in triggering keywords thus a round robin mechanism should be deployed to rotate between the overlapping teasers. There is also the possibility of overlap in the use of filters. In this case the keyword trigger should win out.
  • Links that leave the usajobs.gov domain should open in a new tab.
When to use
  • Each teaser appears in search results IF and only if they are relevant to the search. Relevance is defined by keyword for these variants excluding the Event variation which is dependent upon location and/or hiring path.
  • Events:
    1. Location: A matching event should appear when the location entered into the Location search field and selected from autocomplete matches the location of the event.
    2. Future enhancement - Hiring path: A matching event should appear when the hiring path filter selected matches one or more of the hiring paths attached to an event.
When teasers appear
  • Teasers should appear as long as the criteria below are met. Their appearance is not based on a session given that these are not currently popular queries.
  • Keywords: When the user enters this string into the keyword field the appropriate teaser should appear in their search results.
  • Occupations: When the user enters this string into the keyword field AND selects the matching occupation from autocomplete the appropriate teaser should appear in their search results.
  • Department/Agency: When the user enters this string into the keyword field AND selects the matching department or agency from autocomplete the appropriate teaser should appear in their search results.
Data Science: Keywords
  1. data
  2. dmat
Data Science: Occupations
  1. Bioinformatics Scientists
  2. Bioinformatics Technicians
  3. Business Intelligence Specialist
  4. Computer and Information Research Scientists
  5. Computer and Information System Managers
  6. Data Analyst
  7. Data Engineer
  8. Data Warehousing Specialists
  9. Economic Research Analysts
  10. Enterprise Data Manager
  11. Health Data Analyst
  12. Information Technology Specialist (IT Specialist)
  13. Management Analysts
  14. Mathematical Technicians
  15. Operations Research Analysts
  16. Policy Advisor
  17. Procurement Analyst
  18. Public Health Analyst
  19. Research Analyst
  20. Research Assistants, Social Science
  21. Senior Data Analyst/Programmer
  22. Statistical Assistants
Data Science: Departments & Agencies
  1. Department of Homeland Security (DHS)
  2. National Security Agency (NSA)

Cyber Security: Keywords
  1. Chief Operating Officer
  2. cyber
  3. Deputy Chief Information Security Officer
  4. federal protective service
  5. Foreign Service Office Management Specialist
  6. Forensic Computer Analyst
  7. fps
  8. homeland
  9. informatics
  10. information
  11. infosec
  12. it
  13. Performance Analyst
  14. Policy Brand Chief
  15. security
  16. Supervisory Management And Program Analyst
  17. technology
  18. Telecommunications Specialist
Cyber Security: Occupations
  1. Computer Network Support Specialists
  2. Computer and Information Systems Manager
  3. Computer Systems Analysts
  4. Criminal Investigators and Special Agents
  5. Information Security Analysts
  6. Network and Computer Systems Administrators
  7. Police Detectives
  8. Police Identification and Records Officers
  9. Security Management Specialists
Cyber Security: Departments & Agencies
  1. Department of Homeland Security (DHS)
  2. National Security Agency (NSA)

Privacy: Keywords
  1. administrative law judge
  2. ASSISTANT COUNSEL
  3. Associate Chief Information Officer
  4. attorney
  5. CH OF CYBER & ENTERPRISE OPS
  6. claims
  7. counsel
  8. cyber
  9. data privacy
  10. Deputy Chief Information Officer
  11. foia
  12. health insurance specialist
  13. informatics
  14. information
  15. infosec
  16. inspector
  17. it specialist
  18. j.d.
  19. judge
  20. law
  21. oig
  22. physical security
  23. privacy
  24. security
  25. social insurance specialist
  26. Supervisory IT Specialist (PLCYPLN)
  27. SUPV IT SPECIALIST (NETWORK/CUSTSPT)
Privacy: Departments & Agencies
  1. National Security Agency (NSA)