If I understand correctly, in category theory, two objects $X,Y$ are isomorphic if there exists a morphism $f:X\to Y$, and a morphism $f^{-1}:Y\to X$ such that $f\circ f^{-1}=id_Y$ and $f^{-1}\circ f=id_X$.
Why does this imply that we can treat the two objects as "equivalent" within a category?
For example, the categorical product is "unique up to isomorphism". Why does this imply that we can "pretend as if there is only one categorical product"?
In a category we can only talk about properties in terms of morphisms and objects and their relations (diagrams). Any object that can be talked about or defined in those terms can be replaced by an isomorphic object without changing the truth of statements. So within the framework of category theory, these objects can be interchanged everywhere they are used in statements. This is what identity "means" within a logical framework.