Python:Pandas join()
Anonymous contributor
Published Aug 27, 2025
Contribute to Docs
In Pandas, DataFrame.join() combines columns from another DataFrame (or multiple DataFrames) into the calling DataFrame based on the index or a key column. It’s mainly used for merging DataFrames with different sets of columns but shared row indices.
Syntax
DataFrame.join(other, on=None, how='left', lsuffix='', rsuffix='', sort=False, validate=None)
Parameters:
other: Objects to join with the caller DataFrame.on: Column(s) in the caller DataFrame to join on; must match the index inotherif provided.how: Type of join to perform — ‘left’, ‘right’, ‘outer’, or ‘inner’.lsuffix: Suffix to add to overlapping column names from the left DataFrame.rsuffix: Suffix to add to overlapping column names from the right DataFrame.sort: Sort the result DataFrame by the join keys if True.validate: Checks if the join is of a specific type (‘one_to_one’, ‘one_to_many’, ‘many_to_one’, ‘many_to_many’).
Return value:
Returns a new DataFrame with columns of both joined DataFrames combined according to the join logic.
Example
In this example, a list of words is joined into a single string separated by spaces:
words = ['Codecademy', 'is', 'awesome']result = ' '.join(words)print(result)
This code produces the following output:
Codecademy is awesome
Codebyte Example
In this example, a list of characters is joined into a single string separated by commas:
All contributors
- Anonymous contributor
Contribute to Docs
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.
Learn Python:Pandas on Codecademy
- Looking for an introduction to the theory behind programming? Master Python while learning data structures, algorithms, and more!
- Includes 6 Courses
- With Professional Certification
- Beginner Friendly.75 hours
- Learn the basics of Python 3.12, one of the most powerful, versatile, and in-demand programming languages today.
- With Certificate
- Beginner Friendly.24 hours